Beck

Get rich context for a task including epic spec, related tasks, comments, and activity. Use this when starting work on a task to understand the full context.

Import pending Plan-it / breakdown suggestions from an epic into the backlog or icebox. Use when asked or when autonomy mode allows. Prefer get_epic first to see pending indices.

Link a GitHub branch or PR to an epic. Use this after creating a branch or opening a PR for an epic's work.

List API tokens for this account in the current org (names, prefixes, kind, mint permission). Never returns secrets. Use when staffing multi-bot channels.

List all comments on a task.

List decisions in the workspace: open ones waiting on the human (costly first), then answered ones, newest first.

List saved versions of a document (id, time, actor, etag). Use restore_document to roll back.

List planning documents in a workspace. Documents are the living PRD/notes corpus.

List epics in a workspace (title, status, task counts, last plan, GitHub).

List structured progress updates for a task.

List tasks in a workspace. Can filter by status, epic, or show icebox items.

List Beck workspaces this token can see. Tokens are org-scoped — this is not a default workspace. If the human named one, use only that id. If more than one and none named, ask. create_workspace only if they asked for a new one.

Log a structured progress update for a task. Use this to document what you attempted, what succeeded, what failed, and any blockers or questions.

For people planning without an agent: snapshot selected documents into one or more epics, optionally with Beck's AI task breakdown. If you planned the work yourself, use record_plan instead. Suggested tasks are not in the backlog until import_suggested_tasks (or a human imports in Beck).

Read a workspace document by path (e.g. prd or research/notes).

Get recommendations for what task to work on next. Returns tasks prioritized by: 1) Your in-progress work, 2) Tasks assigned to you, 3) High-priority unassigned tasks.

Record an approved plan in one call: saves the plan markdown as a document under plans/, then creates each epic and its tasks in order. Use right after the human approves a plan (for example when leaving plan mode) if it has 3 or more tasks. You do the breakdown; Beck does not re-plan it.

Reject a ready_for_review task back to started. reason is required. Follow the same autonomy mode rules as accept_task.

Restore a document to a previous version. etag is the current document etag (If-Match), not the version's etag.

Brief for picking work back up in this repo's workspace: tasks in progress, waiting for review, next up, open epics and plan documents. Call at session start and after the conversation is compacted, before re-reading code.

Revoke an API token by id. Owner only via API path.

Set the relevant files for a task. Use this to record which files are important for the task, so future work sessions know where to look. Paths must be relative to project root.

Start working on a task. This assigns the task to you and changes status to 'started'. Use this before beginning implementation work.

Update task details (title, type, points, tags, epic, description, blocked status, acceptance criteria, relevant files). Status cannot be set here — use start_task, finish_task, accept_task, or reject_task.

Return the identity behind this API token (token name/kind, mint permission, owner). Use to know how comments and progress will be attributed.

Update a document. etag is required (If-Match from a prior read_document). Writes without an etag are rejected so concurrent edits cannot silently overwrite.