Agent
AgentService is the agents themselves: spawning one, addressing it, reading what it wrote, and the review conversation held about its work.
agent.v1.AgentService
list_agents#List the agents the panel tracks, live and dormant, with each one's name, state, working directory, flags, and workflow.
get_agent#Fetch one agent by id, including whatever metadata it has recorded about its own work.
create_agent#Launch a background agent with an opening prompt.
request_review#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.
adopt#Put an agent on work that already exists, naming the branch it is on.
list_marks#List every mark, by letter, with the agent or the workflow each one jumps to.
set_mark#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.
set_agent_metadata#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.
log#Write one line to komrad's log, tagged to an agent.
send_mail#Send one piece of mail to another agent, addressed by its id or by its name.
forward_last_turns#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.
read_mail#Take the unread mail other agents have sent you, oldest first.
list_mail#List the mail addressed to an agent, most recent first, without claiming any of it: unlike read_mail this never empties the mailbox.
delete_mail#Permanently remove a list of mail, keyed by id.
archive_agents#Stop a list of agents and hide them from the panel, keyed by id, keeping their records and transcripts.
restore_agents#Take a list of agents out of the archive, keyed by id, along with the workflows they belong to.
hold_agent#Stop an agent and hold it, which is what somebody does before editing the files that agent is working in.
release_agent#Let an agent that hold_agent stopped carry on, telling it what happened while it was held.
resume_agent#Relaunch an agent's CLI on the same conversation, keyed by id, which is what reaches an agent whose pane has since died.
retry_agent#Retry launching an agent that failed to create, keyed by id, optionally with corrected flags, prompt, or harness.
delete_agents#Permanently remove a list of agents, keyed by id.
rename_agent#Rename an agent, keyed by its id rather than its current name.
search_transcripts#Full-text search over conversations, including archived ones, returning one hit per matching turn with the matched text marked.
get_transcript#Fetch one window of an agent's transcript by agent id, not by name.
get_last_turns#Fetch the newest turns an agent has said, by agent id rather than name, without paging through its conversation from the start.
empty_archive#Permanently delete every archived agent and workflow, tearing down each worktree that is still on disk.
list_review_threads#Read the review conversations pinned to the lines of a diff.
create_review_thread#Pin a comment to a place in another agent's diff, which is how you give it a review rather than mailing it prose.
add_review_message#Say something in a review thread, which is how you answer feedback on your own diff.
plan_rebase#Read what rebasing an agent's worktree onto its base would do, without moving anything.
rebase_worktree#Move an agent's branch onto the latest commit of its base, rewriting the branch in the checkout it sits in.
start_orchestrator#Bring a workflow's orchestrator back with a pane to talk to, starting the one that workflow has never had.
resolve_review_thread#Settle a review thread you wrote, once the answer to it is good enough, or reopen one you settled too early.
open_review_round#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.
list_review_rounds#Read the rounds taken of an agent, oldest first.
list_reviews#Read every review released on an agent, in the order their rounds were taken, each with the verdict it carried.
get_review#Read one released review whole, which is what the mail announcing a release tells you to do with the review id it names.
release_review#Let go of the review you have been writing on another agent's diff, which is what sends it.