MCP Server, CLI & API Reference

Show Siftable CLI capabilities and readiness status

Show agent-friendly command topics and workflow entry points

Diagnose local Siftable CLI configuration without printing secrets

Launch the Siftable terminal copilot (sift interactive) — an in-process AI assistant over your tasks, work, calendar, projects, and people.

Flags

--connected-models — List eligible connected models and exit

--connection <value> needs model — Select a Model Connection UUID for a gateway invocation

--max-output-tokens <value> needs prompt — Maximum connected-model output tokens (1-32768)

--model <value> — Select an eligible connected model for a gateway invocation

--prompt <value> needs model — Invoke the selected connected model once and exit

--stream needs prompt — Consume selected connected-model output incrementally

Render a Mermaid diagram to the terminal (flowchart, sequence, state, class, ER, C4, architecture, mindmap). Reads a .mmd file or stdin.

Arguments

file — Path to a .mmd file (omit to read stdin)

Flags

--ascii — Use ASCII glyphs instead of Unicode box drawing

--color <none|truecolor> default: "truecolor" — Color mode

--height <value> — Fit into an exact N-row pane (pads/clips)

--max-height <value> — Bound the diagram to N rows (no padding)

--max-width <value> — Bound the diagram to N columns (no padding)

--overflow <allow|clip|error> default: "clip" — What to do when the diagram exceeds the bounds

--unicode — Use Unicode box drawing (default)

--width <value> — Fit into an exact N-column pane (pads/clips)

Create an agent alias

Flags

--alias <value> required — Stable alias slug, e.g. codex

--capabilities <value> — Capabilities JSON object

--hidden — Hide from normal user-visible lists

--name <value> — Display name

--operator <value> — Linked daemon/operator ID

--permissions <value> — Default permissions JSON object

--type <value> default: "custom" — Agent type

Disable an agent alias

Arguments

alias required — Agent alias or ID

Get an agent alias

Arguments

alias required — Agent alias or ID

List agent aliases

Flags

--include-disabled — Include disabled aliases

Update an agent alias

Arguments

alias required — Agent alias or ID

Flags

--capabilities <value> — Capabilities JSON object

--hidden — Hide from normal user-visible lists

--name <value> — Display name

--operator <value> — Linked daemon/operator ID

--permissions <value> — Default permissions JSON object

--status <active|disabled> — Alias status

--type <value> — Agent type

--visible — Show in normal user-visible lists

List work assigned to an agent alias

Arguments

alias required — Agent alias or ID

Flags

--limit <value> — Maximum results

--status <value> — Work item status

Show the secure browser flow for adding a non-exportable Model Connection

Flags

--url <value> default: "https://siftable.io/settings/model-connections" — Siftable Model Connections settings URL

Invoke an eligible connected model (requires ai:invoke and ai:connections:use)

Flags

--connection <value> required — Model Connection UUID returned by sift ai list

--max-output-tokens <value> — Maximum output tokens (1-32768)

--model <value> required — Eligible model ID returned by sift ai list

--prompt <value> required — Prompt text

--stream — Consume and print incremental connected-model output

List eligible connected models (requires ai:models:read)

Show non-secret Model Connection status (requires ai:connections:use)

Arguments

connection — Optional Model Connection UUID

Show connected-model usage totals (requires ai:usage:read)

Flags

--from <value> — ISO-8601 period start

--to <value> — ISO-8601 period end

Request a governed action approval; this command cannot approve or consume it

Flags

--action <value> required — Governed action identifier

--destination <value> default: "{}" — Destination binding JSON object

--expires-in <value> — Approval lifetime in seconds (30-600)

--operation <value> required — Operation identifier

--purpose <value> required — Human-readable non-secret purpose

--resource-id <value> required — Resource identifier

--resource-type <value> required — Resource type identifier

Inspect a governed approval requested by this CLI identity

Arguments

id required — Approval ID

Authenticate with Siftable

Flags

--scope <ai:models:read|ai:invoke|ai:usage:read|ai:connections:use|vault:metadata:read|vault:manage|vault:audit:read> repeatable — Incremental AI invocation or Vault scope to request (repeatable; management AI scopes and plaintext reveal are unavailable)

Remove stored authentication

Show authentication status

Allow, deny, or always allow personal funding for a quoted workspace operation

Flags

--decision <allow|deny|always_allow> required

--monthly-cap-micros <value> — Monthly micro-USD cap for always_allow

--quote <value> required — Server-issued operation quote ID

Read or update the workspace personal-fallback policy

Flags

--disabled — Disable and revoke personal fallback

--enabled — Enable personal fallback

Revoke one of your active personal-fallback consents

Arguments

consentId required

Show your active personal-fallback decisions for a workspace

Create a calendar event

Flags

--description <value> — Event description

--end <value> required — End time (ISO 8601)

--location <value> — Event location

--start <value> required — Start time (ISO 8601)

--title <value> required — Event title

Delete a calendar event

Arguments

id required — Event ID

Flags

-y, --yes — Skip confirmation

List calendar events

Flags

--end <value> — End date (ISO 8601)

--limit <value> — Maximum number of results

--start <value> — Start date (ISO 8601)

Update a calendar event

Arguments

id required — Event ID

Flags

--description <value> — Event description

--end <value> — End time (ISO 8601)

--location <value> — Event location

--start <value> — Start time (ISO 8601)

--title <value> — Event title

Create a reviewed server-brokered Vault capability

Flags

--adapter <value> required — Reviewed static adapter ID

--expires-in <value> — Lifetime in seconds (300-2592000)

--field <value> default: "value" — Credential payload field

--operation <value> required — Comma-separated allowlisted operations

--provider <value> required — Provider ID

--purpose <value> required — Non-secret human-readable purpose

--vault-entry <value> required — Vault entry UUID

Describe safe metadata for one Vault capability

Arguments

id required — Capability metadata ID

Execute one typed operation through a Vault capability handle

Flags

--approval <value> — Governed approval UUID when required

--handle <value> required — Opaque vcap_ capability handle

--idempotency-key <value> — Stable 8-128 character key for safe retries

--input <value> default: "{}" — Typed operation input JSON object

--operation <value> required — Allowlisted operation

List safe metadata for Vault capability handles

Revoke a Vault capability

Arguments

id required — Capability metadata ID

Git blame for a file

Arguments

file required — Relative file path

Flags

--root <value> default: "." — Repository root path

Confirm a code memory candidate with an auditable reason

Arguments

id required — Memory ID

Flags

--reason <value> required — Audit reason

Delete a stored curated code fact

Arguments

id required — Memory ID

Flags

-y, --yes — Skip confirmation

Detect likely-stale code memories and mark them needs_review (never deletes)

Flags

--limit <value> — Maximum memories to scan

--repo <value> — Repository ID

Edit a code memory in place; previous content stays in the audit ledger

Arguments

id required — Memory ID

Flags

--confidence <value> — Confidence 0-1

--fact <value> required — Updated fact

--reason <value> required — Audit reason

List append-only curation/lineage events for a code memory

Arguments

id required — Memory ID

Flags

--limit <value> — Maximum number of events

Show one code memory with provenance, evidence, and lifecycle

Arguments

id required — Memory ID

List stored curated code facts (excludes rejected/superseded by default)

Flags

--include-inactive — Include rejected and superseded lineage memories

--lifecycle <unreviewed|confirmed|rejected|superseded|needs_review> — Filter by lifecycle state

--limit <value> — Maximum number of results

--repo <value> — Repository ID

Mark a code memory needs_review for likely staleness/contradiction (never deletes)

Arguments

id required — Memory ID

Flags

--reason <value> required — Audit reason

--signal <value> repeatable — Staleness signal (repeatable)

Reject a code memory with an auditable reason (soft-reject; never deletes)

Arguments

id required — Memory ID

Flags

--reason <value> required — Audit reason

Search stored curated code facts (excludes rejected/superseded by default)

Arguments

query required — Search query

Flags

--category <architecture|integration|convention|entrypoint|gotcha|ownership> — Filter by category

--include-inactive — Include rejected and superseded lineage memories

--lifecycle <unreviewed|confirmed|rejected|superseded|needs_review> — Filter by lifecycle state

--limit <value> — Maximum number of results

--repo <value> — Repository ID

Store a curated code fact

Flags

--agent <value> — Authoring agent (marks memory as agent-authored)

--category <architecture|integration|convention|entrypoint|gotcha|ownership> required — Fact category

--commit <value> — Source commit SHA

--confidence <value> — Confidence 0-1

--evidence-chunk <value> repeatable — Historical indexed chunk ID supporting the fact

--fact <value> required — Fact to store (1-2 sentences)

--file <value> — Related file path

--path <value> repeatable — Additional related path (repeatable)

--reason <value> — Capture reason (required with --agent)

--repo <value> — Repository ID

--work-item <value> — Related agent work item ID

Supersede a code memory with a new fact; old memory retained as lineage

Arguments

id required — Memory ID to supersede

Flags

--category <architecture|integration|convention|entrypoint|gotcha|ownership> — Fact category (defaults to previous)

--commit <value> — Source commit SHA

--confidence <value> — Confidence 0-1

--evidence-chunk <value> repeatable — Evidence chunk ID (repeatable)

--fact <value> required — Replacement fact

--file <value> — Related file path

--path <value> repeatable — Additional related path (repeatable)

--reason <value> required — Audit reason

Collect read-only Siftable and local git context for Codex daily work reviews

Flags

--calendar-days <value> default: 7 — Calendar lookahead days

--limit <value> default: 20 — Maximum records per source

--skip-git — Skip local git summary

Explain the current principal, owner, project, and local checkout context

Flags

--workspace-root <value> — Absolute local checkout root to describe (never sent as a workspace tenant ID)

Apply only approved operations from an existing CRM import plan; replay is safe

Arguments

planId required — Durable CRM import plan UUID

Flags

--yes — Confirm canonical CRM writes without prompting

Approve all or selected pending operations in an existing CRM import plan

Arguments

planId required — Durable CRM import plan UUID

Flags

--operation-id <value> repeatable — Stable operation ID to approve; repeat to approve a subset

--reason <value> required — Human approval reason recorded on the plan

--yes — Confirm the approval without prompting

Resume and inspect a durable CRM import plan by stable plan ID

Arguments

planId required — Durable CRM import plan UUID

Create or reuse a durable CRM import plan from CSV, TSV, XLS, or XLSX without writing canonical CRM records

Arguments

file required — Local CSV, TSV, XLS, or XLSX source (8 MiB maximum)

Flags

--mapping-mode <manual|workspace_auto> default: "manual" — Manual mapping or approved workspace mapping profile

--provider <generic|salesforce> default: "generic" — Source provider mapping

Explain the governed boundary between a CRM organization and a workspace

Arguments

id required — CRM organization ID

List CRM organizations only; collaborative workspaces are excluded

Flags

--limit <value> default: 100 — Maximum number of CRM results

--search <value> — Optional fuzzy search query

Add records to a dataset

Arguments

id required — Dataset ID

Flags

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

--record <value> repeatable — Record as JSON object, e.g. '{"name":"Alice","age":"30"}'

--records <value> — Multiple records as JSON array

Aggregate dataset records with grouped metrics (count, avg, sum, min, max, median, stddev, percentile, ratio)

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

--group-by <value> — Comma-separated field names to group by

--having <value> — JSON array of having clauses [{metric, operator, value}]

--limit <value> default: 100 — Max rows

--metrics <value> — JSON array of metrics [{operation, field, as}]

--sorts <value> — JSON array of sorts

Generate grounded natural-language insights for a dataset

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

--focus-fields <value> — Comma-separated field names to focus analysis on

--max-insights <value> default: 5 — Max insights to generate

--mode <descriptive|operational> — Analysis mode

--signal-limit <value> — Max decision signals to return

Apply a saved dataset diff plan

Arguments

plan required — Path to a local diff plan or persisted diff plan ID

Flags

--yes — Confirm applying the saved diff plan without prompting

Archive a dataset without dropping its physical table

Arguments

id required — Dataset ID

Flags

-y, --yes — Confirm dataset archival without prompting

Bucket a numeric or date field into ranges with aggregate metrics per bucket

Arguments

id required — Dataset ID

Flags

--boundaries <value> — Comma-separated boundary values (omit for auto-bucketing)

--bucket-count <value> — Number of auto-buckets (default: 5)

--field <value> required — Field to bucket

--filters <value> — JSON array of filters

--metrics <value> — JSON array of metrics

Plan or apply cleanup for lifecycle-tagged scratch datasets

Flags

--dry-run — Return a deterministic cleanup plan without deleting datasets

--lifecycle <value> — Lifecycle kind to clean, e.g. scratch, benchmark, research-run

--limit <value> default: 100 — Maximum lifecycle datasets to inspect

--now <value> — Deterministic timestamp for tests and scheduled cleanup

--older-than <value> — Only include datasets older than this duration, e.g. 12h, 7d

--orphaned — Include stale dataset notes that no longer have a backing dataset row

--tag <value> — Lifecycle tag to clean, e.g. benchmark

-y, --yes — Confirm deletion when applying cleanup with --no-dry-run

Compare metrics across segments of a categorical field side-by-side

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

--limit <value> default: 10 — Max segment values to compare

--metrics <value> — JSON array of metrics

--segment-field <value> required — Categorical field to segment by

--segment-values <value> — Comma-separated segment values (auto-discovers if omitted)

Compute derived fields from a dataset or prior derived result

Arguments

id — Dataset ID

Flags

--computed-fields <value> required — JSON array of computed fields, e.g. '[{"as":"spread","expression":"right.Close-left.Close"}]'

--filters <value> — JSON array of filters

--limit <value> default: 50 — Maximum rows

--order-by <value> — JSON array of order clauses

--select <value> — Comma-separated fields to include

--sorts <value> — JSON array of output sorts

--source-result <value> — Inline JSON for a prior derived result

--source-result-file <value> — Path to a JSON file containing a prior derived result

Show an agent-readable dataset schema and capabilities contract

Arguments

id required — Dataset ID

Flags

--resolve <value> — Comma-separated semantic field references to resolve

--template <value> — Validate contract against a built-in template

Create a dataset

Flags

--description <value> — Dataset description

--fields <value> — Field definitions as JSON array, e.g. '[{"name":"age","type":"number"}]'

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

--lifecycle <value> — Lifecycle kind for generated datasets, e.g. scratch, benchmark, research-run

--metadata <value> — Dataset metadata as JSON object

--note-id <value> — Link to an existing note

--run-id <value> — Lifecycle run identifier

--scratch — Shortcut for --lifecycle scratch --tags scratch

--tags <value> — Comma-separated lifecycle tags

--title <value> required — Dataset title

--ttl <value> — Lifecycle TTL duration, e.g. 12h, 7d, 30d

Find duplicate dataset records by key without mutating data

Arguments

id required — Dataset ID

Flags

--key <value> required — Field name used to group duplicates

--limit <value> default: 500 — Maximum records to scan in one bounded pass

Permanently delete a dataset and drop its physical table

Arguments

id required — Dataset ID

Flags

-y, --yes — Confirm dataset deletion without prompting

Delete a record from a dataset

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

-y, --yes — Skip confirmation

Preview dataset row changes from a CSV, JSON, or JSONL file

Arguments

id required — Dataset ID

Flags

--batch-size <value> default: 100 — Records per backend batch

--from-file <value> required — Path to CSV, JSON, or JSONL rows to compare

--persist — Persist the diff plan in Siftable for later review/apply

--save-plan <value> — Write an applyable diff plan JSON file

--template <sources|people|events|claims|evidence_sources|evidence_source_fragments|evidence_claims|evidence_people|evidence_organizations|evidence_places|evidence_artifacts|evidence_events|evidence_relationships|evidence_contradictions> — Built-in template name

--upsert-by <value> — Field name used to match existing rows

List persisted dataset diff plans

Flags

--dataset-id <value> — Filter by dataset ID

--limit <value> default: 50 — Maximum plans to return

--status <draft|validated|applied|rejected|expired> — Filter by plan status

Show a persisted dataset diff plan

Arguments

id required — Diff plan ID

Export bounded dataset records as CSV, JSON, JSONL, or Markdown

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

--format <csv|json|jsonl|markdown> default: "csv" — Export format

--limit <value> default: 500 — Max rows to export

-o, --output <value> — Output file path (writes to stdout if omitted)

--sorts <value> — JSON array of sorts

Show bounded facet summaries for dataset fields

Arguments

id required — Dataset ID

Flags

--fields <value> — Comma-separated field names to facet

--limit <value> default: 20 — Maximum values per facet

Compute formula fields and preview reviewable dataset updates

Arguments

id required — Dataset ID

Flags

--computed-fields <value> required — JSON array of computed fields, e.g. '[{"as":"score","expression":"confidence * reliability"}]'

--filters <value> — JSON array of filters for compute source

--limit <value> default: 100 — Maximum rows to compute and plan

--order-by <value> — JSON array of order clauses

--save-plan <value> — Write an applyable diff plan JSON file

--select <value> — Comma-separated fields to include in compute source

--sorts <value> — JSON array of output sorts

--target-fields <value> — Comma-separated computed field names to write; defaults to every computed field alias

--template <sources|people|events|claims> — Built-in template name for validation

--upsert-by <value> required — Field used to match rows for update

Get dataset details and schema

Arguments

id required — Dataset ID

Explain dataset formula, graph, view, quality, and materialization impact

Arguments

id required — Dataset ID

Flags

--from-plan <value> — Persisted diff plan ID to inspect

--operation <value> — Committed dataset operation ID to inspect

Import CSV, JSON, or JSONL rows into a new or existing dataset

Arguments

file required — Path to CSV, JSON, or JSONL file

Flags

--batch-size <value> default: 100 — Records per backend batch

--dataset-id <value> — Import into existing dataset instead of creating a new one

--description <value> — Dataset description

--dry-run — Validate and plan the import without writing

--lifecycle <value> — Lifecycle kind for generated datasets, e.g. scratch, benchmark, research-run

--metadata <value> — Dataset metadata as JSON object when creating a new dataset

--run-id <value> — Lifecycle run identifier

--scratch — Shortcut for --lifecycle scratch --tags scratch

--tags <value> — Comma-separated lifecycle tags

--template <sources|people|events|claims|evidence_sources|evidence_source_fragments|evidence_claims|evidence_people|evidence_organizations|evidence_places|evidence_artifacts|evidence_events|evidence_relationships|evidence_contradictions> — Built-in template name

--title <value> — Dataset title (defaults to filename)

--ttl <value> — Lifecycle TTL duration, e.g. 12h, 7d, 30d

--upsert-by <value> — Field name used to update matching rows instead of creating duplicates

--yes — Confirm mutating imports without prompting

Inspect the structure of a local CSV, TSV, XLS, or XLSX file without creating or changing a dataset

Arguments

file required — Path to a local CSV, TSV, XLS, or XLSX file

Flags

--delimiter <value> — Single-byte delimiter override for CSV/TSV

--format <csv|tsv|xls|xlsx> — Format override when the extension is absent or wrong

--header-row <value> — Zero-based header row index within the sheet grid

--max-bytes <value> — Refuse files larger than this many bytes

--max-cols <value> — Maximum columns returned per sheet

--max-rows <value> — Maximum data rows returned per sheet

--max-sheets <value> — Maximum sheets returned

--sheet <value> — Inspect only this sheet; the full sheet inventory is still reported

Join a dataset to itself using alias-scoped fields such as left.Close and right.Close

Arguments

id required — Dataset ID

Flags

--join-keys <value> required — JSON array of join keys, e.g. '[{"leftField":"Date","rightField":"Date"}]'

--join-type <inner|left|right> default: "inner" — Join type

--left-alias <value> default: "left" — Left alias

--left-filters <value> — JSON array of left-side filters

--limit <value> default: 50 — Maximum joined rows

--right-alias <value> default: "right" — Right alias

--right-filters <value> — JSON array of right-side filters

--select <value> — Comma-separated alias-scoped fields to return

--sorts <value> — JSON array of sorts

List datasets

Flags

--limit <value> default: 50 — Maximum number of results

Lookup dataset records by an exact key/value match

Arguments

id required — Dataset ID

Flags

--key <value> required — Field name to match

--limit <value> default: 25 — Maximum matching records

--value <value> required — Exact value to match

Materialize a derived result into a new scratch dataset

Flags

--description <value> — Dataset description

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

--source-result <value> — Inline JSON for a derived result

--source-result-file <value> — Path to a JSON file containing a derived result

--title <value> required — Title of the new dataset

Create a pivot-style summary from grouped dataset metrics

Arguments

id required — Dataset ID

Flags

--cols <value> required — Column field

--filters <value> — JSON array of filters

--limit <value> default: 500 — Maximum grouped cells to request

--metrics <value> — JSON metrics array; defaults to count

--rows <value> required — Row field

Validate and normalize a lightweight plot payload from a derived result

Flags

--chart-type <line|bar|scatter> required — Chart type

--series-field <value> — Optional series field

--source-result <value> — Inline JSON for a derived result

--source-result-file <value> — Path to a JSON file containing a derived result

--x-field <value> required — X-axis field

--y-fields <value> required — Comma-separated Y-axis fields

Show bounded profile information for a dataset

Arguments

id required — Dataset ID

Flags

--sample-limit <value> default: 10 — Number of sample rows to include

Check dataset quality with structured missing-value metrics and repeated-value observations

Arguments

id required — Dataset ID

Flags

--fields <value> — Comma-separated field names to check

--repeat-threshold <value> default: 3 — Minimum occurrences for a repeated value to be reported

Query records from a dataset

Arguments

id required — Dataset ID

Flags

--cursor <value> — Pagination cursor from previous query

--filters <value> — Filter conditions as JSON array, e.g. '[{"field":"status","value":"active"}]'

--include-deleted — Include soft-deleted records

--limit <value> default: 25 — Maximum number of records

--sorts <value> — Sort spec as JSON array, e.g. '[{"field":"name","direction":"asc"}]'

Rank dataset records by sorts or a weighted numeric formula

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

--formula <value> — JSON formula object {weights: [{field, weight}]}

--limit <value> default: 25 — Max rows

--sorts <value> — JSON array of sorts

Compare two datasets by key without mutating either dataset

Arguments

left required — Left dataset ID

right required — Right dataset ID

Flags

--left-key <value> required — Left dataset key field

--limit <value> default: 500 — Maximum rows to scan from each dataset

--right-key <value> — Right dataset key field; defaults to --left-key

Modify dataset schema (add, update, or delete fields)

Arguments

id required — Dataset ID

Flags

--field <value> — Field definition as JSON, e.g. '{"name":"email","type":"text"}'

--field-id <value> — Field ID (required for update/delete)

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

--operation <add_field|update_field|delete_field> required — Schema operation

Search dataset records across selected text-like fields

Arguments

id required — Dataset ID

query required — Search text

Flags

--fields <value> — Comma-separated fields to search; defaults to profile columns

--filters <value> — JSON array of base filters applied to every field search

--limit <value> default: 25 — Maximum merged records

--per-field-limit <value> default: 25 — Maximum records to request per searched field

Get a summary of a dataset (row count, fields, sample rows)

Arguments

id required — Dataset ID

List built-in dataset templates

Show a built-in dataset template schema

Arguments

template required — Template name

Analyze dataset time series with lag, pct_change, rolling windows, drawdown, volatility, and correlation

Arguments

id required — Dataset ID

Flags

--date-field <value> required — Date field name

--filters <value> — JSON array of filters

--limit <value> default: 100 — Maximum output rows

--metrics <value> — JSON array of metric definitions

--order-direction <asc|desc> default: "asc" — Time ordering

--pivot — Emit explicit pivoted output

--segment-field <value> — Optional segment field

--segment-values <value> — Comma-separated segment values

--transforms <value> — JSON array of transform definitions

Update a record in a dataset

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

--fields <value> required — Field updates as JSON object, e.g. '{"status":"done"}'

--idempotency-key <value> required — Caller-owned stable key for replaying this exact dataset mutation

Validate a dataset against a built-in template

Arguments

id required — Dataset ID

Flags

--template <sources|people|events|claims|evidence_sources|evidence_source_fragments|evidence_claims|evidence_people|evidence_organizations|evidence_places|evidence_artifacts|evidence_events|evidence_relationships|evidence_contradictions> required — Built-in template name

Upload a document (PDF, Markdown, or text) as a note

Arguments

file required — Path to file

Flags

--project <value> — Project ID

--title <value> — Note title (defaults to filename)

--type <note|concept|meeting|reference|daily|dataset> — Note type

Validate the environment contract for local or CI use

Flags

--checkout-root <value> — Exact Git checkout root containing .sift/environment.yaml

--ci — Fail non-zero when contract, example, Git, or checkout safety findings exist

Show value-free environment contract drift

Flags

--checkout-root <value> — Exact Git checkout root containing .sift/environment.yaml

Enroll a public endpoint identity without granting Vault access

Flags

--dedicated — Endpoint is a dedicated runner

--endpoint-class <interactive_desktop|remote_vm|noninteractive_runner|shared_host|ci_runner|production_host|multi_tenant> required — Explicit endpoint policy class

--kill-switch — Runner has an enforced kill switch

--owner <value> default: "personal" — personal or workspace:<uuid>

--storage-tier <hardware_host_bound|systemd_managed|convenience_keyring|none> required — Actual endpoint key storage tier; convenience_keyring is not hardware-backed

Generate a deterministic names-and-placeholders-only example

Flags

--checkout-root <value> — Exact Git checkout root containing .sift/environment.yaml

--write — Write the deterministic output to .env.example instead of displaying it

Apply one exact reviewed dotenv import plan atomically

Flags

--checkout-root <value> — Checkout used only to reject Sift-managed source files

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--plan-file <value> required — Reviewed value-free plan artifact

--source <value> required — Same explicit dotenv source used to create the plan

Create a value-free, owner-scoped plan for one explicitly named dotenv source

Flags

--checkout-root <value> — Checkout used only to reject Sift-managed source files

--decision <value> repeatable — Explicit per-index decision: INDEX:keep-existing|overwrite|skip|rename=NAME

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--plan-file <value> required — New local value-free plan artifact to create

--project <value> — Exact owner-scoped project UUID

--source <value> required — Explicit dotenv source file

Pull one exact governed Vault bundle into a Sift-managed development environment file

Flags

--approval-timeout <value> default: 600

--checkout-root <value> — Checkout containing .sift/environment.yaml

--destination <value> — Exact relative destination when the manifest declares more than one bundle

--endpoint-class <development|production|ci|shared_host|policy_ineligible> required — Explicit endpoint policy class; managed pulls accept development only

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--purpose <value> required

--replace — Replace a changed Sift-managed file using its exact observed precondition

Apply one exact reviewed dotenv import plan atomically

Flags

--checkout-root <value> — Checkout used only to reject Sift-managed source files

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--plan-file <value> required — Reviewed value-free plan artifact

--source <value> required — Same explicit dotenv source used to create the plan

Create a value-free, owner-scoped plan for one explicitly named dotenv source

Flags

--checkout-root <value> — Checkout used only to reject Sift-managed source files

--decision <value> repeatable — Explicit per-index decision: INDEX:keep-existing|overwrite|skip|rename=NAME

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--plan-file <value> required — New local value-free plan artifact to create

--project <value> — Exact owner-scoped project UUID

--source <value> required — Explicit dotenv source file

Remove one exact Sift-managed local environment file

Flags

--checkout-root <value> — Exact Git checkout root containing .sift/environment.yaml

--destination <value> — Exact relative destination when the manifest declares more than one bundle

--yes required — Confirm removal of the exact recognized managed file

Report value-free local environment state

Flags

--checkout-root <value> — Exact Git checkout root containing .sift/environment.yaml

Attach a person participant to an existing research event

Arguments

event required — Existing temporal fact ID

person required — Person UUID to attach

Flags

--role <value> default: "subject" — Participant role

--yes — Confirm participant attachment without prompting

Create a research event timeline fact with participants

Flags

--body <value> — Event notes/body

--confidence <low|medium|high> — Confidence level

--entity <value> repeatable — Participant/entity as type:uuid or type:uuid:role; repeatable

--org <value> repeatable — Organization UUID participant; repeatable

--person <value> repeatable — Person UUID participant; repeatable

--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era> default: "year" — Temporal precision

--source <value> repeatable — Source entity as type:uuid or type:uuid:role; repeatable

--source-label <value> — Source/provenance label

--source-note <value> — Source/provenance note

--source-url <value> — Source/provenance URL

--timestamp <value> — ISO timestamp

--title <value> required — Event title

--visibility <org_public|private|restricted> — Timeline visibility

--year <value> — Historical year CE

--year-end <value> — Historical end year CE

List research event timeline facts

Flags

--cursor <value> — Pagination cursor

--end <value> — End boundary

--entity <value> — Filter by entity ref type:uuid

--limit <value> default: 50 — Maximum events

--order <asc|desc> default: "asc" — Sort order

--person <value> — Filter by person UUID

--q <value> — Text search query

--start <value> — Start boundary

Apply a reviewed Evidence Graph diff plan

Arguments

id required — Persisted diff plan ID

Flags

--yes — Confirm applying the reviewed diff plan without prompting

Explain Evidence Graph consequences for a persisted diff plan

Arguments

id required — Persisted diff plan ID, or local when using --from-file

Flags

--from-file <value> — Local diff plan JSON file to explain without API access

List persisted Evidence Graph diff plans

Flags

--dataset-id <value> — Filter by evidence dataset ID

--limit <value> default: 50 — Maximum plans to return

--project <value> — Filter locally by Evidence Graph project ID when present on plans

--status <draft|validated|applied|rejected|expired> — Filter by plan status

Show an Evidence Graph diff plan with domain-aware summary

Arguments

id required — Persisted diff plan ID

Create no-apply agent work for Evidence Graph candidate extraction

Flags

--agent <value> default: "researcher" — Assigned agent alias

--context <value> — Additional input context JSON object

--context-file <value> — Additional input context JSON file

--dry-run — Preview work item payload without writing

--no-apply — Keep extraction in proposed/diff-first mode

--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack

--project <value> — Project ID

--source-dataset <value> required — Evidence sources dataset ID

--targets <value> — Comma-separated extraction targets

--yes — Confirm work item creation without prompting

Create an Evidence Graph project and dataset-backed working tables

Arguments

name required — Evidence Graph project name

Flags

--dry-run — Preview project/dataset creation without writing

--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack

--yes — Confirm creation without prompting

Plan an Evidence Graph workflow before writing trusted state

Arguments

goal required — Evidence Graph goal

Flags

--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack

--project <value> — Existing project ID

--source-dataset <value> — Existing evidence sources dataset ID

Dry-run Evidence Graph timeline and relationship projection

Flags

--dry-run — Preview projection without writing

--from-file <value> — Local diff plan JSON file to project from without API access

--from-plan <value> — Persisted diff plan ID to project from

--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack

--project <value> — Evidence Graph project ID

Generate an Evidence Graph proof report from a dataset-backed evidence packet

Flags

--format <json|markdown> default: "markdown" — Report format

--from-file <value> required — Evidence packet JSON file to report on

--project <value> — Evidence Graph project ID for report metadata

Import Evidence Graph source ledger rows into a dataset-backed source table

Arguments

file required — Path to CSV, JSON, or JSONL source ledger rows

Flags

--batch-size <value> default: 100 — Records per backend batch

--dataset-id <value> — Evidence sources dataset ID

--dry-run — Validate and plan source import without writing

--upsert-by <value> default: "source_id" — Field name used to update matching source rows

--yes — Confirm mutating imports without prompting

Verify Evidence Graph provenance, review, projection, and citation invariants

Flags

--from-file <value> required — Evidence packet JSON file to verify

--project <value> — Evidence Graph project ID for report metadata

List reviewed local execution adapters and honest containment tiers

Request a human-approved grant for a pre-registered trusted local runner

Flags

--adapter <value> required

--audience <value> required

--credential-field <value> required

--cwd <value>

--executable <value> required — Resolved reviewed executable path

--executable-digest <value> required

--issuer <value> required

--operation <value> required

--purpose <value> required

--runner-fingerprint <value> required

--runner-public-key <value> required — PEM public-key file from the trusted local runner

--scope <value> required — Provider scope JSON with string values

--vault-entry <value> required

Request approval, redeem in memory, and run exactly one reviewed child process

Flags

--adapter <github_gh|github_publish_pr|terraform_apply> required

--approval-timeout <value> default: 600

--audience <value> required

--body-file <value> — PR body file for github_publish_pr

--credential-field <value> required

--cwd <value>

--issuer <value> required

--operation <value> required

--purpose <value> required

--scope <value> required

--vault-entry <value> required

Inspect safe status for an ephemeral local execution grant

Arguments

id required

Explain a bounded graph path between two entities

Arguments

source required — Source entity reference as type:uuid

target required — Target entity reference as type:uuid

Flags

--depth <value> default: 4 — Maximum path depth, backend clamps to 1-5

--frontier-limit <value> default: 500 — Maximum links to inspect per path expansion, backend clamps to 1-1000

Explain a bounded graph path between two entities

Arguments

source required — Source entity reference as type:uuid

target required — Target entity reference as type:uuid

Flags

--depth <value> default: 4 — Maximum path depth, backend clamps to 1-5

--frontier-limit <value> default: 500 — Maximum links to inspect per path expansion, backend clamps to 1-1000

Show local graph neighbors for an entity

Arguments

entity required — Entity reference as type:uuid

Flags

--depth <value> default: 1 — Graph depth, backend clamps to 1-3

--limit <value> default: 80 — Maximum graph items, backend clamps to 1-200

Preview one graph entity

Arguments

entity required — Entity reference as type:uuid

Search linkable entities for graph work

Arguments

query required — Search query

Flags

--limit <value> default: 20 — Maximum results

--types <value> — Comma-separated entity types

Preview or bulk-delete notes

Flags

--archived — Filter by archived state

--confirm — Execute deletion instead of preview

--ids <value> — Comma-separated note IDs

--title-contains <value> — Title substring filter

--title-equals <value> — Exact title filter

--title-starts-with <value> — Title prefix filter

--type <note|concept|meeting|reference|daily|dataset>

Create a note

Flags

--content <value> — Note content (markdown)

--metadata <value> — Note metadata as JSON

--metadata-file <value> — Read note metadata JSON from a file

--project <value> — Project ID

--title <value> required — Note title

--type <note|concept|meeting|reference|daily|dataset> — Note type

Delete a note

Arguments

id required — Note ID

Flags

-y, --yes — Skip confirmation

Get a note with full content

Arguments

id required — Note ID

List notes

Flags

--archived — Filter by archived state

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

--title-contains <value> — Title substring filter

--title-equals <value> — Exact title filter

--title-starts-with <value> — Title prefix filter

--type <note|concept|meeting|reference|daily|dataset> — Filter by note type

Search notes

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

Update a note

Arguments

id required — Note ID

Flags

--content <value> — Note content (markdown)

--metadata <value> — Replace note metadata with this JSON object

--metadata-file <value> — Read replacement note metadata JSON from a file

--title <value> — Note title

--type <note|concept|meeting|reference|daily|dataset> — Note type

Preview or bulk-delete organizations

Flags

--confirm — Execute deletion instead of preview

--contains <value> — Name substring filter

--equals <value> — Exact name filter

--ids <value> — Comma-separated organization IDs

--relationship <value> — Filter by relationship status

--starts-with <value> — Name prefix filter

--type <value> — Filter by organization type

Create an organization

Flags

--domain <value> — Domain (e.g. acme.com)

--industry <value> — Industry

--linkedin-url <value> — LinkedIn page URL

--location <value> — Location

--name <value> required — Organization name

--notes <value> — Notes

--relationship-status <value> — Relationship status (e.g. prospect, customer, partner, vendor)

--type <value> — Organization type (e.g. company, nonprofit, government, school)

--website <value> — Website URL

Delete an organization

Arguments

id required — Organization ID

Flags

-y, --yes — Skip confirmation

Search organizations

Arguments

query — Optional fuzzy search query

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationship status

--starts-with <value> — Name prefix filter

--type <value> — Filter by organization type

Update an organization

Arguments

id required — Organization ID

Flags

--domain <value> — Domain (e.g. acme.com)

--industry <value> — Industry

--linkedin-url <value> — LinkedIn page URL

--location <value> — Location

--name <value> — Organization name

--notes <value> — Notes

--relationship-status <value> — Relationship status

--type <value> — Organization type

--website <value> — Website URL

Preview or bulk-delete contacts

Flags

--confirm — Execute deletion instead of preview

--contains <value> — Name substring filter

--equals <value> — Exact name filter

--has-no-email — Only contacts without an email

--ids <value> — Comma-separated person IDs

--relationship <value> — Filter by relationshipToUser

--starts-with <value> — Name prefix filter

Add an owner-relative Personal or Work relationship

Arguments

personId required — Person ID

Flags

--basis <value> — Why this relationship is recorded

--confidence <value> — Evidence confidence from 0 to 1

--context <personal|work> required — Relationship context

--primary — Make this the primary relationship in its context

--relationship <value> required — Relationship type, e.g. friend, client, mentor

List how the current owner knows a person

Arguments

personId required — Person ID

Remove an owner-relative relationship context

Arguments

personId required — Person ID

relationshipId required — Context relationship ID

Flags

--dry-run — Show what would be removed without writing

-y, --yes — Remove without prompting

Create a contact

Flags

--birth-year <value> — Birth year

--birthday <value> — Birthday (YYYY-MM-DD)

--company <value> — Company name (auto-links to organization if exists)

--context <personal|work> repeatable — How you know this person; repeat for both contexts

--email <value> — Email address

--estimated-age <value> — Estimated age

--job-title <value> — Job title

--linkedin-url <value> — LinkedIn profile URL

--location <value> — Location

--mbti <value> — MBTI type (e.g. INTJ, ENFP)

--name <value> required — Full name

--notes <value> — Notes about this person

--phone <value> — Phone number

--relationship <value> — Relationship to user (e.g. friend, colleague, client, mentor)

--website <value> — Personal website

Delete a contact

Arguments

id required — Person ID

Flags

-y, --yes — Skip confirmation

Research public information about a person with replay-safe execution

Arguments

id required — Person ID

Flags

--dataset <value> — Optional dataset ID for a reviewable reconciliation plan

--dataset-upsert-by <value> — Preferred dataset identity field

--idempotency-key <value> required — Stable 8-128 character key for exact retries

--mode <standard|ultra> default: "standard" — Research depth

Get a person profile with traits and relationships

Arguments

id required — Person ID

Show a person-centered relationship graph

Arguments

id required — Person ID

Flags

--depth <value> default: 2 — Relationship graph depth

--include-inactive — Include inactive relationship edges

Explain kinship or relationship distance between two people

Arguments

egoPersonId required — Ego/source person ID

targetPersonId required — Target person ID

Flags

--max-depth <value> default: 6 — Maximum relationship depth

List contacts

Flags

--category <family|romantic|professional|social> — Relationship category

--contains <value> — Name substring filter

--context <all|personal|work> default: "all" — Relationship context

--equals <value> — Exact name filter

--has-no-email — Only contacts without an email

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationshipToUser

--starts-with <value> — Name prefix filter

Create or update a relationship between two people

Arguments

personAId required — First person ID

personBId required — Second person ID

Flags

--dry-run — Preview the relationship payload without writing

--notes <value> — Relationship notes

--type <value> required — Relationship type, e.g. colleague, sibling, spouse, collaborator

-y, --yes — Apply without prompting

Search contacts

Arguments

query required — Search query

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

--has-no-email — Only contacts without an email

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationshipToUser

--starts-with <value> — Name prefix filter

List timeline facts connected to a person

Arguments

id required — Person ID

Flags

--limit <value> default: 50 — Maximum facts to return

--order <asc|desc> default: "asc" — Sort order

--role <value> — Filter by entity role, comma-separated

Update a contact

Arguments

id required — Person ID

Flags

--birth-year <value> — Birth year

--birthday <value> — Birthday (YYYY-MM-DD)

--company <value> — Company name

--email <value> — Email address

--estimated-age <value> — Estimated age

--job-title <value> — Job title

--linkedin-url <value> — LinkedIn profile URL

--location <value> — Location

--mbti <value> — MBTI type (e.g. INTJ, ENFP)

--name <value> — Full name

--notes <value> — Notes about this person

--phone <value> — Phone number

--relationship <value> — Relationship to user

--website <value> — Personal website

Archive a project

Arguments

id required — Project ID

Flags

-y, --yes — Skip confirmation

Get project context (tasks, notes, signals)

Arguments

id required — Project ID

Create a project

Flags

--emoji <value> — Single emoji

--name <value> required — Project name

--status <planning|active|on_hold|blocked|completed> — Project status

--summary <value> — Project summary

List projects

Flags

--include-archived — Include archived projects

--status <planning|active|on_hold|blocked|completed> — Filter by status

Get the canonical CSN planning snapshot for a project

Arguments

id required — Project ID

Recompute the canonical CSN planning snapshot for a project

Arguments

id required — Project ID

Update a project

Arguments

id required — Project ID

Flags

--emoji <value> — Single emoji

--name <value> — Project name

--status <planning|active|on_hold|blocked|completed> — Project status

--summary <value> — Project summary

List built-in research workflow recipes

Show a built-in research workflow recipe

Arguments

id required — Recipe ID

Preview a relationship action on the server without committing it

Arguments

id required — Relationship action ID

entity — Relationship entity as opportunity:<uuid> or prospect:<uuid>

Flags

--entity <value> — Target as prospect:uuid or opportunity:uuid

--idempotency-key <value> required — Stable 8-128 character key for reproducible server-side previews

--input <value> — Action input JSON object

--input-file <value> — Path to action input JSON

List registered relationship actions and their commitment policies

Flags

--approval-policy <value> — Filter by approval policy

--commitment <value> — Filter by commitment class

--limit <value> — Maximum results

Run any canonical relationship action with replay-safe caller identity

Arguments

id required — Canonical action ID from relationships actions list

entity — Relationship entity as opportunity:<uuid> or prospect:<uuid>

Flags

--entity <value> — Target as prospect:uuid or opportunity:uuid

--expected-version <value> — Current collaboration version

--idempotency-key <value> required — Stable 8-128 character key for exact retries

--input <value> — Action input JSON object

--input-file <value> — Path to an action input JSON file

--yes — Confirm action execution

Show one registered relationship action

Arguments

id required — Relationship action ID

Compose an exact, evidence-grounded relationship brief

Arguments

subject required — Subject as prospect:uuid or opportunity:uuid

Flags

--lens <value> default: "relationship" — Relationship lens identifier

Create an attributed approver revision and reopen coaching review

Arguments

id required — Composer session UUID

Flags

--body <value> required

--expected-version <value> required

--reason <value> required

--subject <value> required

--yes — Confirm the attributed edit

Bind an explicit active connected email account to a durable draft

Arguments

id required — Composer session UUID

Flags

--expected-version <value> required — Current optimistic session version

--sender <value> required — Connected email account UUID

Confirm the bound brief and create its first durable draft revision

Arguments

id required — Composer session UUID

Flags

--expected-version <value> required — Current optimistic session version

--yes — Confirm brief and create draft

Create or resume a durable relationship brief-to-draft session

Arguments

subject required — Subject as prospect:uuid or opportunity:uuid

Flags

--file <value> required — JSON file with source, recommendation, brief, and ranked evidence

Keep exact approval, send now, or schedule one governed relationship message

Arguments

id required — Composer session UUID

Flags

--at <value> — ISO-8601 time required for send_later

--choice <approve_only|send_now|send_later> required — Dispatch outcome

--expected-version <value> required — Current optimistic session version

--idempotency-key <value> required — Stable retry key for this exact choice and time

--yes — Confirm this governed dispatch choice

Evaluate the current durable draft and append phrase-anchored coaching findings

Arguments

id required — Composer session UUID

Flags

--expected-version <value> required — Current optimistic session version

Explain, preview, accept, reject, or undo an attributable coaching finding

Arguments

id required — Composer session UUID

finding required — Coaching finding UUID

Flags

--action <explain|preview|accept|reject|undo> required

--expected-version <value> required — Current optimistic session version

--yes — Confirm a mutating coaching decision

Show append-only coaching and draft decision history in recorded order

Arguments

id required — Composer session UUID

Request or resume approval for the exact composer review; approval remains browser-only

Arguments

id required — Composer session UUID

Flags

--expected-version <value> required — Current optimistic session version

--idempotency-key <value> required — Stable approval-request retry key

--yes — Confirm the approval request

Return an exact review to its author without mutating the message

Arguments

id required — Composer session UUID

Flags

--expected-version <value> required

--reason <value> required

--yes — Confirm the review interruption

Resolve or route the inline plausible-duplicate gate for one reviewed message

Arguments

id required — Composer session UUID

Flags

--candidate <value> required — Candidate person UUID

--decision <same_person|different_people|route_to_owner> required

--expected-version <value> required

--yes — Confirm the identity decision

Continue a coaching-clear durable draft to governed review

Arguments

id required — Composer session UUID

Flags

--approver-user-id <value> — Optional active internal workspace member who will approve the exact message

--expected-version <value> required — Current optimistic session version

--yes — Confirm the transition to review

Save a new durable revision of a relationship draft

Arguments

id required — Composer session UUID

Flags

--file <value> required — JSON file with expectedVersion, subject, and bodyText

Show a durable relationship composer session

Arguments

id required — Composer session UUID

Update bound intent and ranked evidence before draft creation

Arguments

id required — Composer session UUID

Flags

--file <value> required — JSON file with expectedVersion, brief, and evidence

Inspect one canonical person contact plan without mutating its source lifecycles

Arguments

person required — Canonical person UUID

Flags

--from <value> — Inclusive ISO-8601 inspection window start

--limit <value> default: 100 — Maximum projected items

--timezone <value> — IANA display timezone

--to <value> — Inclusive ISO-8601 inspection window end

Create an immutable, evidence-grounded relationship diagnosis snapshot

Flags

--file <value> required — Diagnosis JSON file

--yes — Confirm immutable diagnosis creation

List immutable relationship diagnosis snapshots

Flags

--limit <value>

--subject-id <value>

--subject-type <prospect|opportunity>

List sender accounts available to relationship drafts and governed sends

Create a private communication proposal from an approved outreach asset; does not send

Arguments

id required — Generated outreach/follow-up asset UUID

Flags

--file <value> required — Exact senderAccountId, destination, optional edits, and idempotency JSON file

--yes — Confirm proposal creation

Generate a grounded asset from approved exact playbook and source-asset versions

Flags

--file <value> required — Generation request JSON file

--yes — Confirm immutable asset generation

List generated relationship assets with manifests and latest artifact review

Flags

--limit <value>

--subject-id <value>

--subject-type <prospect|opportunity>

Append a human approval decision to a generated artifact

Arguments

id required — Generated asset UUID

Flags

--decision <approved|rejected|needs_changes> required

--reason <value> required

--yes — Confirm append-only review

List the append-only review history for one generated asset

Arguments

id required — Generated asset UUID

Show one generated asset, exact manifest, and latest artifact approval

Arguments

id required — Generated asset UUID

List append-only usage and outcome links for one generated asset

Arguments

id required — Generated asset UUID

Append an export, internal-share, or outcome-link record to a generated asset

Arguments

id required — Generated asset UUID

Flags

--idempotency-key <value> required — Stable 8-128 character retry key

--kind <exported|shared_internally|outcome_linked> required

--outcome <value> — Stable outcome reference; required for outcome_linked

--yes — Confirm append-only usage record

List immutable relationship outcome receipts in the onboarding queue

Flags

--limit <value> default: 100 — Maximum receipts

Show one immutable relationship outcome handoff receipt

Arguments

id required — Outcome handoff receipt UUID

Compose a cited meeting brief from approved relationship evidence

Flags

--input <value> — Exact meeting brief input JSON

--input-file <value> — Path to exact meeting brief input JSON

Read the current cited meeting brief by recomposing its exact inputs

Flags

--input <value> — Exact owner, subject, approved asset, and optional meeting JSON

--input-file <value> — Path to exact meeting brief input JSON

Capture consent-gated transcript evidence or explicitly declared manual notes

Flags

--idempotency-key <value> required — Caller-owned stable key for exact retries

--input <value> — Exact meeting evidence input JSON

--input-file <value> — Path to exact meeting evidence input JSON

--yes — Confirm canonical evidence capture

Inspect one canonical meeting-evidence event and its source locators

Arguments

id required — Relationship meeting evidence event UUID

Atomically apply one approved meeting proposal after fresh precondition checks

Arguments

id required — Approved meeting proposal UUID

Flags

--expected-proposal-digest <value> required — Exact reviewed proposal digest

--yes — Confirm the persistent internal relationship-state change

Create an immutable, evidence-cited proposal for one registered relationship action

Flags

--idempotency-key <value> required — Caller-owned stable key for exact retries

--input <value> — Exact meeting proposal input JSON

--input-file <value> — Path to exact meeting proposal input JSON

--yes — Confirm immutable proposal creation

List meeting-derived relationship proposals and their review lifecycle

Flags

--status <pending|approved|rejected|committed|failed|stale> — Filter by lifecycle status

--subject-id <value> — Filter by subject UUID

--subject-kind <prospect|opportunity> — Filter by subject kind

Append an attributable approval or rejection to one unchanged meeting proposal

Arguments

id required — Meeting proposal UUID

Flags

--input <value> — Exact decision, reason, and expectedProposalDigest JSON

--input-file <value> — Path to exact proposal review input JSON

--yes — Confirm attributable proposal review

Inspect a meeting-derived relationship proposal, evidence, diffs, and recovery plan

Arguments

id required — Meeting proposal UUID

Describe the runtime relationship-outcome contracts and safety boundaries

Inspect declared relationship outcomes in Answer/C0 mode without persistence

Flags

--input <value> — Exact InspectRelationshipOutcomeInput JSON

--input-file <value> — Path to exact inspection input JSON

Show the single bounded, reviewable intervention batch for a snapshot

Arguments

snapshotId required — Relationship-outcome snapshot ID

List relationship-outcome snapshots with bounded cursor pagination

Flags

--cursor <value> — Opaque cursor from the previous page

--limit <value> default: 50 — Maximum snapshots to return

--projection <sales_forecast|onboarding_handoff> — Filter by projection

--scope-anchor-id <value> — Filter by declared scope anchor ID

--scope-anchor-kind <value> — Filter by declared scope anchor kind

List exact snapshot records with bounded cursor pagination

Arguments

snapshotId required — Relationship-outcome snapshot ID

Flags

--cursor <value> — Opaque cursor from the previous page

--limit <value> default: 50 — Maximum records to return

--posture <value> — Filter by the declared record posture

--risk <value> — Filter by low, moderate, high, or unknown operational risk

Record an idempotent snapshot review without executing any proposed registered action

Arguments

snapshotId required — Relationship-outcome snapshot ID

Flags

--dry-run — Validate authority and selected interventions without recording a review

--idempotency-key <value> required — Caller-owned stable key for this exact review

--input <value> — Exact ReviewRelationshipOutcomeSnapshotInput JSON (idempotency is injected)

--input-file <value> — Path to exact snapshot review input JSON

--yes — Confirm append-only review recording

Create or dry-run a C2 relationship-outcome snapshot; never execute proposed actions

Flags

--dry-run — Validate and project without persisting a snapshot

--idempotency-key <value> required — Caller-owned stable key for this exact snapshot request

--input <value> — Exact CreateRelationshipOutcomeSnapshotInput JSON (idempotency is injected)

--input-file <value> — Path to exact snapshot input JSON

--yes — Confirm C2 snapshot persistence

Show one immutable relationship-outcome snapshot

Arguments

snapshotId required — Relationship-outcome snapshot ID

Record a consequential recommendation with at least three plausible moves

Flags

--file <value> required — Recommendation JSON file

--yes — Confirm immutable recommendation creation

List recorded relationship playbook recommendations with alternative moves

Flags

--limit <value>

--subject-id <value>

--subject-type <prospect|opportunity>

Create an immutable, unapproved relationship playbook version from runtime-contract JSON

Flags

--file <value> required — Playbook version JSON file

--yes — Confirm immutable version creation

List immutable relationship playbook versions and latest approval decisions

Flags

--limit <value> — Maximum versions

--stable-key <value> — Filter by stable playbook key

Append a human approval decision to a playbook version

Arguments

id required — Playbook version UUID

Flags

--decision <approved|rejected|needs_changes> required

--reason <value> required — Attributable review reason

--yes — Confirm append-only review

Show one immutable relationship playbook version and latest approval

Arguments

id required — Playbook version UUID

Inspect one relationship action proposal and its evidence

Arguments

id required — Proposal ID

List pending and historical relationship action proposals

Flags

--enrollment <value> — Filter by enrollment ID

--limit <value> — Maximum results

--sequence <value> — Filter by sequence ID

--status <value> — Filter by proposal status

Request short-lived human approval for a proposal; cannot approve or consume it

Arguments

id required — Proposal ID

Flags

--idempotency-key <value> required — Stable 8-128 character key for safe retries

--purpose <value> — Non-secret reason shown to the human approver

List relationship team queues in the active workspace

Execute an accepted, current recommendation through the canonical action runtime

Arguments

id required — Recommendation UUID

Flags

--yes — Confirm canonical action execution

List immutable relationship recommendation snapshots

Flags

--lens <value> — Relationship lens identifier

--limit <value> default: 50 — Maximum recommendations

--subject <value> — Filter by prospect:uuid or opportunity:uuid

Append an ordinary review decision to a relationship recommendation

Arguments

id required — Recommendation UUID

Flags

--decision <accepted|dismissed|snoozed|needs_information> required — Review decision

--reason <value> — Review reason

--snoozed-until <value> — Offset-aware ISO date-time, required for snoozed

--yes — Confirm the append-only review

Show a relationship recommendation with its exact citations and gates

Arguments

id required — Recommendation UUID

Create a supervised relationship sequence from a JSON definition

Flags

--definition <value> — Sequence definition JSON object

--definition-file <value> — Path to sequence definition JSON

--idempotency-key <value> required — Stable 8-128 character key for safe retries

Preview a supervised sequence on the server without committing it

Arguments

id required — Sequence ID

Flags

--idempotency-key <value> required — Stable 8-128 character key for reproducible server-side previews

--input <value> — Dry-run input JSON object

--input-file <value> — Path to dry-run input JSON

Enroll a relationship target in a supervised sequence

Arguments

id required — Sequence ID

Flags

--idempotency-key <value> required — Stable 8-128 character key for safe retries

--input <value> — Enrollment input JSON object

--input-file <value> — Path to enrollment input JSON

Show one supervised relationship sequence

Arguments

id required — Sequence ID

List supervised relationship sequences

Flags

--limit <value> — Maximum results

--status <value> — Filter by sequence status

Pause a supervised relationship sequence

Arguments

id required — Sequence ID

Flags

--idempotency-key <value> required — Stable 8-128 character key for safe retries

--reason <value> — Non-secret pause reason

Resume a supervised relationship sequence

Arguments

id required — Sequence ID

Flags

--idempotency-key <value> required — Stable 8-128 character key for safe retries

List execution evidence for a supervised relationship sequence

Arguments

id required — Sequence ID

Flags

--limit <value> — Maximum results

--status <value> — Filter by run status

Update a supervised relationship sequence from a JSON definition

Arguments

id required — Sequence ID

Flags

--definition <value> — Sequence update JSON object

--definition-file <value> — Path to sequence update JSON

--idempotency-key <value> required — Stable 8-128 character key for safe retries

Show the current relationship collaboration snapshot

Arguments

entity required — Relationship entity as opportunity:<uuid> or prospect:<uuid>

Create an immutable, unapproved grounded source-asset version

Flags

--file <value> required — Source-asset version JSON file

--yes — Confirm immutable version creation

List immutable grounded source-asset versions and latest approval decisions

Flags

--limit <value> — Maximum versions

--stable-key <value> — Filter by stable source-asset key

Append a human approval decision to a source-asset version

Arguments

id required — Source-asset version UUID

Flags

--decision <approved|rejected|needs_changes> required

--reason <value> required

--yes — Confirm append-only review

Show one exact immutable source-asset version and its latest review

Arguments

id required — Source-asset version UUID

Create a research project and standard datasets

Arguments

name required — Research project name

Flags

--dry-run — Preview project/dataset creation without writing

--template <historical-research> default: "historical-research" — Research template

--yes — Confirm creation without prompting

Plan a deterministic research workflow before writing data

Arguments

goal required — Research goal

Flags

--project <value> — Existing project ID

--source-dataset <value> — Existing sources dataset ID

Create deterministic agent work for a research recipe

Arguments

recipe required — Research run recipe

Flags

--agent <value> default: "researcher" — Assigned agent alias

--context <value> — Additional input context JSON object

--context-file <value> — Additional input context JSON file

--dry-run — Preview work item payload without writing

--project <value> — Project ID

--source-dataset <value> — Source dataset ID

--yes — Confirm work item creation without prompting

Inspect research project context and CLI readiness

Arguments

project — Project ID

Install a Siftable skillpack into a local skills directory

Arguments

id required — Skillpack ID

Flags

--force — Replace an existing installed skill

--target <value> default: "skills" — Installed skills directory

-y, --yes — Confirm replacing an existing skill

List installable Siftable skillpacks

Preview or bulk-delete tasks

Flags

--confirm — Execute deletion instead of preview

--done — Filter by completed state

--ids <value> — Comma-separated task IDs

--phase <draft|open|in_flight|review|blocked|done|cancelled>

--title-contains <value> — Title substring filter

--title-equals <value> — Exact title filter

--title-starts-with <value> — Title prefix filter

--when <now|today|soon|later>

Mark a task as complete

Arguments

id required — Task ID

Create a CSN coupling edge between tasks in the same project

Arguments

id required — Source task ID

target required — Target task ID

Flags

--note <value> — Optional note

--strength <value> — Coupling strength (0-1)

--type <info|resource> required — Coupling type

Delete a CSN coupling edge from a task

Arguments

id required — Task ID

edgeId required — Coupling edge ID

Flags

-y, --yes — Skip confirmation

List CSN coupling edges for a task

Arguments

id required — Task ID

Create a human planning task

Flags

--acceptance-criteria <value> — Acceptance criteria (semicolon-separated text, e.g. "tests pass; docs updated")

--description <value> — Task description

--due <value> — Due date (ISO 8601)

--effort <trivial|small|medium|large|epic|unknown> — Effort estimate

--phase <draft|open|in_flight|review|blocked|done|cancelled> — Lifecycle phase

--priority <do_now|schedule|delegate|someday> — Priority level

--project <value> — Project ID

--scope <value> — Scope boundaries (JSON object with include/exclude arrays)

--title <value> required — Task title

Delete a task

Arguments

id required — Task ID

Flags

-y, --yes — Skip confirmation

Get human planning task details

Arguments

id required — Task ID

List human planning tasks

Flags

--cursor <value> — Continuation cursor from a previous page

--effort <trivial|small|medium|large|epic|unknown> — Filter by effort

--limit <value> default: 25 — Maximum number of results

--phase <draft|open|in_flight|review|blocked|done|cancelled> — Filter by phase

--project <value> — Filter by project ID

--status <inbox|next_action|in_progress|waiting_for|completed|archived> — Filter by status

--title-contains <value> — Title substring filter

--title-equals <value> — Exact title filter

--title-starts-with <value> — Title prefix filter

Update CSN planning fields for a task

Arguments

id required — Task ID

Flags

--cynefin-confidence <value> — Cynefin confidence (0-1)

--cynefin-domain <clear|complicated|complex|chaotic|aporetic> — Cynefin domain

--cynefin-rationale <value> — Why this domain fits

--cynefin-source <user|assistant|classifier> — Source of the planning classification

--duration-model <value> — Duration model JSON, e.g. {"kind":"point","days":2}

--reversibility <value> — Reversibility score (0-1)

Update a human planning task

Arguments

id required — Task ID

Flags

--acceptance-criteria <value> — Acceptance criteria (semicolon-separated text, e.g. "tests pass; docs updated")

--blocked-reason <value> — Reason task is blocked

--description <value> — Task description

--due <value> — Due date (ISO 8601)

--effort <trivial|small|medium|large|epic|unknown> — Effort estimate

--phase <draft|open|in_flight|review|blocked|done|cancelled> — Lifecycle phase

--priority <do_now|schedule|delegate|someday> — Priority level

--project <value> — Project ID

--scope <value> — Scope boundaries (JSON object with include/exclude arrays)

--status <inbox|next_action|in_progress|waiting_for|completed|archived> — Task status

--title <value> — Task title

Create a user-authored timeline fact

Flags

--body <value> — Fact body or notes

--confidence <low|medium|high> — Confidence level

--entity <value> repeatable — Participant/entity as type:uuid or type:uuid:role; repeatable

--fact-type <value> default: "event" — Fact type

--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era> default: "year" — Temporal precision

--source-label <value> — Source/provenance label

--source-note <value> — Source/provenance note

--source-url <value> — Source/provenance URL

--timestamp <value> — ISO timestamp

--title <value> required — Fact title

--visibility <org_public|private|restricted> — Timeline visibility

--year <value> — Historical year CE

--year-end <value> — Historical end year CE

Retract a timeline fact

Arguments

id required — Timeline fact ID

Flags

--yes — Confirm retraction without prompting

List timeline facts with bounded filters

Flags

--cursor <value> — Pagination cursor

--end <value> — End boundary, ISO timestamp or supported historical boundary

--entity <value> — Entity filter as type:uuid

--entity-role <value> — Comma-separated entity roles

--fact-types <value> — Comma-separated fact types

--limit <value> default: 50 — Maximum items to return

--order <asc|desc> default: "asc" — Sort order

--q <value> — Text search query

--source-types <value> — Comma-separated source types

--start <value> — Start boundary, ISO timestamp or supported historical boundary

Generate a narrative summary or explanation for timeline facts

Flags

--action <summarize|changed_since|led_to|what_next|cross_object> default: "summarize" — Narrative action

--entity <value> — Entity scope as type:uuid

--entity-roles <value> — Comma-separated entity roles

--fact-type <value> — Fact type filter

--limit <value> default: 60 — Maximum timeline facts to include

--participant <value> — Participant filter as type:uuid

--prompt <value> — Question or custom narrative prompt

--q <value> — Text query filter

--related-entity <value> — Related entity as type:uuid

--source-type <value> — Source type filter

List Vault audit events (requires vault:audit:read)

Flags

--limit <value> — Maximum number of results

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Store a new encrypted secret (requires vault:manage)

Flags

--category <value> — Category

--description <value> — Description

--name <value> required — Secret name

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--payload <value> required — JSON payload to encrypt

--slug <value> — Machine-friendly identifier

--tags <value> — Comma-separated tags

--type <env_var|credential|oauth_token|ssh_key|certificate|note> — Entry type

--url <value> — Associated URL

Clean one local lease artifact and attest confirmed, failed, or unknowable state

Arguments

id required

Flags

--checkout-root <value> — Git checkout used to prove runtime separation

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

List value-free environment lease and cleanup metadata

Flags

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Revoke future lease use, remove the local artifact when present, and attest cleanup

Arguments

id required

Flags

--checkout-root <value> — Git checkout used to prove runtime separation

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Inspect one value-free environment lease lifecycle

Arguments

id required

Flags

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

List vault entries (metadata only; requires vault:metadata:read)

Flags

--category <value> — Filter by category

--limit <value> — Maximum number of results

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--type <env_var|credential|oauth_token|ssh_key|certificate|note> — Filter by entry type

Pull one exact governed Vault bundle into a Sift-managed development environment file

Flags

--approval-timeout <value> default: 600

--checkout-root <value> — Checkout containing .sift/environment.yaml

--destination <value> — Exact relative destination when the manifest declares more than one bundle

--endpoint-class <development|production|ci|shared_host|policy_ineligible> required — Explicit endpoint policy class; managed pulls accept development only

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--purpose <value> required

--replace — Replace a changed Sift-managed file using its exact observed precondition

Request human approval for one destination-bound Vault materialization

Flags

--destination <value> required

--entry <value> required

--expected-digest <value>

--field <value> required

--materializer-digest <value> required

--mode <0400|0600> default: "0600"

--nonce <value> required

--overwrite

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--purpose <value> required

--runner-fingerprint <value> required

--runner-public-key <value> required

--tracked-exception

--workspace-root <value> — Absolute local workspace root containing the destination

Revoke a pending destination-bound Vault materialization

Arguments

id required — Materialization ID

Flags

--legacy-context — Use the Personal/v0 identity of a request created with the deprecated path-shaped --workspace alias

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Request approval, wait, and materialize one Vault field at the exact approved path

Flags

--approval-timeout <value> default: 600

--destination <value> required — Destination path; relative paths resolve inside --workspace-root before approval

--entry <value> required

--field <value> required

--mode <0400|0600> default: "0600"

--overwrite

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--purpose <value> required

--tracked-exception

--workspace-root <value> — Absolute local workspace root containing the destination

Inspect safe status for a destination-bound Vault materialization

Arguments

id required

Flags

--legacy-context — Use the Personal/v0 identity of a request created with the deprecated path-shaped --workspace alias

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Search Vault entry metadata (exact safe field names resolve during materialization; values are never returned)

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

Update vault entry metadata (requires vault:manage)

Arguments

id required — Vault entry ID

Flags

--category <value> — Category

--description <value> — Description

--name <value> — Entry name

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--tags <value> — Comma-separated tags

--url <value> — Associated URL

Create one exact short-lived environment bundle artifact outside the Git worktree

Flags

--approval-timeout <value> default: 600

--checkout-root <value> — Checkout containing .sift/environment.yaml

--consumer <value> required — Bound consumer identifier; not a command allowlist

--consumer-pid <value> — Optional already-running consumer process lifetime

--destination <value> — Manifest destination used only to select one exact bundle

--endpoint-class <development|production|ci|shared_host> required

--holder <value> — Bound holder identifier; defaults to the local runner fingerprint

--owner <value> — Exact Vault owner: personal or workspace:<tenant-id>

--purpose <value> required

--ttl <value> default: 300

Mark a work item as blocked

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Cancel queued/blocked work; active work requires --owner and --claim-token

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Claim the next available executable agent work item

Arguments

id — Optional specific work item ID

Flags

--agent <value> — Agent alias to claim for

--lease <value> default: 1800 — Lease seconds

--owner <value> required — Claim owner identity

Approve and complete an executable agent work item

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Deterministically validate a Work Contract V1 file or fetched work item

Arguments

id — Work item ID to fetch and validate

Flags

--file <value> — Path to a Work Contract V1 JSON file

Create an executable agent work item

Flags

--acceptance-criteria <value> — Acceptance criteria JSON array or semicolon-separated text

--agent <value> — Assigned agent alias

--allow-deploy — Allow deployment in the authored contract

--allow-migrate — Allow migrations in the authored contract

--allow-network — Allow network access in the authored contract

--allow-vault — Allow audited Vault access in the authored contract

--allowed-actions <value> — Allowed actions JSON object

--capture-applicability <conversational_capture_required|non_conversational|unclassified> — Prospective capture applicability; this does not determine study eligibility

--capture-receipt <value> repeatable — Finalized capture receipt UUID to bind atomically; repeat for multi-surface handoffs

--context <value> — Input context JSON object

--contract <value> — Complete Work Contract V1 JSON

--contract-file <value> — Path to a complete Work Contract V1 JSON file

--depends-on <value> — Dependency JSON array: [{"workItemId":"<uuid>","requiredGate"?:"done"|"commands_passed"}]

--dry-run — Preview the normalized payload and contract without creating work

--exclude-scope <value> repeatable — Excluded workspace-relative write scope; repeat for multiple paths

--profile <coding|read-only|read_only> — Author a complete Work Contract V1 using the coding or read-only profile

--project <value> — Linked project ID

--prompt <value> — Agent prompt or instructions

--rank <value> default: 0 — Queue rank

--scope <value> repeatable — Included workspace-relative write scope; repeat for multiple paths

--task <value> — Parent human planning task ID

--title <value> required — Executable work item title

--verify <value> — Verification commands separated by semicolons

--write-scope <value> — Write scope JSON object

Get authoritative dependencies and claimability for a work item

Arguments

id required — Work item UUID

Atomically replace the authoritative dependencies for a work item

Arguments

id required — Work item UUID

Flags

--depends-on <value> required — Dependency JSON array; pass [] to clear dependencies

Get a project default work-dependency gate

Flags

--project <value> required — Project UUID

Set a project default work-dependency gate

Flags

--gate <done|commands_passed> required — Default gate for dependencies that omit requiredGate

--project <value> required — Project UUID

C2: Revise queued, unclaimed work while preserving its UUID and dependency edges. Do not use after claim or execution; wait for a queued unclaimed state or create follow-up work. Example: raise queue rank or refine acceptance criteria while the item is queued and unclaimed. Counterexample: do not change status, dependencies, or an active worker lease with this capability. Execution-contract edits supersede the active verification plan and reset verification evidence; queue-rank-only edits do not. The same Idempotency-Key and payload replays the original receipt; a different payload with that key is rejected.

Arguments

id required — Work item ID

Flags

--acceptance-criteria <value> — Replacement acceptance criteria JSON array

--allowed-actions <value> — Replacement allowed actions JSON object

--context <value> — Replacement input context JSON object

--contract <value> — Replacement Work Contract V1 JSON

--contract-file <value> — Path to replacement Work Contract V1 JSON

--dry-run — Show normalized diff and proof consequences without mutating

--expected-revision <value> required — Observed work item revision

--idempotency-key <value> required — Stable retry key for this exact edit

--patch <value> — Editable fields as one JSON object

--patch-file <value> — Path to an editable-fields JSON object

--prompt <value> — Replacement prompt; use --patch for null

--rank <value> — Replacement queue rank

--reason <value> required — Auditable reason for the revision

--title <value> — Replacement title

--verify <value> — Replacement verification commands as JSON array or semicolon-separated text

--write-scope <value> — Replacement write scope JSON object

Mark a work item as failed

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Get executable agent work item details

Arguments

id required — Work item ID

Extend a work item lease

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

List executable agent work items

Flags

--agent <value> — Filter by assigned agent alias

--limit <value> — Maximum results

--project <value> — Filter by project ID

--status <value> — Filter by status

--task <value> — Filter by parent human planning task ID

Release a claimed work item back to the queue

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Return blocked work to the queue for a fresh claim

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Mark executable agent work as needing human review

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

List immutable, attributable work-item revision receipts and field diffs

Arguments

id required — Work item ID

Flags

--limit <value> default: 50 — Maximum revisions to return

Mark a work item as running

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim (required for lease-owned transitions)

--lease <value> — Lease seconds

--memory-decision <value> — Durable code-memory decision JSON (required on agent complete/review): {"decision":"store"|"skip","rationale":"...","fact"?,"category"?,"repositoryId"?,"filePath"?,"paths"?,"evidenceChunkIds"?,"sourceCommit"?,"confidence"?}

--owner <value> — Claim owner identity (required for lease-owned transitions)

--reason <value> — Block or failure reason

--summary <value> — Result summary

--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]

Submit externally executed evidence for an exact plan version and step ID

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact reference JSON array for larger logs

--attempt <value> required — Caller-stable attempt identity

--claim-owner <value> — Active lease owner for workspace-service evidence

--claim-token <value> — Opaque active lease token for workspace-service evidence

--environment <value> required — Execution environment label

--exit-code <value> — Process exit code when applicable

--outcome <passed|failed|error> required — Attempt outcome

--output <value> — Bounded output excerpt; secrets are redacted by the API

--plan-version <value> required — Active verification plan version

--provenance <value> — Evidence provenance JSON object

--ran-at <value> — RFC3339 execution timestamp

--step <value> required — Stable verification step UUID

List immutable verification-plan history and coverage

Arguments

id required — Work item ID

Show the active versioned verification plan and coverage

Arguments

id required — Work item ID

Create an audited active verification-plan revision

Arguments

id required — Work item ID

Flags

--expected-version <value> required — Observed active plan version

--provenance <value> — Revision provenance JSON object

--reason <value> required — Audited revision reason

--steps <value> — Verification step JSON array

--steps-file <value> — Path to a verification step JSON array

--yes — Confirm activation without prompting

Deprecated compatibility command. Hosted LLM verification is retired; use verification-command evidence.

Arguments

id required — Work item ID

Flags

--history — List historical verifier runs recorded before retirement

--model <value> — Deprecated; ignored because hosted verification is retired

--reps <value> — Deprecated; ignored because hosted verification is retired

Build a no-spend, surface-neutral plan for exactly two AWS agent workers

Flags

--max-runtime-minutes <value> default: 120 — Per-worker runtime ceiling

--source-sha <value> — Reviewed 40-character source Git SHA; defaults to a clean current HEAD

--surface <cli|t3|codex|claude-code|mcp> default: "cli" — Calling control surface; does not change dispatch identity

--work-item <value> required; repeatable — Queued Sift work-item UUID; repeat exactly twice

Claim executable work, run a local worker command, and report needs-review artifacts

Flags

--agent <value> required — Agent alias to claim work for

--command <value> required — Local command to run for the claimed work item

--cwd <value> — Fallback working directory for the local command

--lease <value> default: 1800 — Lease seconds

--owner <value> required — Worker owner fingerprint

Show the current Personal or collaborative workspace selection

List collaborative workspaces available to the authenticated user

Select a collaborative workspace for discovery, or Personal to clear it

Arguments

id required — Workspace ID, or "personal"