API

List the agents the panel tracks, live and dormant, with each one's name, state, working directory, flags, and workflow.

Fetch one agent by id, including whatever metadata it has recorded about its own work.

Launch a background agent with an opening prompt.

Get your own work read before you call it finished, which spawns the reviewer for you and hands you back the rest of the loop.

Put an agent on work that already exists, naming the branch it is on.

List every mark, by letter, with the agent or the workflow each one jumps to.

Put a single lowercase letter on an agent's row or a workflow's row, which is the shorthand a person types in the panel to jump straight to that row.

Hide an agent from the panel's sidebar, keyed by its id, or unhide it by passing hidden false.

Record one fact about an agent's work under a key of your choosing, keyed by the agent's id, or clear that key by omitting the value.

Write one line to komrad's log, tagged to an agent.

Send one piece of mail to another agent, addressed by its id or by its name.

Send another agent's newest turns to a third agent as mail komrad composes itself, so what that agent concluded reaches the recipient without passing through your own context.

Take the unread mail other agents have sent you, oldest first.

List the mail addressed to an agent, most recent first, without claiming any of it: unlike read_mail this never empties the mailbox.

Permanently remove a list of mail, keyed by id.

Stop a list of agents and hide them from the panel, keyed by id, keeping their records and transcripts.

Take a list of agents out of the archive, keyed by id, along with the workflows they belong to.

Stop an agent and hold it, which is what somebody does before editing the files that agent is working in.

Let an agent that hold_agent stopped carry on, telling it what happened while it was held.

Relaunch an agent's CLI on the same conversation, keyed by id, which is what reaches an agent whose pane has since died.

Retry launching an agent that failed to create, keyed by id, optionally with corrected flags, prompt, or harness.

Permanently remove a list of agents, keyed by id.

Rename an agent, keyed by its id rather than its current name.

Full-text search over conversations, including archived ones, returning one hit per matching turn with the matched text marked.

Fetch one window of an agent's transcript by agent id, not by name.

Fetch the newest turns an agent has said, by agent id rather than name, without paging through its conversation from the start.

Permanently delete every archived agent and workflow, tearing down each worktree that is still on disk.

Read the review conversations pinned to the lines of a diff.

Pin a comment to a place in another agent's diff, which is how you give it a review rather than mailing it prose.

Say something in a review thread, which is how you answer feedback on your own diff.

Read what rebasing an agent's worktree onto its base would do, without moving anything.

Move an agent's branch onto the latest commit of its base, rewriting the branch in the checkout it sits in.

Bring a workflow's orchestrator back with a pane to talk to, starting the one that workflow has never had.

Settle a review thread you wrote, once the answer to it is good enough, or reopen one you settled too early.

Freeze what an agent has written right now and get back the round to review against, which is a snapshot commit covering its whole worktree, committed and uncommitted alike.

Read the rounds taken of an agent, oldest first.

Read every review released on an agent, in the order their rounds were taken, each with the verdict it carried.

Read one released review whole, which is what the mail announcing a release tells you to do with the review id it names.

Let go of the review you have been writing on another agent's diff, which is what sends it.

List the workflows agents are grouped into, in alphabetical order, with each one's shared context, the working directory and flags its agents start from, and the scripts hooked to moments in their agents' lives.

Fetch one workflow by id.

Create a workflow to group agents under.

Replace a workflow's name, context, directory, flags, worktree config and hooks.

Hide a workflow from the panel, archiving the agents inside it.

Take a workflow out of the archive, keyed by id, along with every agent archived inside it.

Permanently delete an archived workflow along with whatever archived agents are still inside it, reusing the same worktree-removal handling a direct agent delete uses.

List the recurring agent launches, most recently updated first, with each one's cron expression, prompt, workflow, next run time, and its latest run.

Fetch one schedule by id.

List a schedule's most recent firings, newest first, each with the occurrence it stands for, its state, its attempt count, and why it was skipped or how it failed.

Create a recurring agent launch inside a workflow.

Replace a schedule's name, cron expression, timezone, prompt, workflow, and whether the agents it launches start hidden from the panel.

Pause or resume one schedule without editing anything else.

Hide a schedule from the panel so it stops firing, keeping its record.

Read the panel's configuration as it is currently in force, keyed the same way the user's config file is.

Check the machine the service runs on for what its agents need: tmux and its shell, the config, the harness binaries, the hooks and worktree directories, the database and its schema.

List the hooks the user has written, which are executable files in their hooks directory.

Read every log line the service wrote under one trace id, in order.

List the traces the service's log ends with, oldest first, each with when it started, what it was about and how many lines it holds.

List the forges komrad is connected to, one per host, with who komrad acts as there and when the forge last confirmed it.

Ask every connected forge whether its credential still works, the way its method allows, and record the answer on each connection.

List a repository's pull requests through the forge connection for its host, a page at a time: every one opened from a branch when one is named, whatever its state, or the open ones when none is.

Forget a forge and the credential it was connected with.

List the pull requests komrad has stored for a repository, a page at a time: every one opened from a branch when one is named, whatever its state, or every one stored for the repository when none is.

List every worktree directory komrad holds, under the configured worktrees directory and each workflow's own, with the repository it was cut from, its branch, whether git can still read it, the agent it was made for, the other agents working in it, the disk it takes as it was last measured, and when it was last active.

Read one worktree directory: its size and its top-level entries with theirs, biggest first, walked for the call and recorded so list_worktrees carries the fresh number, what is uncommitted, the base it is measured against with how far ahead and behind it stands and how many of its commits the base already holds whole, whether deleting its agent would keep the branch, and the commits since the base.

Remove worktree directories no agent answers for, which delete_agents cannot reach: a directory under the worktrees directories whose agent row is gone, or whose row is in AGENT_STATE_FAILED_TO_CLEANUP because git can no longer read the registration.

Queue one background job that deletes worktree directories, each by the path its row decides.