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.

AgentwritesidempotentMCP tool

Name exactly one of agentId and workflowId, and leave mark out to take off whatever letter the row already answers to. A letter belongs to one row at a time, so claiming one another row already holds takes it off that row rather than being refused. Your own id is in the KOMRAD_AGENT_ID environment variable, so this is how you label your own row while you work on something a person will want to come back to. The mark must be one lowercase character, and a row that is not live is refused as not_found. Which rows carry which letters is the person's own way around their sidebar, so do not move a letter you were not asked to move.

Calling it#

curl -X POST http://127.0.0.1:8787/agent.v1.AgentService/SetMark \
  -H 'Content-Type: application/json' \
  -d '{
  "agentId": "<agentId>"
}'

komrad rpc set-mark \
  --agent-id <string>

{
  "name": "set_mark",
  "arguments": {
    "agentId": "<agentId>"
  }
}

Offered by the komrad MCP server to implementer, reviewer, orchestrator agents.

Request#

SetMarkRequest#

Field Type Description

Field	Type	Description
`agentId`	string	The agent to mark. required, one of target
`workflowId`	string	The workflow to mark. required, one of target
`mark`	string	The letter to put on it, left out to take off whichever letter the row answers to.

agentId

string

The agent to mark.

required, one of target

workflowId

string

The workflow to mark.

required, one of target

mark

string

The letter to put on it, left out to take off whichever letter the row answers to.

Response#

Empty#

No fields.