komrad

create_task

Create a task in a workflow.

writesnot idempotentMCP toolTask

To put an agent on the task, pass its id as task_id or its slug as task_slug to create_agent.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.task.v1.TaskService/CreateTask \
  -H 'Content-Type: application/json' \
  -d '{
  "slug": "<slug>",
  "title": "<title>",
  "workflow_id": "<workflow_id>"
}'

Request#

CreateTaskRequest#

FieldTypeDescription
slugstring*

at most 80 characters

matching ^[a-z0-9]+(-[a-z0-9]+)*$

The task's slug. A task can't take a slug another task has used.

titlestring*

at most 200 characters

must not contain control characters

The task's title.

goalstring

at most 50000 characters

What the task is meant to achieve, in markdown.

workflow_iduuid*

The workflow to create the task in, by id.

Response#

CreateTaskResponse#

FieldTypeDescription
taskTask

The task as created.

Types#

Task#

Task is one piece of work that agents do.

FieldTypeDescription
iduuid*

The task's id.

workflow_iduuid*

The id of the workflow the task belongs to.

slugstring

The task's slug, such as fix-login. No two tasks ever share one.

titlestring

The task's title.

goalstring

What the task is meant to achieve, in markdown.

created_attimestamp

When the task was created.

updated_attimestamp

When the task last changed.

archived_attimestamp

When the task was archived. Unset while the task is live.

cwdstring

The directory of the task's checkout. Unset while the task has no checkout.

branchstring

The git branch of the task's checkout. Unset when the task has no checkout or git cannot read the branch.

repository_urlstring

The canonical web address of the repository the task's checkout pushes to, such as https://github.com/harrisoncramer/komrad. Unset when the checkout is gone or origin is not on a forge.

head_shastring

The commit checked out in the task's checkout. Unset when the checkout is gone or git cannot read it.

worktree_removal_reasonWorktreeRemovalReason

Why the task's worktree is no longer on disk. Unspecified while it is.

sequenceSequence

The git operation stopped part way in the task's checkout.

moved_since_snapshotstring

The commit of the task's newest snapshot, set while the checkout has changed since that snapshot. Empty otherwise.

diff_statDiffStat

How many lines the task's checkout adds and removes since it left the base branch. Unset when there is no base branch to measure against.

adopted_branchstring

The existing branch the task was put on. Unset when komrad created the branch.

failure_reasonstring

Why the task's last delete failed to remove its checkout. Empty unless a delete failed.

notesstring

The task's notes, in markdown, written by its agents and the person.

notes_updated_attimestamp

When the task's notes were last written, or when the task was created if they never were.

parentParent

The task this task depends on. Unset for a task on the workflow's base branch.

snapshotsint32

How many snapshots komrad has taken of the task's checkout.

guidesint32

How many guides agents have written for the task. list_guides returns them.

DiffStat#

DiffStat counts the lines a checkout adds and removes, committed or not.

FieldTypeDescription
addedint32

How many lines the checkout adds.

removedint32

How many lines the checkout removes.

Parent#

Parent is the task a child depends on, and the fork point where the child's own commits begin on the parent's branch. Snapshots and line counts measure from fork_point.

FieldTypeDescription
task_iduuid*

The id of the parent task.

fork_pointstring

The commit of the parent's branch the child's own commits sit on.

pull_request_iduuid

The id of the parent's pull request, which komrad reads for the parent's newest commit and its merge. Empty until the parent has one.

blockedCascadeBlock

Why the cascade cannot rebase the child onto its parent.

WorktreeRemovalReason#

WorktreeRemovalReason is why a task's worktree is no longer on disk.

ValueDescription
deleted

A delete removed the worktree. Komrad never makes it again.

gone

Komrad found the worktree's directory gone without a delete.

Sequence#

Sequence is a git operation stopped part way in a task's checkout.

ValueDescription
none

No git operation is stopped part way.

rebase

A rebase stopped on a commit it could not replay.

am

A git am stopped on a patch it could not apply.

merge

A merge stopped on conflicts.

cherry_pick

A cherry-pick stopped on conflicts or paused between commits.

revert

A revert stopped on conflicts or paused between commits.

CascadeBlock#

CascadeBlock is why the cascade cannot rebase a child onto its parent.

ValueDescription
conflicted

Rebasing the child's own commits onto its parent stopped on conflicts.

orphaned

The child is orphaned: its branch holds neither its fork point nor any of its parent's own commits.

parent_closed

The parent's pull request closed without merging.