komrad

navigate

Go to an agent, task, workflow, document, schedule or worktree, or to a screen and the record on it, in every client following navigations.

writesnot idempotentCLI onlyNavigation

Fails when no client is following, or when every one is behind.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.navigation.v1.NavigationService/Navigate \
  -H 'Content-Type: application/json' \
  -d '{
  "agent": "<agent>"
}'

Request#

NavigateRequest#

NavigateRequest names one record, or one screen and the record on it, to go to.

FieldTypeDescription
one of*

The record, or location, to go to.

agentAgentDestination

An agent.

taskTaskDestination

A task.

workflowWorkflowDestination

A workflow.

documentDocumentDestination

A document.

scheduleScheduleDestination

A schedule.

worktreeWorktreeDestination

A worktree.

locationLocation

A screen, and the record on it to stand on.

Response#

Empty#

No fields.

Types#

AgentDestination#

AgentDestination is an agent to go to.

FieldTypeDescription
iduuid*

The agent's id.

TaskDestination#

TaskDestination is a task to go to.

FieldTypeDescription
iduuid*

The task's id.

WorkflowDestination#

WorkflowDestination is a workflow to go to.

FieldTypeDescription
iduuid*

The workflow's id.

DocumentDestination#

DocumentDestination is a document to go to.

FieldTypeDescription
iduuid*

The document's id.

ScheduleDestination#

ScheduleDestination is a schedule to go to.

FieldTypeDescription
iduuid*

The schedule's id.

WorktreeDestination#

WorktreeDestination is a worktree to go to.

FieldTypeDescription
dirstring*

The worktree's directory.

Location#

Location is a screen, the record it stands on, and what the screen needs to stand there.

FieldTypeDescription
screenScreen*

The screen to show.

one of

The record the screen stands on. Unset to show the screen's list from the top.

agentAgentDestination

An agent.

taskTaskDestination

A task.

workflowWorkflowDestination

A workflow.

documentDocumentDestination

A document.

scheduleScheduleDestination

A schedule.

worktreeWorktreeDestination

A worktree.

system_kindSystemKind

What the system screen lists. Unset keeps the kind it listed last.

Screen#

Screen is one of the panel's screens, which a location stands on.

ValueDescription
agents

The agents, grouped under their workflows and tasks.

schedules

The schedules that start agents on a timer.

review

The review of a task's change.

documents

The documents agents have written.

logs

The logs of komrad or an agent.

status_checks

The status checks run on a task's pull request.

status_check_logs

The logs of the status checks run on a task's pull request.

system

What komrad and its agents hold in memory and on disk.

SystemKind#

SystemKind is what the system screen lists.

ValueDescription
memory

What komrad and each agent hold in memory.

storage

What komrad and each worktree hold on disk.

tokens

What each agent spent in tokens today.