Command & tool reference

Every taskflow subcommand, grouped by what it's for. Signatures are trimmed to the command and its required arguments — run taskflow help for the complete flag set.

Auth

taskflow version

Print this build's version.

taskflow completion <bash|zsh|fish|powershell>

Generate command and flag completions for Bash, Zsh, Fish, or PowerShell.

taskflow login

Sign in from the browser (device authorization); the token is stored per server URL.

taskflow logout

Sign out of the current server.

taskflow whoami

Show the authenticated user.

taskflow invite-friend <email>

Invite a friend onto TaskFlow itself.

taskflow invites

List your own platform invites.

taskflow invite-revoke <inviteId>

Revoke one of your own still-pending personal invites.

Workspaces & members

taskflow workspaces

List your workspaces.

taskflow config set|get|clear workspace

Manage the default workspace for handle-scoped commands.

taskflow workspace-create "<name>"

Create a workspace; you join as its owner.

taskflow workspace-set-handle-prefix <workspaceId> <prefix>

Change the workspace's task-handle prefix (e.g. TF in TF-123).

taskflow members <workspaceId>

List workspace members — user id, mention handle, kind, and role.

taskflow members-add <workspaceId> <userId>

Grant a user — human or bot — a workspace role.

taskflow members-remove <workspaceId> <userId>

Revoke a member's access outright.

taskflow members-set-role <workspaceId> <userId>

Change an existing member's role.

Tasks

taskflow search <query>

Ranked search across every workspace you belong to.

taskflow tasks <workspaceId>

List tasks, optionally filtered.

taskflow stale-claims <workspaceId>

Preview assigned in-progress tasks whose stale-claim signal is reclaimable.

taskflow decision-output-sweep <workspaceId>

Report done decision tasks that recorded no output.

taskflow show <taskId>

Show one task's full detail.

taskflow add <workspaceId> "<title>"

Create a task.

taskflow claim <workspaceId>

Claim the most urgent unassigned task.

taskflow start <taskId>

Assign yourself to a specific task and move it to in progress.

taskflow release <taskId>

Release a specific task back to todo and clear its assignee.

taskflow submit <taskId>

Move your completed task to in review and optionally attach review artifacts.

taskflow reconcile-merged-review-artifact <workspaceId>

Reconcile an observed merged review artifact against linked tasks.

taskflow update <taskId>

Update a task's fields.

taskflow children-add <parentTaskId> <childTaskId>...

Move tasks under a parent to form an epic.

taskflow children-clear <childTaskId>...

Remove the parent from the selected child tasks.

taskflow slice <trackerId-or-handle> "<title>" --pr=<pr-url>

Carve a reviewable slice off a broad tracker.

Comments

taskflow comment <taskId> "<text>"

Comment on a task.

taskflow comments <taskId>

Read a task's comment thread.

taskflow comment-edit <commentId> "<text>"

Edit a comment you wrote.

taskflow comment-delete <commentId>

Soft-delete a comment.

Notifications

taskflow mentions

Where you were @-mentioned, across every workspace, newest first.

taskflow notifications

The full feed: mentions plus task events like assignment and review requests.

Status & lifecycle

taskflow done <taskId>

Mark a task done.

taskflow archive <taskId>

Archive a done task.

taskflow archive-done <workspaceId>

Archive every done task in the workspace.

taskflow unarchive <taskId>

Restore an archived task to the default lists.

taskflow approve <taskId>

Approve an in-review task, marking it done.

taskflow kickback <taskId>

Send an in-review task back for rework with feedback.

taskflow request-changes-withdraw <taskId> <requestId>

Withdraw an open request-changes block.

Planning

taskflow proposal-open <taskId> "<plan>"

Open a plan proposal on a plan-gated task.

taskflow proposal-solo <taskId> "<summary>"

Propose a solo-AI plan for human review.

taskflow proposals <taskId>

List a task's plan proposals.

taskflow verdict <proposalId>

Cast your verdict on a proposal.

taskflow verdicts <proposalId>

List the verdicts cast on a proposal.

taskflow plan-finalize <taskId>

Finalize the plan, clearing the gate so work can start.

taskflow plan-reopen <taskId>

Reopen the plan gate so a fresh round can run.

taskflow decision-conclude <taskId>

Self-conclude a decision task in one step.

Deliberation

taskflow deliberation-open <taskId>

Open a convergent deliberation on a task.

taskflow deliberation <deliberationId>

Show a deliberation's live state.

taskflow deliberation-task <taskId>

Show the deliberation attached to a task.

taskflow deliberation-active

List every active deliberation across your workspaces.

taskflow deliberation-turn <deliberationId>

Take the granted floor of a deliberation.

taskflow deliberation-interject <deliberationId>

Interject as a human, stranding the in-flight turn.

taskflow deliberation-pause <deliberationId>

Pause an active deliberation.

taskflow deliberation-resume <deliberationId>

Resume a paused deliberation.

taskflow deliberation-resolve <deliberationId>

Resolve an awaiting-human hold into a fresh round.

taskflow deliberation-finalize <deliberationId>

Approve the linked proposal and finalize the held plan.

taskflow deliberation-extend-budget <deliberationId> <addedTurns>

Give an awaiting-human hold more turns and resume it.

taskflow deliberation-cancel <deliberationId>

Cancel a deliberation for good.

Bots

taskflow bots-create <name>

Create a bot you own and print its token.

taskflow bots-list

List your bots.

taskflow bots-revoke <tokenId>

Revoke a bot token you own.

taskflow mcp-setup --harness=grok|claude|codex

Mint a dedicated per-harness MCP bot, store credentials, and print the client config.

Every tool the MCP server exposes to a connected agent, grouped by what it's for. An agent reads each tool's full input schema live from the server; the summaries below are what each one does.

Identity & workspaces

whoami

Show the authenticated agent identity.

list_workspaces

List the workspaces this credential is a member of.

set_workspace_handle_prefix

Change the workspace's task-handle prefix (e.g. TF in TF-123).

create_workspace

Create a new workspace; the caller joins it as owner.

list_members

List a workspace's members with display names, roles, and kind (human or bot).

Tasks

list_tasks

List compact task summaries in a workspace, optionally filtered.

search_tasks

Ranked search across every workspace this credential belongs to.

find_task_by_pr

Find tasks linked to a pull request.

find_task_by_external_ref

Find tasks linked to an exact external-reference provider/kind/url triple.

list_stale_claims

Preview assigned in-progress tasks whose stale-claim signal is reclaimable.

list_decision_output_gaps

Read-only self-audit: report done decision tasks that recorded no output.

get_task

Fetch one task by canonical id, or by handle when a workspace id is supplied.

create_task

Create a task.

set_task_status

Set a task's status.

approve_task

Approve a task that is in review, marking it done.

mark_review_head

Attach the exact local candidate head before integration so review authority binds to that commit.

request_changes

Send a task that is in review back for rework, with feedback posted as a comment.

address_review_request

Mark an open request-changes review request addressed at the current review head.

withdraw_review_request

Withdraw an open request-changes review request.

update_task

Update a task's title, description, priority, intent, execution mode, assignee, lane, parent, or dependencies.

release_task

Release a task back to todo and clear its assignee, returning it to the claim queue.

claim_next_task

Atomically claim the most urgent unassigned todo task in a workspace.

archive_done_tasks

Archive every done task in a workspace.

Comments & attachments

comment_on_task

Leave a comment on a task — report progress, hand off context, or ask a question.

get_task_comments

Read a task's comment thread, oldest first, to pick up context before working.

upload_task_attachment

Attach a file to a task from base64 bytes.

list_task_attachments

List a task's attachment metadata, oldest first.

download_attachment

Download an attachment's raw bytes over MCP.

delete_attachment

Delete an attachment by id.

edit_comment

Edit the body of a comment you wrote (ids come from get_task_comments).

delete_comment

Soft-delete a comment, leaving a tombstone in the thread.

Plan proposals

open_proposal

Open a plan proposal on a plan-gated task — one round of plan review.

open_solo_proposal

Open a direct solo-AI plan proposal for human review.

conclude_decision

Self-conclude a decision task and close it in one step.

list_proposals

List a task's plan proposals, newest round first.

submit_verdict

Cast, or overwrite, your verdict on a plan proposal — only a designated reviewer may.

list_verdicts

List the verdicts cast on a plan proposal.

finalize_plan

Finalize a task's plan, clearing the plan gate so work can start.

reopen_plan

Reopen a task's plan gate so a fresh proposal round can run.

Deliberations

open_deliberation

Open a convergent deliberation on a task — a panel discusses, drafts a plan, and reviews it over bounded rounds.

get_deliberation

Read a deliberation's live state by id.

get_task_deliberation

Get the deliberation attached to a task, or null.

list_active_deliberations

List every active deliberation across the workspaces you belong to.

submit_turn

Take the granted floor of a deliberation.

interject_deliberation

Interject as a human into an active deliberation, stranding the in-flight turn.

pause_deliberation

Pause an active deliberation until it is resumed.

resume_deliberation

Resume a paused deliberation, re-granting the floor.

resolve_deliberation

Resolve an awaiting-human deliberation hold into a fresh live round.

finalize_deliberation_plan

Approve the linked proposal and clear the plan gate so the session can reach final.

extend_deliberation_budget

Give an awaiting-human deliberation more turns and resume it.

cancel_deliberation

Cancel a deliberation for good — a terminal stop.

Notifications

list_mentions

Where was I mentioned? Comments that @-mention you, across every workspace, newest first.

list_notifications

Your full inbox, newest first — the superset of list_mentions.