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_hidden#

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

  • 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.