Coding agents
Cogno can detect AI coding agent CLIs (Claude Code, Codex, Gemini CLI, Kimi CLI, Antigravity) and show their live status in a side panel, so you can see at a glance which terminals need your attention.
How it works
Section titled “How it works”On startup, Cogno scans your system for supported coding agent CLIs. For each agent that is installed but does not yet have a status hook configured, Cogno offers to install one.
The hook is a small shell command, added to the agent’s own hook configuration, that reports status changes (working, question, ready, error) to Cogno’s local HTTP server whenever the agent’s state changes. Cogno listens for these reports and updates the panel and the corresponding terminal tab in real time.
Active agents
Section titled “Active agents”For each terminal running a detected agent, the panel shows:
| Field | Description |
|---|---|
| Status | Working, Ready, Waiting for input, or Error |
| Activity | A short summary of the agent’s last tool call (command, file, pattern, etc.) |
| Working directory | The agent’s current working directory |
| Provider | The name of the detected agent (e.g. Claude Code, Codex) |
| Last hook | The name of the most recent hook event received |
Clicking an agent’s card navigates to its terminal.
Detected agents
Section titled “Detected agents”Switch to the “Detected agents” view to see which supported CLIs are installed and whether their status hook is configured. Use the Detect agents button to re-scan and install any missing hooks.
Notifications
Section titled “Notifications”A status change can trigger a notification. Use the notification settings button in the panel header, or the config keys below, to choose which status changes notify you and through which channels.
Configuration
Section titled “Configuration”| Setting | Default | Description |
|---|---|---|
coding_agents.mode | visible | visible shows the panel in the side menu, hidden keeps it available but hides it from the menu, off disables the feature entirely |
coding_agents.notifications.working.enabled | true | Notify when an agent starts working |
coding_agents.notifications.question.enabled | true | Notify when an agent has a question and needs input |
coding_agents.notifications.ready.enabled | true | Notify when an agent becomes ready/idle |
coding_agents.notifications.error.enabled | true | Notify when an agent reports an error |
See the Config page for the full reference.
Action
Section titled “Action”| Action | Description |
|---|---|
open_coding_agents | Toggle the Coding Agents panel |