get_workflow
Fetch one workflow by id.
Workflowread-onlyidempotentMCP tool
Returns not_found if no workflow has that id.
Calling it#
curl -X POST http://127.0.0.1:8787/workflow.v1.WorkflowService/GetWorkflow \
-H 'Content-Type: application/json' \
-d '{
"id": "<id>"
}'komrad rpc get-workflow \
--id <string>{
"name": "get_workflow",
"arguments": {
"id": "<id>"
}
}Offered by the komrad MCP server to implementer, reviewer, orchestrator agents.
Request#
GetWorkflowRequest#
| Field | Type | Description |
|---|---|---|
id | string | Which workflow to read. required |
Response#
GetWorkflowResponse#
Types#
Workflow#
| Field | Type | Description |
|---|---|---|
id | string | The handle every other call names this workflow by. |
name | string | What the panel groups its agents under. |
context | string | Text appended to the system prompt of every agent launched into it, taken as a snapshot at launch rather than read again. |
cwd | string | The directory its agents start in, and the checkout new worktrees are cut from. |
flags | string | Command-line flags prefilled for each new agent. |
harness | string | Which CLI its agents run, blank for komrad's default. |
archivedAt | string | When it was hidden from the panel, unset while it is live. |
worktree | WorktreeConfig | Whether its agents each get a worktree of their own, and how those are built. |
hooks | list of WorkflowHook | Scripts hung on moments in its agents' lives, one per moment. |
contextTruncated | bool | Whether context holds only its opening, which a summary listing returns. |
WorktreeConfig#
| Field | Type | Description |
|---|---|---|
enabled | bool | Whether komrad cuts a worktree for each agent, or leaves it in the directory it was given. |
baseBranch | string | The branch worktrees are cut from and every agent's work is measured against, filled in from the clone when left blank on create and never blank once stored. at most 255 characters |
copyPaths | list of string | Files copied into each new worktree, for the untracked ones a build needs. |
symlinkPaths | list of string | Files linked into each new worktree rather than copied, for the large shared ones. |
diffExclude | list of string | Paths or globs the panel leaves out of the diff it draws, such as generated output. |
dir | string | Where new worktrees are made, blank for the parent every workflow shares. at most 4096 characters |