taikutaiku
User GuidePluginsAPI Reference

AI agents

taiku detects coding agents in your terminals, tracks their status, and tells you the moment one needs you.

When you run an AI coding agent inside a taiku terminal, the session recognizes it automatically and keeps an eye on it for everyone in the room.

A terminal running a coding agent, with a live status badge that updates as the agent works and pauses

Automatic agent detection

You do not flip a switch or label anything. Start a coding agent in a terminal and taiku spots it from the agent's own output, then watches that terminal in real time. It recognizes Claude, Codex, and OpenCode.

Each agent terminal shows a colored status dot in its title so you and your collaborators can read the room at a glance:

StatusWhat it means
StartingJust detected, or still coming online.
RunningActively producing output.
ThinkingWorking on a response, terminal momentarily quiet.
Tool useReading files, running commands, or making edits.
WaitingStopped and asking for your input — needs your attention.
CompletedReported its task is finished.
IdleDetected earlier, but quiet for a while.

Detection keeps up as things change. Start an agent after the session is already running and it gets picked up as soon as it speaks. Swap to a different agent in the same terminal and the status follows along.

Get pinged when an agent needs you

The most important moment is when an agent stops to ask for approval. taiku can alert you the instant a terminal switches to Waiting so you are not babysitting output. Choose how you want to be notified under Settings:

  • Sound plays a short ping.
  • Flash pulses the terminal's border.
  • Both does each at once.

A volume slider tunes the ping, and you can turn alerts off entirely. taiku also sends a native system notification, in the browser and the desktop app alike, so you get nudged even when taiku is in the background. Alerts are spaced out per terminal, so a chatty agent will not flood you with repeats.

The activity panel

The activity panel — the bell icon — gathers every agent and alert into one place so you can run several agents at once without losing the thread.

The activity panel listing live agent sessions with their status, token usage, and cost updating in real time

From the panel you can see:

  • Every terminal that needs attention, with its current status.
  • Per-agent stats: tokens used, cost, and how many steps it has taken.
  • A running list of agent sessions, including ones that have already ended, each one click away.
  • A Track diffs toggle. With it on, finished commands earn a Δ badge you can click to review exactly what that run changed — see Reviewing changes.

Jump to an unseen terminal

When you are running a handful of agents, the one that needs you is rarely the one on screen. taiku marks terminals you have not looked at yet and lets you jump straight to the next one that wants attention.

Jumping directly from the activity panel to a terminal where an agent has paused and is waiting for input

Click an entry in the activity panel to bring that terminal into focus, wherever it lives in your layout. You can also mark terminals as unseen yourself to come back to them later.

Resume and relaunch an agent

Agents do not always finish in one sitting. If a terminal closes or you step away, you can pick an agent's work back up instead of starting over.

Resuming a previous agent session in a terminal so it continues from where it left off

From an agent's entry you can relaunch it and continue from where it left off, keeping the context of its earlier work.

Working across many agents

taiku is built for running more than one agent at a time, even several inside a single terminal split into panes. It keeps the agents apart so each one gets its own status and stats — three agents side by side stay three separate entries, not one blurred mess. When an agent kicks off a helper agent for a parallel task, taiku links the two so you can see the parent and its helper together.

On this page