Cline CLI sessions, permissions, and usage in the notch

Cline sessions, tool gates, and recorded usage at a glance.

Download for macOSFree 3-day trial · Apple silicon
AgentPeek monitoring a Cline CLI session, permission gate, and local token usage on a Mac

01

CLI and interactive TUI sessions

Run cline, cline -i, or cline --tui. AgentPeek keeps the session labeled by project in the notch, with its runtime state, prompts, assistant messages, tool activity, files, commands, diffs, and terminal close at hand.

02

A global Cline CLI runtime plugin

AgentPeek installs ~/.cline/plugins/agentpeek.ts, a normal plugin that Cline CLI discovers globally. Other Cline hosts can emit the same feed when they enable the shared plugin runtime. Its onEvent stream reports run-started, user message-added, assistant-message, run-finished, and run-failed with Cline's session, parent-agent, conversation, run, status, and usage fields. The beforeTool and afterTool hooks carry tool calls and results without replacing Cline's runtime.

03

Mutating tools hold for a per-call answer

Cline's built-in run_commands, editor, and apply_patch calls pause in beforeTool until you approve or deny them. Deny with feedback sends your note back as the reason, and Open Terminal remains available. The gate is deliberately per call: Cline's plugin contract exposes no persistent Always Allow channel, and unknown extension tools remain observation-only unless AgentPeek can classify them as mutating safely.

04

Conversations and exact usage from modern local storage

Cline keeps its current session index at ~/.cline/data/db/sessions.db, with each session's manifest and ordered messages under <id>/<id>.json and <id>/<id>.messages.json inside ~/.cline/data/sessions. AgentPeek reads those files locally for conversation history and shows the calendar month's persisted input-plus-output tokens and exact recorded cost, with input, output, cache read, and cache write fields in the daily breakdown. Cline's input total already includes cache portions, so they are never added twice. No quota percentage, limit, or reset window is invented. When Cline starts with --data-dir, AgentPeek follows that root's db and sessions folders.

05

Native ACP exists, but monitored sessions stay view-only

cline --acp starts native ACP for a fresh editor client. In the current Cline build, ACP advertises session loading but does not implement it, while --id resume is wired only through the interactive TUI. AgentPeek therefore does not claim Direct Chat or programmatic resume for monitored Cline sessions. Hosts using Cline's shared plugin runtime can emit the same feed, but those host sessions remain view-only in AgentPeek.

06

Cline folders in Quick Routes

Quick Routes opens Cline's plugins, hooks, rules, workflows, skills, session data, MCP settings, and root folder. Cline can also discover project .cline/plugins and .cline/hooks, plus compatibility mirrors under ~/Documents/Cline/Plugins and ~/Documents/Cline/Hooks; AgentPeek's managed integration stays in the global ~/.cline/plugins location.

Questions

Yes. AgentPeek monitors cline, cline -i, and cline --tui sessions through Cline CLI's global runtime plugin, with live messages, tool activity, local conversations, permission gates, and persisted usage.
Yes, per call. Cline run_commands, editor, and apply_patch calls pause in beforeTool for approve, deny, deny with feedback, or Open Terminal. Cline exposes no persistent Always Allow channel, and unknown extension tools stay observation-only unless they can be classified safely.
It reads ~/.cline/data/db/sessions.db plus Cline's manifest and messages files under ~/.cline/data/sessions, then shows calendar-month persisted input-plus-output tokens, a daily field breakdown, and exact recorded cost. Input already includes cache portions, so AgentPeek never adds cache twice. Cline exposes no local quota percentage or reset window.
Not today. cline --acp starts a fresh native ACP client, but the current implementation advertises loadSession without implementing it, and --id resume is TUI-only. AgentPeek keeps monitored Cline sessions view-only instead of claiming unsupported Direct Chat.
Cline CLI discovers the global plugin. VS Code, JetBrains, or Kanban hosts can emit the same events when they enable Cline's shared plugin runtime; AgentPeek does not claim every host auto-discovers it or that those sessions are programmatically resumable.

Keep your agents in view

Download for macOSFree 3-day trial · Apple silicon