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.