MCP Server, CLI & API Reference

顯示 Siftable CLI 嘅功能同埋就緒狀態

為代碼庫建立索引（掃描同埋上傳檔案）

Arguments

id — Repository ID

Flags

--exclude <value> — Comma-separated exclude glob patterns

--include <value> — Comma-separated include glob patterns

--incremental — Git-aware incremental index (changed files only)

--path <value> — Absolute path to repository root

顯示啱 Agent 用嘅指令主題同埋工作流入口

診斷本地 Siftable CLI 設定，唔會顯示敏感資料

啟動 Siftable 終端機副駕駛 (sift interactive) —— 一個喺進程入面幫你處理任務、工作、日曆、項目同人脈嘅 AI 助手。

喺終端機渲染 Mermaid 圖表（流程圖、時序圖、狀態圖、類別圖、ER、C4、架構圖、心智圖）。支援讀取 .mmd 檔案或 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)

建立 Agent 別名

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

停用 Agent 別名

Arguments

alias required — Agent alias or ID

獲取 Agent 別名

Arguments

alias required — Agent alias or ID

列出 Agent 別名

Flags

--include-disabled — Include disabled aliases

更新 Agent 別名

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

列出分配畀 Agent 別名嘅工作

Arguments

alias required — Agent alias or ID

Flags

--limit <value> — Maximum results

--status <value> — Work item status

喺 Siftable 進行認證

移除已儲存嘅認證

顯示認證狀態

建立日曆活動

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

刪除日曆活動

Arguments

id required — Event ID

Flags

-y, --yes — Skip confirmation

列出日曆活動

Flags

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

--limit <value> — Maximum number of results

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

更新日曆活動

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

查看檔案嘅 Git blame

Arguments

file required — Relative file path

Flags

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

更新儲存庫嘅開發者專長索引

Arguments

repo required — Repository ID

攞儲存庫嘅 commit 歷史

Arguments

repo required — Repository ID

Flags

--limit <value> — Maximum number of results

--path <value> — Filter by file path

將任務連結到代碼（檔案、commit 或儲存庫）

Arguments

task-id required — Task ID

Flags

--commit <value> — Commit SHA

--file <value> — File path

--notes <value> — Notes about the link

--repo <value> required — Repository ID

刪除已儲存嘅代碼庫資訊

Arguments

id required — Memory ID

Flags

-y, --yes — Skip confirmation

列出已儲存嘅代碼庫資訊

Flags

--limit <value> — Maximum number of results

--repo <value> — Repository ID

搜尋已儲存嘅代碼庫資料

Arguments

query required — Search query

Flags

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

--limit <value> — Maximum number of results

--repo <value> — Repository ID

儲存代碼庫資料

Flags

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

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

--file <value> — Related file path

--repo <value> — Repository ID

搵返熟嗰個代碼範疇嘅專家

Arguments

repo required — Repository ID

area required — Path, glob, or symbol

Flags

--limit <value> — Maximum number of results

刪除儲存庫同埋所有已索引嘅數據

Arguments

id required — Repository ID

Flags

-y, --yes — Skip confirmation

根據 git 識別到嘅變更檔案，進行增量索引

Arguments

id required — Repository ID

Flags

--exclude <value> — Comma-separated exclude glob patterns

--include <value> — Comma-separated include glob patterns

--path <value> required — Absolute path to repository root

列出已索引嘅儲存庫

註冊代碼庫嚟進行索引

Flags

--auto-index — Enable automatic indexing

--name <value> required — Repository name

--path <value> required — Absolute path to repository root

--project <value> — Project ID to associate

語義代碼搜尋

Arguments

query required — Search query

Flags

--language <value> — Filter by language

--limit <value> — Maximum number of results

--project <value> — Project ID

--repo <value> — Repository ID

--symbol-type <function|class|interface|type|export|impl> — Filter by symbol type

攞返儲存庫最新嘅索引快照

Arguments

id required — Repository ID

Flags

--branch <value> — Filter by branch

--materialize — Generate a download URL for the snapshot

檢查儲存庫嘅索引狀態

Arguments

id required — Repository ID

收集唯讀嘅 Siftable 同埋本地 git 上下文，用嚟做 Codex 每日工作回顧

Flags

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

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

--skip-git — Skip local git summary

新增紀錄到數據集

Arguments

id required — Dataset ID

Flags

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

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

用分組指標（數量、平均值、總和、最小值、最大值、中位數、標準差、百分位數、比例）嚟聚合數據集紀錄

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

為數據集生成有根據嘅自然語言分析

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

套用儲存咗嘅數據集 diff 計劃

Arguments

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

Flags

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

封存數據集，但唔會刪除佢嘅實體表

Arguments

id required — Dataset ID

Flags

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

將數字或日期欄位分做唔同範圍，並計算每個範圍嘅聚合指標

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

針對有生命週期標籤嘅臨時數據集，計劃或執行清理

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

並排比較分類欄位入面唔同部分嘅指標

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)

根據數據集或者之前嘅衍生結果，計算出衍生欄位

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

顯示 agent 睇得明嘅數據集 schema 同功能合約

Arguments

id required — Dataset ID

Flags

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

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

建立數據集

Flags

--description <value> — Dataset description

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

--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

喺唔改動數據嘅情況下，透過 key 搵出重複嘅資料集紀錄

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

永久刪除資料集同埋佢嘅實體表

Arguments

id required — Dataset ID

Flags

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

喺資料集刪除一條紀錄

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

-y, --yes — Skip confirmation

預覽 CSV、JSON 或 JSONL 檔案嘅資料集行數變更

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

列出已儲存嘅資料集差異計劃

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

顯示已儲存嘅資料集差異計劃

Arguments

id required — Diff plan ID

將特定範圍嘅資料集紀錄匯出成 CSV、JSON、JSONL 或 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

顯示資料集欄位嘅特定範圍分面摘要

Arguments

id required — Dataset ID

Flags

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

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

計算公式欄位，並預覽可供審核嘅資料集更新

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

獲取資料集詳情同埋 schema

Arguments

id required — Dataset ID

解釋數據集公式、圖表、視圖、品質同埋實體化嘅影響

Arguments

id required — Dataset ID

Flags

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

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

將 CSV、JSON 或者 JSONL 嘅資料行匯入去新或者現有嘅數據集

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

用 left.Close 同 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

列出數據集

Flags

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

透過精確鍵值配對嚟查找數據集紀錄

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

將衍生結果實體化做一個新嘅臨時數據集

Flags

--description <value> — Dataset description

--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

根據分組數據集指標建立樞紐分析式摘要

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

驗證同埋標準化嚟自衍生結果嘅輕量化圖表數據

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

顯示數據集嘅受限分析資訊

Arguments

id required — Dataset ID

Flags

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

查詢數據集入面嘅紀錄

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"}]'

根據排序或者加權數字公式幫數據集紀錄排名

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

根據 key 比較兩個數據集，唔會改動任何一邊

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

修改數據集 schema（新增、更新或者刪除欄位）

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)

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

喺指定嘅文字欄位入面搜尋數據集紀錄

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

攞數據集摘要（行數、欄位、樣本行）

Arguments

id required — Dataset ID

列出內置數據集範本

顯示內置數據集範本嘅 schema

Arguments

template required — Template name

用 lag、pct_change、rolling windows、drawdown、volatility 同 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

更新數據集入面嘅紀錄

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

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

用內置範本嚟驗證數據集

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

將文件（PDF、Markdown 或者純文字）上傳做筆記

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

將參與者加落去現有嘅研究事件入面

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

建立一個有參與者嘅研究事件時間線事實

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

列出研究事件時間線嘅事實資料

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

套用已審核嘅 Evidence Graph 差異計劃

Arguments

id required — Persisted diff plan ID

Flags

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

解釋已儲存差異計劃對 Evidence Graph 嘅影響

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

列出已儲存嘅 Evidence Graph 差異計劃

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

顯示 Evidence Graph 差異計劃同埋具備領域知識嘅摘要

Arguments

id required — Persisted diff plan ID

建立唔使套用嘅 Agent 工作，用嚟提取 Evidence Graph 候選資料

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

建立 Evidence Graph 項目同埋以數據集為基礎嘅工作表

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

喺寫入受信任狀態之前，先計劃 Evidence Graph 工作流

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

試行 Evidence Graph 時間線同埋關係投影

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

由數據集支援嘅證據包生成 Evidence Graph 證明報告

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

將 Evidence Graph 來源分類帳嘅資料行匯入數據集支援嘅來源表

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

驗證 Evidence Graph 嘅出處、評論、投影同埋引用不變量

Flags

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

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

解釋兩個實體之間嘅有界圖路徑

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

解釋兩個實體之間嘅有界圖路徑

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

顯示某個實體喺圖入面嘅鄰近節點

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

預覽單個圖譜實體

Arguments

entity required — Entity reference as type:uuid

搜尋可用嚟連結嘅圖譜實體

Arguments

query required — Search query

Flags

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

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

預覽或者批量刪除筆記

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>

建立筆記

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

刪除筆記

Arguments

id required — Note ID

Flags

-y, --yes — Skip confirmation

獲取筆記完整內容

Arguments

id required — Note ID

列出筆記

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

搜尋筆記

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

更新筆記

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

預覽或批量刪除組織

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

建立組織

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

刪除組織

Arguments

id required — Organization ID

Flags

-y, --yes — Skip confirmation

搜尋組織

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

更新組織

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

預覽或者批量刪除聯絡人

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

建立聯絡人

Flags

--birth-year <value> — Birth year

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

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

--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

刪除聯絡人

Arguments

id required — Person ID

Flags

-y, --yes — Skip confirmation

獲取個人檔案，包括特徵同關係

Arguments

id required — Person ID

顯示以人為中心嘅關係圖

Arguments

id required — Person ID

Flags

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

--include-inactive — Include inactive relationship edges

解釋兩個人之間嘅親屬關係或者關係距離

Arguments

egoPersonId required — Ego/source person ID

targetPersonId required — Target person ID

Flags

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

列出聯絡人

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

建立或者更新兩個人之間嘅關係

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

搜尋聯絡人

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

列出同某人有關嘅時間線紀錄

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

更新聯絡人

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

封存項目

Arguments

id required — Project ID

Flags

-y, --yes — Skip confirmation

獲取項目背景資訊（任務、筆記、訊號）

Arguments

id required — Project ID

建立項目

Flags

--emoji <value> — Single emoji

--name <value> required — Project name

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

--summary <value> — Project summary

列出項目

Flags

--include-archived — Include archived projects

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

獲取項目嘅標準 CSN 計劃快照

Arguments

id required — Project ID

重新計算項目嘅標準 CSN 計劃快照

Arguments

id required — Project ID

更新項目

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

列出內置嘅研究工作流食譜

顯示內置嘅研究工作流食譜

Arguments

id required — Recipe ID

建立研究項目同埋標準數據集

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

喺寫入數據之前，先計劃好確定性嘅研究工作流

Arguments

goal required — Research goal

Flags

--project <value> — Existing project ID

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

為研究方案建立確定性嘅 agent 工作

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

檢查研究項目嘅 context 同埋 CLI 準備狀況

Arguments

project — Project ID

將 Siftable skillpack 安裝到本地嘅 skills 目錄

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

列出可以安裝嘅 Siftable skillpack

預覽或者批量刪除任務

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>

將任務標記為已完成

Arguments

id required — Task ID

喺同一個項目入面嘅任務之間建立 CSN coupling edge

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

喺任務度刪除 CSN coupling edge

Arguments

id required — Task ID

edgeId required — Coupling edge ID

Flags

-y, --yes — Skip confirmation

列出任務嘅 CSN 耦合邊緣

Arguments

id required — Task ID

建立人類計劃任務

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

刪除任務

Arguments

id required — Task ID

Flags

-y, --yes — Skip confirmation

獲取人類計劃任務詳情

Arguments

id required — Task ID

列出人類計劃任務

Flags

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

--limit <value> — 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

更新任務嘅 CSN 計劃欄位

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)

更新人類計劃任務

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

建立用戶編寫嘅時間線事實

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

撤回時間線事實

Arguments

id required — Timeline fact ID

Flags

--yes — Confirm retraction without prompting

用範圍過濾器列出時間線事實

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

為時間線事實生成敘述摘要或者解釋

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

儲存新嘅加密秘密

Flags

--category <value> — Category

--description <value> — Description

--name <value> required — Secret name

--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

列出保險庫紀錄（只限 metadata）

Flags

--category <value> — Filter by category

--limit <value> — Maximum number of results

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

Retired: Vault plaintext reveal is unavailable from the CLI

Arguments

id required — Vault entry ID

搜尋保險庫項目

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

更新保險庫項目嘅元數據

Arguments

id required — Vault entry ID

Flags

--category <value> — Category

--description <value> — Description

--name <value> — Entry name

--tags <value> — Comma-separated tags

--url <value> — Associated URL

將工作項目標示為受阻

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

取消工作項目

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

領取下一個可用嘅可執行代理工作項目

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

核准並完成可執行代理工作項目

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

建立可執行代理工作項目

Flags

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

--agent <value> — Assigned agent alias

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

--context <value> — Input context JSON object

--project <value> — Linked project ID

--prompt <value> — Agent prompt or instructions

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

--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

將工作項目標記做失敗

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

攞執行代理工作項目嘅詳情

Arguments

id required — Work item ID

延長工作項目租約

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

列出執行代理工作項目

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

將攞咗嘅工作項目放返入隊列

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

將執行代理工作標記做需要人工審核

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

將工作項目標記做執行中

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

--claim-token <value> — Claim token returned by work claim

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

Run the LLM verifier against a work item's acceptance criteria and record a verifier run. Promotion to verified requires passing verification-command evidence plus a verified verdict.

Arguments

id required — Work item ID

Flags

--history — List prior verifier runs instead of running a new one

--model <value> — Verifier model override

--reps <value> — Repeated evaluations per criterion (1-8, default 3)

領取可執行工作，執行本地 worker 指令，同埋回報需要審核嘅產出

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