MCP Server, CLI & API Reference
Connect any MCP-compatible agent — or use the CLI directly from your terminal. One platform, two interfaces, 60+ tools across every domain in the workspace.
Início Rápido
O MCP hospedado usa OAuth sobre Streamable HTTP. Comece com a URL do Siftable; não é necessário copiar e colar tokens.
1. Adicione a URL do MCP hospedado
Adicione https://siftable.io/api/v1/mcp como um conector ou servidor MCP remoto. Não use o endpoint /sse descontinuado.
2. Conclua o OAuth
Escolha Connect, Authenticate ou Login em seu cliente e aprove o acesso na tela de consentimento do Siftable. Não adicione um cabeçalho Authorization a esta configuração.
{ "mcpServers": { "siftable": { "type": "http", "url": "https://siftable.io/api/v1/mcp" } } }
3. Verifique a conexão
Chame context_current, depois liste um projeto ou tarefa. Use find_capability quando precisar de outra ação.
# Agent calls: project_list() task_list(status: "in_progress") calendar_list_events(startDate: "2026-02-17", endDate: "2026-02-23") # Agent now has your full operational context.
CLI Installation
A CLI do Siftable oferece a superfície completa de comandos do terminal, além de um copiloto interativo. Ela usa os mesmos registros do MCP hospedado, com autenticação específica de CLI e recursos locais. O binário é instalado como sift (com siftable e o alias de compatibilidade exf).
1. Install
npm install -g @siftable/cli # npm bun install -g @siftable/cli # bun pnpm add -g @siftable/cli # pnpm # or run without installing npx @siftable/cli <command>
2. Authenticate
The CLI uses device flow authentication — it opens your browser, you approve, and a token is stored locally.
$ sift auth login
Your verification code: ZFMV-SBGJ
Opening browser...
If the browser didn't open, visit: https://siftable.io/app/device?code=ZFMV-SBGJ
Waiting for authorization...
Logged in successfully!
3. Run your first command
$ sift projects list NAME STATUS TASKS Siftable active 12 Marketing Site active 4 Mobile App planning 0 $ sift projects context <id> # Full project context: tasks, signals, notes, members.
Every CLI command supports --json for machine-readable output. Pipe it into jq, feed it to scripts, or let agents parse it directly.
Autenticação
Use OAuth para MCP hospedado, o fluxo de dispositivo para sessões interativas da CLI e Personal Access Tokens para automação não interativa ou clientes MCP locais.
Fluxo de Dispositivo (CLI)
Execute sift auth login. A CLI abre seu navegador, você faz login com o Google e aprova o código do dispositivo. Um PAT é gerado e armazenado em ~/.config/siftable/ automaticamente. Sem token para copiar e colar.
Personal Access Token (automação e MCP local)
Para automação não interativa ou um cliente MCP local, crie um token em Configurações → Integrações → Desenvolvedor / Clientes de IA e envie-o no cabeçalho Authorization. Tokens estáticos não podem usar elevação de escopo OAuth.
Authorization: Bearer sift_pat_your_token_here
Os tokens são limitados a domínios específicos (apenas tarefas, apenas calendário, acesso total, etc.). Para pipelines de CI, defina SIFT_TOKEN como uma variável de ambiente.
$ sift auth login $ sift auth status $ sift auth logout
Os escopos dos tokens e as operações de escrita disponíveis dependem da configuração e do plano do seu espaço de trabalho. Verifique Configurações → Integrações → Clientes de Desenvolvedor / IA e Preços para consultar os limites atuais da sua conta.
Conexão MCP
O MCP hospedado do Siftable usa Streamable HTTP com OAuth. O endpoint é:
https://siftable.io/api/v1/mcp
Use esta URL com clientes remotos compatíveis com OAuth, incluindo ChatGPT, Codex, Cursor, Claude, Grok e implementações de SDK do MCP compatíveis. O guia de configuração do MCP hospedado tem etapas específicas para cada cliente.
Tarefas
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| task_list | sift tasks list |
READ | List tasks with filters: status (inbox, next_action, in_progress, waiting_for, completed, archived), phase, project, limit. |
| task_get | sift tasks get |
READ | Get a single task with full details: description, due date, priority, project, linked code. |
| task_create | sift tasks create |
WRITE | Create a task. Accepts title, description, priority (do_now, schedule, delegate, someday), project, due date. |
| task_update | sift tasks update |
WRITE | Update task fields: title, description, status, priority, due date, project assignment. |
| task_complete | sift tasks complete |
WRITE | Mark a task as completed. |
| task_delete | sift tasks delete |
DELETE | Permanently delete a task. |
$ sift tasks list --status in_progress TITLE STATUS PRIORITY DUE Ship CLI docs in_progress do_now 2026-02-27 Fix device flow auth in_progress do_now - $ sift tasks create --title "Review PR #312" --priority do_now --json {"id":"abc-123","title":"Review PR #312","status":"inbox","priority":"do_now"}
Agenda
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| calendar_list_events | sift calendar list |
READ | List events in a date range. Returns title, start/end times, location, description. Supports limit. |
| calendar_create_event | sift calendar create |
WRITE | Create a calendar event. Requires title, startTime, endTime (ISO 8601). Optional: description, location. |
| calendar_update_event | sift calendar update |
WRITE | Update an existing event's title, times, description, or location. |
| calendar_delete_event | sift calendar delete |
DELETE | Remove an event from the calendar. |
$ sift calendar list --start 2026-02-24 --end 2026-02-28 TITLE START END LOCATION Team standup Feb 25 09:00 Feb 25 09:30 Zoom Product review Feb 26 14:00 Feb 26 15:00 Conf Room B $ sift calendar create --title "Ship CLI v0.3" \ --start 2026-02-27T10:00:00Z --end 2026-02-27T10:30:00Z
Projetos
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| project_list | sift projects list |
READ | List projects. Filter by status (planning, active, on_hold, blocked, completed). Include archived. |
| project_get_context | sift projects context |
READ | Full project context: tasks, notes, members, signals. The richest single call for understanding a project. |
| project_create | sift projects create |
WRITE | Create a project with name, summary, status, and emoji. |
| project_update | sift projects update |
WRITE | Update project name, summary, status, or emoji. |
| project_archive | sift projects archive |
WRITE | Archive a completed or inactive project. |
Conhecimento
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| note_search | sift notes search |
READ | Semantic + full-text search across notes. Filter by project. |
| note_list | sift notes list |
READ | List notes. Filter by type (note, concept, meeting, reference, daily, dataset) and project. |
| note_get | sift notes get |
READ | Get full note content by ID. |
| note_create | sift notes create |
WRITE | Create a note with title, markdown content, type, and optional project. |
| note_update | sift notes update |
WRITE | Update note title, content, or type. |
| note_delete | sift notes delete |
DELETE | Delete a note. |
Datasets
Structured datasets support grounded summaries, grouped analysis, ranking, bucketing, time-series work, import/export, schema changes, and record mutations from the same CLI and MCP-backed platform.
| Capability | CLI | Access | Description |
|---|---|---|---|
| Browse and inspect | sift datasets list, get, query, summarize |
READ | List datasets, inspect schema, query records, and get row-count and sample summaries. |
| Grounded analysis | sift datasets analyze, aggregate, compare |
READ | Generate natural-language insights, grouped metrics, and side-by-side segment comparisons. |
| Ranking and bucketing | sift datasets rank, bucket |
READ | Sort or score records, then bucket numeric or date fields into ranges with metrics per bucket. |
| Time series and plots | sift datasets timeseries, plot |
READ | Compute lag, pct-change, rolling windows, drawdown, or normalize plotting payloads from derived results. |
| Import and export | sift datasets import, export |
WRITE | Bring CSVs in, append to existing datasets, or export filtered results back to CSV. |
| Create and materialize | sift datasets create, materialize |
WRITE | Create datasets directly or turn a derived result into a new scratch dataset. |
| Schema and records | sift datasets schema, add, update-record, delete-record |
WRITE | Modify field definitions, add rows, update rows, and delete rows with explicit commands. |
| Derived workflows | sift datasets join, compute |
READ | Join dataset slices and compute derived fields before materializing or plotting the result. |
$ sift datasets list $ sift datasets summarize <dataset-id> $ sift datasets analyze <dataset-id> --focus-fields BMI,Outcome $ sift datasets aggregate <dataset-id> --group-by Outcome \ --metrics '[{"operation":"count","as":"rows"},{"operation":"avg","field":"BMI","as":"avg_bmi"}]' $ sift datasets compare <dataset-id> --segment-field Outcome \ --metrics '[{"operation":"avg","field":"Glucose","as":"avg_glucose"}]' $ sift datasets rank <dataset-id> --sorts '[{"field":"BMI","direction":"desc"}]' --limit 10 $ sift datasets bucket <dataset-id> --field Age --bucket-count 5 \ --metrics '[{"operation":"count","as":"rows"}]'
Pessoas
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| people_search | sift people search |
READ | Search contacts by name. Returns relationship type, company, contact info, interaction history. |
| — | sift people list |
READ | List all contacts. CLI-only convenience wrapper. |
| person_create | sift people create |
WRITE | Create a contact with name, relationship, company, and contact details. |
| person_update | sift people update |
WRITE | Update a contact's details, relationship, or company. |
| person_delete | sift people delete |
DELETE | Delete a contact. |
Memória de Código
Armazene e recupere fatos curados sobre sua base de código. Inspecione o código-fonte localmente com Git, rg ou seu editor; o Siftable não hospeda indexação nem pesquisa de código-fonte.
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| code_memory_store | sift code memory store |
WRITE | Store a fact. Categories: architecture, integration, convention, entrypoint, gotcha, ownership. Optional: file path, repository. |
| code_memory_search | sift code memory search |
READ | Semantic search over stored code facts. Filter by category or repository. |
| code_memory_list | sift code memory list |
READ | List all stored code memories. Filter by repository. |
| code_memory_delete | sift code memory delete |
DELETE | Delete a stored code memory by ID. |
Documentos
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| upload_document | sift documents upload |
WRITE | Upload a PDF, Markdown, or text file into Knowledge. Set by file path or inline content. Auto-detects type. |
Vault
Encrypted secret storage. Store API keys, credentials, OAuth tokens, SSH keys, and sensitive notes. Values are encrypted at rest and audit-logged on read.
| MCP Tool | CLI | Access | Description |
|---|---|---|---|
| vault_create | sift vault create |
WRITE | Store a new encrypted secret. Types: env_var, credential, oauth_token, ssh_key, certificate, note. |
| vault_list | sift vault list |
READ | List vault entries (metadata only — never decrypted values). Filter by type or category. |
| vault_search | sift vault search |
READ | Search vault entries by name, slug, or description. Returns metadata only. |
| vault_update | sift vault update |
WRITE | Update vault entry metadata: name, tags, category, description. |
$ sift vault create --name "Stripe API Key" --json # Interactive prompt for sensitive payload values $ sift vault list NAME TYPE CATEGORY CREATED Stripe API Key env_var payments 2026-02-25 GitHub PAT credential devtools 2026-02-20 $ sift vault materialize run --help # Approved plaintext goes only to the exact local destination. $ sift env pull --help # Pull an approved .sift/environment.yaml bundle.
Workflows
Cross-domain recipes that combine multiple tools. These patterns work identically via MCP or CLI.
Link Code to Tasks
Connect implementation work to the task that motivated it. Agents and teammates can trace why code changed.
task_create(title: "Implement device flow auth", priority: "do_now")
# ... implement the feature ...
task_link_code(taskId: "abc-123", repositoryId: "repo-456",
commitSha: "5cf5f22", filePath: "src/services/deviceAuthService.ts",
notes: "Fixed verification_uri to use /app/device")
task_complete(taskId: "abc-123")
$ sift tasks create --title "Implement device flow auth" --priority do_now $ sift code link abc-123 --repo repo-456 \ --commit 5cf5f22 --file src/services/deviceAuthService.ts $ sift tasks complete abc-123
Project Onboarding
New to a project? Pull the full context in three commands.
# 1. Get the big picture $ sift projects context <id> # 2. See what's in flight $ sift tasks list --project <id> --status in_progress # 3. Check code conventions $ sift code memory search "architecture and conventions"
End-of-Day Review
Summarize what happened today. Works great as an agent prompt or a manual check.
# Agent calls: calendar_list_events(startDate: "2026-02-26", endDate: "2026-02-26") task_list(status: "completed", limit: 20) task_list(status: "in_progress") # Agent now has: today's meetings, completed tasks, and remaining work. # It can draft a standup summary, update project status, or flag blockers.
$ sift calendar list --start 2026-02-26 --end 2026-02-26 $ sift tasks list --status completed --limit 20 --json | jq '.tasks[] | .title' $ sift tasks list --status in_progress
Store a Debug Discovery
Found a gotcha? Store it so your future self (or your agent) doesn't rediscover it the hard way.
$ sift code memory store \ --fact "Device flow verification_uri must use /app/device (SPA path), not /device (marketing homepage)" \ --category gotcha \ --file src/services/deviceAuthService.ts
Idempotência
Operações de escrita (task_create, note_create, calendar_create_event, etc.) aceitam um parâmetro opcional idempotencyKey. Se você repetir uma requisição com a mesma chave, Siftable retorna o resultado original em vez de criar uma duplicata.
task_create(
title: "Review PR #247",
priority: "do_now",
idempotencyKey: "agent-run-42-task-pr247"
)
# Safe to retry. Same key = same result.
Permissões
Tokens são escopados por domínio. Um token só-agenda não pode ler tarefas ou pessoas. Escope seus tokens com o mínimo de acesso que seu agente precisa.
Escopos disponíveis:
tasks:read/tasks:write— Task listing, CRUD, and completioncalendar:read/calendar:write— Event listing and creationprojects:read/projects:write— Project management and contextknowledge:read/knowledge:write— Notes, search, document uploadpeople:read/people:write— Contact search and CRM updateswork:read/work:write— Agent work queue itemsorg:read— Workspace org metadatamcp:*— All MCP operations (recommended for IDE and agent use)
As operações de gravação disponíveis dependem do escopo do seu token e do plano atual do workspace. Verifique o token que você emitiu e a página de preços atual antes de depender de gravações em produção.
Referência de comandos da CLI
All 169 commands from @siftable/cli@0.5.29, generated from the oclif manifest so this page cannot drift from sift --help. Every command also accepts the global flags (--json, --token, --api-url, --workspace, --no-input).
Todos os comandos também aceitam as flags globais: --json (saída em JSON puro), --token / SIFT_TOKEN, --api-url / SIFT_API_URL (padrão: https://siftable.io), --workspace / SIFT_WORKSPACE_ID e --no-input (desativa prompts). Comandos destrutivos exigem --confirm ou -y.
Geral
Comandos principais e diagnósticos.
5 comandos
sift capabilitiesMostre as capacidades e o status de prontidão da CLI do Siftable
sift commandsMostre tópicos de comando e pontos de entrada de fluxo para agentes
sift doctorDiagnostica a configuração local da CLI do Siftable sem exibir segredos
sift interactiveInicia o copilot de terminal do Siftable (sift interactive) — um assistente de AI integrado para suas tarefas, trabalho, calendário, projetos e pessoas.
- Flags
--connected-models— List eligible connected models and exit--connection <value>— Select a Model Connection UUID for a gateway invocation--max-output-tokens <value>— Maximum connected-model output tokens (1-32768)--model <value>— Select an eligible connected model for a gateway invocation--prompt <value>— Invoke the selected connected model once and exit--stream— Consume selected connected-model output incrementally
sift mermaidRenderiza um diagrama Mermaid no terminal (fluxograma, sequência, estado, classe, ER, C4, arquitetura, mapa mental). Lê um arquivo .mmd ou 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>— 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>— 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)
Agentes
Aliases de agentes.
6 comandos
sift agents createCriar um alias de agente
- Flags
--alias <value>— 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>— Agent type
sift agents disableDesativar um alias de agente
- Arguments
aliasrequired — Agent alias or ID
sift agents getObter um alias de agente
- Arguments
aliasrequired — Agent alias or ID
sift agents listListar aliases de agentes
- Flags
--include-disabled— Include disabled aliases
sift agents updateAtualizar um alias de agente
- Arguments
aliasrequired — 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
sift agents workListar trabalho atribuído a um alias
- Arguments
aliasrequired — Agent alias or ID- Flags
--limit <value>— Maximum results--status <value>— Work item status
Ai
5 commands
sift ai connectShow the secure browser flow for adding a non-exportable Model Connection
- Flags
--url <value>— Siftable Model Connections settings URL
sift ai invokeInvoke an eligible connected model (requires ai:invoke and ai:connections:use)
- Flags
--connection <value>— Model Connection UUID returned by sift ai list--max-output-tokens <value>— Maximum output tokens (1-32768)--model <value>— Eligible model ID returned by sift ai list--prompt <value>— Prompt text--stream— Consume and print incremental connected-model output
sift ai listList eligible connected models (requires ai:models:read)
sift ai statusShow non-secret Model Connection status (requires ai:connections:use)
- Arguments
connection— Optional Model Connection UUID
sift ai usageShow connected-model usage totals (requires ai:usage:read)
- Flags
--from <value>— ISO-8601 period start--to <value>— ISO-8601 period end
Approvals
2 commands
sift approvals requestRequest a governed action approval; this command cannot approve or consume it
- Flags
--action <value>— Governed action identifier--destination <value>— Destination binding JSON object--expires-in <value>— Approval lifetime in seconds (30-600)--operation <value>— Operation identifier--purpose <value>— Human-readable non-secret purpose--resource-id <value>— Resource identifier--resource-type <value>— Resource type identifier
sift approvals statusInspect a governed approval requested by this CLI identity
- Arguments
idrequired — Approval ID
Autenticação
Comandos de autenticação.
3 comandos
sift auth loginAutenticar no Siftable
- Flags
--scope <ai:models:read|ai:invoke|ai:usage:read|ai:connections:use|vault:metadata:read|vault:manage|vault:audit:read>— Incremental AI invocation or Vault scope to request (repeatable; management AI scopes and plaintext reveal are unavailable)
sift auth logoutRemover a autenticação salva
sift auth statusMostrar o status da autenticação
Billing
4 commands
sift billing fallback decideAllow, deny, or always allow personal funding for a quoted workspace operation
- Flags
--decision <allow|deny|always_allow>--monthly-cap-micros <value>— Monthly micro-USD cap for always_allow--quote <value>— Server-issued operation quote ID
sift billing fallback policyRead or update the workspace personal-fallback policy
- Flags
--disabled— Disable and revoke personal fallback--enabled— Enable personal fallback
sift billing fallback revokeRevoke one of your active personal-fallback consents
- Arguments
consentIdrequired
sift billing fallback statusShow your active personal-fallback decisions for a workspace
Calendário
Eventos do calendário.
4 comandos
sift calendar createCriar um evento no calendário
- 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
sift calendar deleteExcluir um evento do calendário
- Arguments
idrequired — Event ID- Flags
-y, --yes— Skip confirmation
sift calendar listListar eventos do calendário
- Flags
--end <value>— End date (ISO 8601)--limit <value>— Maximum number of results--start <value>— Start date (ISO 8601)
sift calendar updateAtualizar um evento do calendário
- Arguments
idrequired — 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
Capabilities
5 commands
sift capabilities createCreate a reviewed server-brokered Vault capability
- Flags
--adapter <value>— Reviewed static adapter ID--expires-in <value>— Lifetime in seconds (300-2592000)--field <value>— Credential payload field--operation <value>— Comma-separated allowlisted operations--provider <value>— Provider ID--purpose <value>— Non-secret human-readable purpose--vault-entry <value>— Vault entry UUID
sift capabilities describeDescribe safe metadata for one Vault capability
- Arguments
idrequired — Capability metadata ID
sift capabilities executeExecute one typed operation through a Vault capability handle
- Flags
--approval <value>— Governed approval UUID when required--handle <value>— Opaque vcap_ capability handle--idempotency-key <value>— Stable 8-128 character key for safe retries--input <value>— Typed operation input JSON object--operation <value>— Allowlisted operation
sift capabilities listList safe metadata for Vault capability handles
sift capabilities revokeRevoke a Vault capability
- Arguments
idrequired — Capability metadata ID
Código
Ferramentas de código.
13 comandos
sift code blameVer o git blame de um arquivo
- Arguments
filerequired — Relative file path- Flags
--root <value>— Repository root path
sift code memory confirmConfirma um candidato a memória de código com um motivo auditável
- Arguments
idrequired — Memory ID- Flags
--reason <value>— Audit reason
sift code memory deleteExcluir um fato salvo da base de código
- Arguments
idrequired — Memory ID- Flags
-y, --yes— Skip confirmation
sift code memory detect-staleDetecta memórias de código provavelmente desatualizadas e as marca como needs_review (nunca exclui)
- Flags
--limit <value>— Maximum memories to scan--repo <value>— Repository ID
sift code memory editEdita uma memória de código no local; o conteúdo anterior permanece no registro de auditoria
- Arguments
idrequired — Memory ID- Flags
--confidence <value>— Confidence 0-1--fact <value>— Updated fact--reason <value>— Audit reason
sift code memory eventsLista os eventos de curadoria/linhagem (somente adição) de uma memória de código
- Arguments
idrequired — Memory ID- Flags
--limit <value>— Maximum number of events
sift code memory getMostra uma memória de código com procedência, evidências e ciclo de vida
- Arguments
idrequired — Memory ID
sift code memory listListar fatos salvos da base de código
- 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
sift code memory needs-reviewMarca uma memória de código como needs_review por provável desatualização/contradição (nunca exclui)
- Arguments
idrequired — Memory ID- Flags
--reason <value>— Audit reason--signal <value>— Staleness signal (repeatable)
sift code memory rejectRejeita uma memória de código com um motivo auditável (rejeição leve; nunca exclui)
- Arguments
idrequired — Memory ID- Flags
--reason <value>— Audit reason
sift code memory searchPesquise fatos da base de código
- Arguments
queryrequired — 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
sift code memory storeArmazene um fato da base de código
- Flags
--agent <value>— Authoring agent (marks memory as agent-authored)--category <architecture|integration|convention|entrypoint|gotcha|ownership>— Fact category--commit <value>— Source commit SHA--confidence <value>— Confidence 0-1--evidence-chunk <value>— Historical indexed chunk ID supporting the fact--fact <value>— Fact to store (1-2 sentences)--file <value>— Related file path--path <value>— Additional related path (repeatable)--reason <value>— Capture reason (required with --agent)--repo <value>— Repository ID--work-item <value>— Related agent work item ID
sift code memory supersedeSubstitui uma memória de código por um novo fato; a memória antiga é mantida como linhagem
- Arguments
idrequired — 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>— Evidence chunk ID (repeatable)--fact <value>— Replacement fact--file <value>— Related file path--path <value>— Additional related path (repeatable)--reason <value>— Audit reason
Codex
Utilitários de automação do Codex.
1 comando
sift codex daily-review collectColetar contexto do Siftable (somente leitura) e git local para revisões diárias do Codex
- Flags
--calendar-days <value>— Calendar lookahead days--limit <value>— Maximum records per source--skip-git— Skip local git summary
Contexto
1 comando
sift context currentExplica o contexto do principal, proprietário, projeto e checkout local
- Flags
--workspace-root <value>— Absolute local checkout root to describe (never sent as a workspace tenant ID)
CRM
6 comandos
sift crm import applyAplica apenas as operações aprovadas de um plano de importação de CRM existente; a reexecução é segura.
- Arguments
planIdrequired — Durable CRM import plan UUID- Flags
--yes— Confirm canonical CRM writes without prompting
sift crm import approveAprova todas as operações pendentes ou uma seleção delas em um plano de importação de CRM existente.
- Arguments
planIdrequired — Durable CRM import plan UUID- Flags
--operation-id <value>— Stable operation ID to approve; repeat to approve a subset--reason <value>— Human approval reason recorded on the plan--yes— Confirm the approval without prompting
sift crm import getRetoma e inspeciona um plano de importação de CRM durável pelo ID estável do plano.
- Arguments
planIdrequired — Durable CRM import plan UUID
sift crm import planCria ou reutiliza um plano de importação de CRM durável a partir de um arquivo CSV, TSV, XLS ou XLSX sem gravar registros canônicos no CRM.
- Arguments
filerequired — Local CSV, TSV, XLS, or XLSX source (8 MiB maximum)- Flags
--mapping-mode <manual|workspace_auto>— Manual mapping or approved workspace mapping profile--provider <generic|salesforce>— Source provider mapping
sift crm organizations convertExplica o limite governado entre uma organização de CRM e um workspace
- Arguments
idrequired — CRM organization ID
sift crm organizations listLista apenas organizações de CRM; workspaces colaborativos são excluídos
- Flags
--limit <value>— Maximum number of CRM results--search <value>— Optional fuzzy search query
Datasets
Datasets estruturados.
43 comandos
sift datasets addAdicionar registros a um dataset
- Arguments
idrequired — Dataset ID- Flags
--idempotency-key <value>— Caller-owned stable key for replaying this exact dataset mutation--record <value>— Record as JSON object, e.g. '{"name":"Alice","age":"30"}'--records <value>— Multiple records as JSON array
sift datasets aggregateAgregar registros de um dataset com métricas agrupadas (count, avg, sum, min, max, median, stddev, percentile, ratio)
- Arguments
idrequired — 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>— Max rows--metrics <value>— JSON array of metrics [{operation, field, as}]--sorts <value>— JSON array of sorts
sift datasets analyzeGere insights fundamentados em linguagem natural para um conjunto de dados
- Arguments
idrequired — Dataset ID- Flags
--filters <value>— JSON array of filters--focus-fields <value>— Comma-separated field names to focus analysis on--max-insights <value>— Max insights to generate--mode <descriptive|operational>— Analysis mode--signal-limit <value>— Max decision signals to return
sift datasets apply-diffAplique um plano de diff salvo para um conjunto de dados
- Arguments
planrequired — Path to a local diff plan or persisted diff plan ID- Flags
--yes— Confirm applying the saved diff plan without prompting
sift datasets archiveArquive um conjunto de dados sem excluir a tabela física
- Arguments
idrequired — Dataset ID- Flags
-y, --yes— Confirm dataset archival without prompting
sift datasets bucketAgrupe campos numéricos ou de data em intervalos com métricas agregadas por bucket
- Arguments
idrequired — Dataset ID- Flags
--boundaries <value>— Comma-separated boundary values (omit for auto-bucketing)--bucket-count <value>— Number of auto-buckets (default: 5)--field <value>— Field to bucket--filters <value>— JSON array of filters--metrics <value>— JSON array of metrics
sift datasets cleanupPlaneje ou execute a limpeza de conjuntos de dados temporários com tags de ciclo de vida
- 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>— 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
sift datasets compareCompare métricas entre segmentos de um campo categórico lado a lado
- Arguments
idrequired — Dataset ID- Flags
--filters <value>— JSON array of filters--limit <value>— Max segment values to compare--metrics <value>— JSON array of metrics--segment-field <value>— Categorical field to segment by--segment-values <value>— Comma-separated segment values (auto-discovers if omitted)
sift datasets computeCalcule campos derivados de um conjunto de dados ou de um resultado anterior
- Arguments
id— Dataset ID- Flags
--computed-fields <value>— JSON array of computed fields, e.g. '[{"as":"spread","expression":"right.Close-left.Close"}]'--filters <value>— JSON array of filters--limit <value>— 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
sift datasets contractMostre o esquema e o contrato de capacidades do conjunto de dados legível para agentes
- Arguments
idrequired — Dataset ID- Flags
--resolve <value>— Comma-separated semantic field references to resolve--template <value>— Validate contract against a built-in template
sift datasets createCrie um conjunto de dados
- Flags
--description <value>— Dataset description--fields <value>— Field definitions as JSON array, e.g. '[{"name":"age","type":"number"}]'--idempotency-key <value>— 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>— Dataset title--ttl <value>— Lifecycle TTL duration, e.g. 12h, 7d, 30d
sift datasets dedupeLocaliza registros duplicados por chave sem alterar os dados
- Arguments
idrequired — Dataset ID- Flags
--key <value>— Field name used to group duplicates--limit <value>— Maximum records to scan in one bounded pass
sift datasets deleteExclui permanentemente um dataset e sua tabela física
- Arguments
idrequired — Dataset ID- Flags
-y, --yes— Confirm dataset deletion without prompting
sift datasets delete-recordExclui um registro de um dataset
- Arguments
idrequired — Dataset IDrecord-idrequired — Record ID- Flags
--idempotency-key <value>— Caller-owned stable key for replaying this exact dataset mutation-y, --yes— Skip confirmation
sift datasets diffVisualiza alterações nas linhas do dataset a partir de arquivos CSV, JSON ou JSONL
- Arguments
idrequired — Dataset ID- Flags
--batch-size <value>— Records per backend batch--from-file <value>— 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
sift datasets diff-plans listLista os planos de diff de dataset salvos
- Flags
--dataset-id <value>— Filter by dataset ID--limit <value>— Maximum plans to return--status <draft|validated|applied|rejected|expired>— Filter by plan status
sift datasets diff-plans showMostra um plano de diff de dataset salvo
- Arguments
idrequired — Diff plan ID
sift datasets exportExporta registros do dataset como CSV, JSON, JSONL ou Markdown
- Arguments
idrequired — Dataset ID- Flags
--filters <value>— JSON array of filters--format <csv|json|jsonl|markdown>— Export format--limit <value>— Max rows to export-o, --output <value>— Output file path (writes to stdout if omitted)--sorts <value>— JSON array of sorts
sift datasets facetsMostra resumos de facetas para os campos do dataset
- Arguments
idrequired — Dataset ID- Flags
--fields <value>— Comma-separated field names to facet--limit <value>— Maximum values per facet
sift datasets formula-planCalcula campos de fórmula e visualiza atualizações do dataset para revisão
- Arguments
idrequired — Dataset ID- Flags
--computed-fields <value>— JSON array of computed fields, e.g. '[{"as":"score","expression":"confidence * reliability"}]'--filters <value>— JSON array of filters for compute source--limit <value>— 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>— Field used to match rows for update
sift datasets getExibe detalhes e o esquema do dataset
- Arguments
idrequired — Dataset ID
sift datasets impactExplica o impacto da fórmula, gráfico, visualização, qualidade e materialização do dataset
- Arguments
idrequired — Dataset ID- Flags
--from-plan <value>— Persisted diff plan ID to inspect--operation <value>— Committed dataset operation ID to inspect
sift datasets importImporta linhas CSV, JSON ou JSONL para um dataset novo ou existente
- Arguments
filerequired — Path to CSV, JSON, or JSONL file- Flags
--batch-size <value>— 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
sift datasets inspect-fileInspeciona a estrutura de um arquivo local CSV, TSV, XLS ou XLSX sem criar ou alterar um conjunto de dados.
- Arguments
filerequired — 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
sift datasets joinFaz o join de um dataset com ele mesmo usando campos de alias como left.Close e right.Close
- Arguments
idrequired — Dataset ID- Flags
--join-keys <value>— JSON array of join keys, e.g. '[{"leftField":"Date","rightField":"Date"}]'--join-type <inner|left|right>— Join type--left-alias <value>— Left alias--left-filters <value>— JSON array of left-side filters--limit <value>— Maximum joined rows--right-alias <value>— 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
sift datasets listLista os datasets
- Flags
--limit <value>— Maximum number of results
sift datasets lookupBusca registros do dataset por uma correspondência exata de chave/valor
- Arguments
idrequired — Dataset ID- Flags
--key <value>— Field name to match--limit <value>— Maximum matching records--value <value>— Exact value to match
sift datasets materializeMaterializa um resultado derivado em um novo dataset temporário
- Flags
--description <value>— Dataset description--idempotency-key <value>— 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>— Title of the new dataset
sift datasets pivotCria um resumo em estilo pivô a partir de métricas agrupadas do dataset
- Arguments
idrequired — Dataset ID- Flags
--cols <value>— Column field--filters <value>— JSON array of filters--limit <value>— Maximum grouped cells to request--metrics <value>— JSON metrics array; defaults to count--rows <value>— Row field
sift datasets plotValida e normaliza um payload de gráfico leve de um resultado derivado
- Flags
--chart-type <line|bar|scatter>— 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>— X-axis field--y-fields <value>— Comma-separated Y-axis fields
sift datasets profileMostra informações de perfil delimitadas de um dataset
- Arguments
idrequired — Dataset ID- Flags
--sample-limit <value>— Number of sample rows to include
sift datasets qualityVerifica a qualidade do conjunto de dados com métricas estruturadas de valores ausentes e observações de valores repetidos.
- Arguments
idrequired — Dataset ID- Flags
--fields <value>— Comma-separated field names to check--repeat-threshold <value>— Minimum occurrences for a repeated value to be reported
sift datasets queryConsultar registros de um dataset
- Arguments
idrequired — 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>— Maximum number of records--sorts <value>— Sort spec as JSON array, e.g. '[{"field":"name","direction":"asc"}]'
sift datasets rankClassificar registros de um dataset por ordenação ou fórmula numérica ponderada
- Arguments
idrequired — Dataset ID- Flags
--filters <value>— JSON array of filters--formula <value>— JSON formula object {weights: [{field, weight}]}--limit <value>— Max rows--sorts <value>— JSON array of sorts
sift datasets reconcileComparar dois datasets por chave sem alterar nenhum deles
- Arguments
leftrequired — Left dataset IDrightrequired — Right dataset ID- Flags
--left-key <value>— Left dataset key field--limit <value>— Maximum rows to scan from each dataset--right-key <value>— Right dataset key field; defaults to --left-key
sift datasets schemaModificar o esquema do dataset (adicionar, atualizar ou excluir campos)
- Arguments
idrequired — 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>— Caller-owned stable key for replaying this exact dataset mutation--operation <add_field|update_field|delete_field>— Schema operation
sift datasets searchPesquisar registros do dataset em campos de texto selecionados
- Arguments
idrequired — Dataset IDqueryrequired — 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>— Maximum merged records--per-field-limit <value>— Maximum records to request per searched field
sift datasets summarizeObter um resumo de um dataset (contagem de linhas, campos, linhas de exemplo)
- Arguments
idrequired — Dataset ID
sift datasets templates listListar templates de dataset integrados
sift datasets templates showMostrar o esquema de um template de dataset integrado
- Arguments
templaterequired — Template name
sift datasets timeseriesAnalisar séries temporais do dataset com lag, pct_change, janelas móveis, drawdown, volatilidade e correlação
- Arguments
idrequired — Dataset ID- Flags
--date-field <value>— Date field name--filters <value>— JSON array of filters--limit <value>— Maximum output rows--metrics <value>— JSON array of metric definitions--order-direction <asc|desc>— 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
sift datasets update-recordAtualiza um registro em um dataset
- Arguments
idrequired — Dataset IDrecord-idrequired — Record ID- Flags
--fields <value>— Field updates as JSON object, e.g. '{"status":"done"}'--idempotency-key <value>— Caller-owned stable key for replaying this exact dataset mutation
sift datasets validateValida um dataset usando um modelo integrado
- Arguments
idrequired — 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>— Built-in template name
Documentos
Upload de documentos.
1 comando
sift documents uploadFaz upload de um documento (PDF, Markdown ou texto) como nota
- Arguments
filerequired — Path to file- Flags
--project <value>— Project ID--title <value>— Note title (defaults to filename)--type <note|concept|meeting|reference|daily|dataset>— Note type
Ambiente
Contratos de ambiente declarativos e materialização governada de pacotes do Vault.
11 comandos
sift env checkValida o contrato de ambiente para uso local ou em CI
- 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
sift env diffMostra o desvio do contrato de ambiente sem expor valores
- Flags
--checkout-root <value>— Exact Git checkout root containing .sift/environment.yaml
sift env endpoint enrollRegistra uma identidade de endpoint público sem conceder acesso ao Vault
- Flags
--dedicated— Endpoint is a dedicated runner--endpoint-class <interactive_desktop|remote_vm|noninteractive_runner|shared_host|ci_runner|production_host|multi_tenant>— Explicit endpoint policy class--kill-switch— Runner has an enforced kill switch--owner <value>— personal or workspace:<uuid>--storage-tier <hardware_host_bound|systemd_managed|convenience_keyring|none>— Actual endpoint key storage tier; convenience_keyring is not hardware-backed
sift env exampleGera um exemplo determinístico contendo apenas nomes e placeholders
- Flags
--checkout-root <value>— Exact Git checkout root containing .sift/environment.yaml--write— Write the deterministic output to .env.example instead of displaying it
sift env import applyAplicar atomicamente um plano de importação dotenv exato e revisado
- 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>— Reviewed value-free plan artifact--source <value>— Same explicit dotenv source used to create the plan
sift env import planCriar um plano sem valores e no escopo do proprietário para uma fonte dotenv nomeada explicitamente
- Flags
--checkout-root <value>— Checkout used only to reject Sift-managed source files--decision <value>— Explicit per-index decision: INDEX:keep-existing|overwrite|skip|rename=NAME--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--plan-file <value>— New local value-free plan artifact to create--project <value>— Exact owner-scoped project UUID--source <value>— Explicit dotenv source file
sift env pullBaixar um pacote exato e governado do Vault para um arquivo de ambiente de desenvolvimento gerenciado pelo Sift
- Flags
--approval-timeout <value>--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>— Explicit endpoint policy class; managed pulls accept development only--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--purpose <value>--replace— Replace a changed Sift-managed file using its exact observed precondition
sift env push applyAplicar atomicamente um plano de importação dotenv exato e revisado
- 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>— Reviewed value-free plan artifact--source <value>— Same explicit dotenv source used to create the plan
sift env push planCriar um plano sem valores e no escopo do proprietário para uma fonte dotenv nomeada explicitamente
- Flags
--checkout-root <value>— Checkout used only to reject Sift-managed source files--decision <value>— Explicit per-index decision: INDEX:keep-existing|overwrite|skip|rename=NAME--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--plan-file <value>— New local value-free plan artifact to create--project <value>— Exact owner-scoped project UUID--source <value>— Explicit dotenv source file
sift env rmRemover um arquivo de ambiente local exato gerenciado pelo Sift
- 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— Confirm removal of the exact recognized managed file
sift env statusRelatar o estado do ambiente local sem valores
- Flags
--checkout-root <value>— Exact Git checkout root containing .sift/environment.yaml
Eventos
Eventos de pesquisa baseados em fatos da linha do tempo.
3 comandos
sift events attach-personAdiciona um participante a um evento de pesquisa existente
- Arguments
eventrequired — Existing temporal fact IDpersonrequired — Person UUID to attach- Flags
--role <value>— Participant role--yes— Confirm participant attachment without prompting
sift events createCria um fato na linha do tempo de um evento de pesquisa com participantes
- Flags
--body <value>— Event notes/body--confidence <low|medium|high>— Confidence level--entity <value>— Participant/entity as type:uuid or type:uuid:role; repeatable--org <value>— Organization UUID participant; repeatable--person <value>— Person UUID participant; repeatable--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era>— Temporal precision--source <value>— 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>— Event title--visibility <org_public|private|restricted>— Timeline visibility--year <value>— Historical year CE--year-end <value>— Historical end year CE
sift events listListar fatos da linha do tempo de eventos de pesquisa
- Flags
--cursor <value>— Pagination cursor--end <value>— End boundary--entity <value>— Filter by entity ref type:uuid--limit <value>— Maximum events--order <asc|desc>— Sort order--person <value>— Filter by person UUID--q <value>— Text search query--start <value>— Start boundary
Evidência
Configuração do Grafo de Evidências e orquestração de fluxos de prova.
11 comandos
sift evidence diff applyAplicar um plano de diff revisado do Grafo de Evidências
- Arguments
idrequired — Persisted diff plan ID- Flags
--yes— Confirm applying the reviewed diff plan without prompting
sift evidence diff impactExplicar as consequências de um plano de diff persistido no Grafo de Evidências
- Arguments
idrequired — Persisted diff plan ID, or local when using --from-file- Flags
--from-file <value>— Local diff plan JSON file to explain without API access
sift evidence diff listListar planos de diff persistidos do Grafo de Evidências
- Flags
--dataset-id <value>— Filter by evidence dataset ID--limit <value>— 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
sift evidence diff showMostrar um plano de diff do Grafo de Evidências com resumo contextualizado
- Arguments
idrequired — Persisted diff plan ID
sift evidence extractCriar trabalho de agente (sem aplicar) para extração de candidatos do Grafo de Evidências
- Flags
--agent <value>— 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>— Evidence workflow pack--project <value>— Project ID--source-dataset <value>— Evidence sources dataset ID--targets <value>— Comma-separated extraction targets--yes— Confirm work item creation without prompting
sift evidence initCriar um projeto do Grafo de Evidências e tabelas de trabalho baseadas em datasets
- Arguments
namerequired — 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>— Evidence workflow pack--yes— Confirm creation without prompting
sift evidence planPlaneje um fluxo do Evidence Graph antes de gravar o estado confiável
- Arguments
goalrequired — Evidence Graph goal- Flags
--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history>— Evidence workflow pack--project <value>— Existing project ID--source-dataset <value>— Existing evidence sources dataset ID
sift evidence projectSimule a linha do tempo e a projeção de relacionamentos do 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>— Evidence workflow pack--project <value>— Evidence Graph project ID
sift evidence proof reportGere um relatório de prova do Evidence Graph a partir de um pacote de evidências baseado em dataset
- Flags
--format <json|markdown>— Report format--from-file <value>— Evidence packet JSON file to report on--project <value>— Evidence Graph project ID for report metadata
sift evidence sources importImporte linhas do ledger de origem do Evidence Graph para uma tabela de origem baseada em dataset
- Arguments
filerequired — Path to CSV, JSON, or JSONL source ledger rows- Flags
--batch-size <value>— Records per backend batch--dataset-id <value>— Evidence sources dataset ID--dry-run— Validate and plan source import without writing--upsert-by <value>— Field name used to update matching source rows--yes— Confirm mutating imports without prompting
sift evidence verifyVerifique a procedência, revisão, projeção e invariantes de citação do Evidence Graph
- Flags
--from-file <value>— Evidence packet JSON file to verify--project <value>— Evidence Graph project ID for report metadata
Grants
4 commands
sift grants adaptersList reviewed local execution adapters and honest containment tiers
sift grants requestRequest a human-approved grant for a pre-registered trusted local runner
- Flags
--adapter <value>--audience <value>--credential-field <value>--cwd <value>--executable <value>— Resolved reviewed executable path--executable-digest <value>--issuer <value>--operation <value>--purpose <value>--runner-fingerprint <value>--runner-public-key <value>— PEM public-key file from the trusted local runner--scope <value>— Provider scope JSON with string values--vault-entry <value>
sift grants runRequest approval, redeem in memory, and run exactly one reviewed child process
- Flags
--adapter <github_gh|github_publish_pr|terraform_apply>--approval-timeout <value>--audience <value>--body-file <value>— PR body file for github_publish_pr--credential-field <value>--cwd <value>--issuer <value>--operation <value>--purpose <value>--scope <value>--vault-entry <value>
sift grants statusInspect safe status for an ephemeral local execution grant
- Arguments
idrequired
Grafo
Pesquisa de grafos de entidades e vizinhanças.
5 comandos
sift graph betweenExplica o caminho em um grafo delimitado entre duas entidades
- Arguments
sourcerequired — Source entity reference as type:uuidtargetrequired — Target entity reference as type:uuid- Flags
--depth <value>— Maximum path depth, backend clamps to 1-5--frontier-limit <value>— Maximum links to inspect per path expansion, backend clamps to 1-1000
sift graph explainExplica o caminho em um grafo delimitado entre duas entidades
- Arguments
sourcerequired — Source entity reference as type:uuidtargetrequired — Target entity reference as type:uuid- Flags
--depth <value>— Maximum path depth, backend clamps to 1-5--frontier-limit <value>— Maximum links to inspect per path expansion, backend clamps to 1-1000
sift graph neighborsMostra os vizinhos locais de uma entidade no grafo
- Arguments
entityrequired — Entity reference as type:uuid- Flags
--depth <value>— Graph depth, backend clamps to 1-3--limit <value>— Maximum graph items, backend clamps to 1-200
sift graph previewVisualizar uma entidade do grafo
- Arguments
entityrequired — Entity reference as type:uuid
sift graph searchPesquisar entidades vinculáveis para o grafo
- Arguments
queryrequired — Search query- Flags
--limit <value>— Maximum results--types <value>— Comma-separated entity types
Notas
Notas de conhecimento.
7 comandos
sift notes bulk-deleteVisualizar ou excluir notas em massa
- 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>
sift notes createCriar uma nota
- 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>— Note title--type <note|concept|meeting|reference|daily|dataset>— Note type
sift notes deleteExcluir uma nota
- Arguments
idrequired — Note ID- Flags
-y, --yes— Skip confirmation
sift notes getVer uma nota com o conteúdo completo
- Arguments
idrequired — Note ID
sift notes listListar notas
- 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
sift notes searchPesquisar notas
- Arguments
queryrequired — Search query- Flags
--limit <value>— Maximum number of results--project <value>— Filter by project ID
sift notes updateAtualizar uma nota
- Arguments
idrequired — 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
Organizações
Organizações e empresas.
5 comandos
sift organizations bulk-deleteVisualizar ou excluir organizações em massa
- 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
sift organizations createCriar uma organização
- 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 (e.g. prospect, customer, partner, vendor)--type <value>— Organization type (e.g. company, nonprofit, government, school)--website <value>— Website URL
sift organizations deleteExcluir uma organização
- Arguments
idrequired — Organization ID- Flags
-y, --yes— Skip confirmation
sift organizations searchPesquisar organizações
- 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
sift organizations updateAtualizar uma organização
- Arguments
idrequired — 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
Pessoas
Pessoas e contatos.
15 comandos
sift people bulk-deleteVisualizar ou excluir contatos em massa
- 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
sift people context addAdicionar um relacionamento Pessoal ou de Trabalho relativo ao proprietário
- Arguments
personIdrequired — Person ID- Flags
--basis <value>— Why this relationship is recorded--confidence <value>— Evidence confidence from 0 to 1--context <personal|work>— Relationship context--primary— Make this the primary relationship in its context--relationship <value>— Relationship type, e.g. friend, client, mentor
sift people context listListar como o proprietário atual conhece uma pessoa
- Arguments
personIdrequired — Person ID
sift people context removeRemover um contexto de relacionamento relativo ao proprietário
- Arguments
personIdrequired — Person IDrelationshipIdrequired — Context relationship ID- Flags
--dry-run— Show what would be removed without writing-y, --yes— Remove without prompting
sift people createCriar um contato
- 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>— 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>— 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
sift people deleteExcluir um contato
- Arguments
idrequired — Person ID- Flags
-y, --yes— Skip confirmation
sift people enrichPesquisar informações públicas sobre uma pessoa com execução à prova de repetição
- Arguments
idrequired — Person ID- Flags
--dataset <value>— Optional dataset ID for a reviewable reconciliation plan--dataset-upsert-by <value>— Preferred dataset identity field--idempotency-key <value>— Stable 8-128 character key for exact retries--mode <standard|ultra>— Research depth
sift people getObter perfil de uma pessoa com características e relacionamentos
- Arguments
idrequired — Person ID
sift people graphExibir gráfico de relacionamentos centrado na pessoa
- Arguments
idrequired — Person ID- Flags
--depth <value>— Relationship graph depth--include-inactive— Include inactive relationship edges
sift people kinshipExplicar parentesco ou distância de relacionamento entre duas pessoas
- Arguments
egoPersonIdrequired — Ego/source person IDtargetPersonIdrequired — Target person ID- Flags
--max-depth <value>— Maximum relationship depth
sift people listListar contatos
- Flags
--category <family|romantic|professional|social>— Relationship category--contains <value>— Name substring filter--context <all|personal|work>— 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
sift people relateCrie ou atualize o relacionamento entre duas pessoas
- Arguments
personAIdrequired — First person IDpersonBIdrequired — Second person ID- Flags
--dry-run— Preview the relationship payload without writing--notes <value>— Relationship notes--type <value>— Relationship type, e.g. colleague, sibling, spouse, collaborator-y, --yes— Apply without prompting
sift people searchPesquise contatos
- Arguments
queryrequired — 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
sift people timelineListe fatos da linha do tempo de uma pessoa
- Arguments
idrequired — Person ID- Flags
--limit <value>— Maximum facts to return--order <asc|desc>— Sort order--role <value>— Filter by entity role, comma-separated
sift people updateAtualize um contato
- Arguments
idrequired — 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
Projetos
Gerenciamento de projetos.
7 comandos
sift projects archiveArquive um projeto
- Arguments
idrequired — Project ID- Flags
-y, --yes— Skip confirmation
sift projects contextVeja o contexto do projeto (tarefas, notas, sinais)
- Arguments
idrequired — Project ID
sift projects createCrie um projeto
- Flags
--emoji <value>— Single emoji--name <value>— Project name--status <planning|active|on_hold|blocked|completed>— Project status--summary <value>— Project summary
sift projects listListar projetos
- Flags
--include-archived— Include archived projects--status <planning|active|on_hold|blocked|completed>— Filter by status
sift projects planningObter o snapshot de planejamento CSN canônico de um projeto
- Arguments
idrequired — Project ID
sift projects planning-recomputeRecalcular o snapshot de planejamento CSN canônico de um projeto
- Arguments
idrequired — Project ID
sift projects updateAtualizar um projeto
- Arguments
idrequired — Project ID- Flags
--emoji <value>— Single emoji--name <value>— Project name--status <planning|active|on_hold|blocked|completed>— Project status--summary <value>— Project summary
Receitas
Receitas nativas de fluxo de trabalho de pesquisa.
2 comandos
sift recipes listListar receitas nativas de fluxo de trabalho de pesquisa
sift recipes showExibir uma receita nativa de fluxo de trabalho de pesquisa
- Arguments
idrequired — Recipe ID
Relationships
79 commands
sift relationships actions dry-runPreview a relationship action on the server without committing it
- Arguments
idrequired — Relationship action IDentity— Relationship entity as opportunity:<uuid> or prospect:<uuid>- Flags
--entity <value>— Target as prospect:uuid or opportunity:uuid--idempotency-key <value>— Stable 8-128 character key for reproducible server-side previews--input <value>— Action input JSON object--input-file <value>— Path to action input JSON
sift relationships actions listList 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
sift relationships actions runRun any canonical relationship action with replay-safe caller identity
- Arguments
idrequired — Canonical action ID from relationships actions listentity— 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>— 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
sift relationships actions showShow one registered relationship action
- Arguments
idrequired — Relationship action ID
sift relationships briefCompose an exact, evidence-grounded relationship brief
- Arguments
subjectrequired — Subject as prospect:uuid or opportunity:uuid- Flags
--lens <value>— Relationship lens identifier
sift relationships composer approver-editCriar uma revisão de aprovador atribuída e reabrir a análise de coaching
- Arguments
idrequired — Composer session UUID- Flags
--body <value>--expected-version <value>--reason <value>--subject <value>--yes— Confirm the attributed edit
sift relationships composer bind-senderVincular explicitamente uma conta de e-mail ativa e conectada a um rascunho durável
- Arguments
idrequired — Composer session UUID- Flags
--expected-version <value>— Current optimistic session version--sender <value>— Connected email account UUID
sift relationships composer confirmConfirmar o resumo vinculado e criar a primeira revisão do rascunho durável
- Arguments
idrequired — Composer session UUID- Flags
--expected-version <value>— Current optimistic session version--yes— Confirm brief and create draft
sift relationships composer createCriar ou retomar uma sessão durável de relacionamento, do resumo ao rascunho
- Arguments
subjectrequired — Subject as prospect:uuid or opportunity:uuid- Flags
--file <value>— JSON file with source, recommendation, brief, and ranked evidence
sift relationships composer dispatchManter a aprovação exata, enviar agora ou agendar uma mensagem de relacionamento governada
- Arguments
idrequired — Composer session UUID- Flags
--at <value>— ISO-8601 time required for send_later--choice <approve_only|send_now|send_later>— Dispatch outcome--expected-version <value>— Current optimistic session version--idempotency-key <value>— Stable retry key for this exact choice and time--yes— Confirm this governed dispatch choice
sift relationships composer evaluateAvaliar o rascunho durável atual e anexar os resultados de coaching ancorados em frases
- Arguments
idrequired — Composer session UUID- Flags
--expected-version <value>— Current optimistic session version
sift relationships composer finding-actionExplicar, pré-visualizar, aceitar, rejeitar ou desfazer um resultado de coaching atribuível
- Arguments
idrequired — Composer session UUIDfindingrequired — Coaching finding UUID- Flags
--action <explain|preview|accept|reject|undo>--expected-version <value>— Current optimistic session version--yes— Confirm a mutating coaching decision
sift relationships composer historyExibe o histórico de orientações e decisões do rascunho na ordem de registro.
- Arguments
idrequired — Composer session UUID
sift relationships composer request-approvalSolicita ou retoma a aprovação para a revisão exata; a aprovação acontece somente no navegador.
- Arguments
idrequired — Composer session UUID- Flags
--expected-version <value>— Current optimistic session version--idempotency-key <value>— Stable approval-request retry key--yes— Confirm the approval request
sift relationships composer request-changesDevolve uma revisão exata ao autor sem alterar a mensagem.
- Arguments
idrequired — Composer session UUID- Flags
--expected-version <value>--reason <value>--yes— Confirm the review interruption
sift relationships composer resolve-identityResolve ou encaminha a verificação de possível duplicata em uma mensagem revisada.
- Arguments
idrequired — Composer session UUID- Flags
--candidate <value>— Candidate person UUID--decision <same_person|different_people|route_to_owner>--expected-version <value>--yes— Confirm the identity decision
sift relationships composer reviewEnvia um rascunho que já passou pela orientação para a revisão formal.
- Arguments
idrequired — Composer session UUID- Flags
--approver-user-id <value>— Optional active internal workspace member who will approve the exact message--expected-version <value>— Current optimistic session version--yes— Confirm the transition to review
sift relationships composer save-draftSalva uma nova versão do rascunho de relacionamento.
- Arguments
idrequired — Composer session UUID- Flags
--file <value>— JSON file with expectedVersion, subject, and bodyText
sift relationships composer showExibe os detalhes de uma sessão no editor de relacionamento.
- Arguments
idrequired — Composer session UUID
sift relationships composer updateAtualiza a intenção definida e as evidências classificadas antes de criar o rascunho.
- Arguments
idrequired — Composer session UUID- Flags
--file <value>— JSON file with expectedVersion, brief, and evidence
sift relationships contact-plan inspectInspeciona o plano de contato principal de uma pessoa sem alterar os dados de origem.
- Arguments
personrequired — Canonical person UUID- Flags
--from <value>— Inclusive ISO-8601 inspection window start--limit <value>— Maximum projected items--timezone <value>— IANA display timezone--to <value>— Inclusive ISO-8601 inspection window end
sift relationships diagnoses createCria um registro imutável do diagnóstico de relacionamento, com base em evidências.
- Flags
--file <value>— Diagnosis JSON file--yes— Confirm immutable diagnosis creation
sift relationships diagnoses listLista os registros imutáveis de diagnóstico de relacionamento.
- Flags
--limit <value>--subject-id <value>--subject-type <prospect|opportunity>
sift relationships email-accounts listLista as contas de remetente disponíveis para rascunhos e envios formais.
sift relationships generated-assets draftCria uma proposta de comunicação privada a partir de um recurso de divulgação aprovado; não faz o envio.
- Arguments
idrequired — Generated outreach/follow-up asset UUID- Flags
--file <value>— Exact senderAccountId, destination, optional edits, and idempotency JSON file--yes— Confirm proposal creation
sift relationships generated-assets generateGera um novo recurso com base em versões exatas e aprovadas do playbook e dos materiais de origem.
- Flags
--file <value>— Generation request JSON file--yes— Confirm immutable asset generation
sift relationships generated-assets listLista os recursos de relacionamento gerados, com seus manifestos e a revisão mais recente.
- Flags
--limit <value>--subject-id <value>--subject-type <prospect|opportunity>
sift relationships generated-assets reviewRegistra a decisão de uma pessoa (aprovação ou rejeição) sobre um artefato gerado.
- Arguments
idrequired — Generated asset UUID- Flags
--decision <approved|rejected|needs_changes>--reason <value>--yes— Confirm append-only review
sift relationships generated-assets review-historyLista o histórico completo de revisões de um recurso gerado.
- Arguments
idrequired — Generated asset UUID
sift relationships generated-assets showExibe um recurso gerado, seu manifesto exato e a aprovação mais recente.
- Arguments
idrequired — Generated asset UUID
sift relationships generated-assets usage-listLista o histórico de uso e os links de resultados de um recurso gerado.
- Arguments
idrequired — Generated asset UUID
sift relationships generated-assets usage-recordRegistra um novo uso (exportação, compartilhamento interno ou link de resultado) para um recurso gerado.
- Arguments
idrequired — Generated asset UUID- Flags
--idempotency-key <value>— Stable 8-128 character retry key--kind <exported|shared_internally|outcome_linked>--outcome <value>— Stable outcome reference; required for outcome_linked--yes— Confirm append-only usage record
sift relationships handoffs listList immutable relationship outcome receipts in the onboarding queue
- Flags
--limit <value>— Maximum receipts
sift relationships handoffs showShow one immutable relationship outcome handoff receipt
- Arguments
idrequired — Outcome handoff receipt UUID
sift relationships meetings brief createElabora um resumo de reunião citado a partir de evidências de relacionamento aprovadas.
- Flags
--input <value>— Exact meeting brief input JSON--input-file <value>— Path to exact meeting brief input JSON
sift relationships meetings brief showLê o resumo de reunião citado atual, recompondo-o a partir de suas entradas exatas.
- Flags
--input <value>— Exact owner, subject, approved asset, and optional meeting JSON--input-file <value>— Path to exact meeting brief input JSON
sift relationships meetings evidence captureCaptura evidências de transcrição que exigem consentimento ou notas manuais declaradas explicitamente.
- Flags
--idempotency-key <value>— 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
sift relationships meetings evidence showInspeciona um evento canônico de evidência de reunião e seus localizadores de origem.
- Arguments
idrequired — Relationship meeting evidence event UUID
sift relationships meetings proposals applyAplica atomicamente uma proposta de reunião aprovada após novas verificações das pré-condições.
- Arguments
idrequired — Approved meeting proposal UUID- Flags
--expected-proposal-digest <value>— Exact reviewed proposal digest--yes— Confirm the persistent internal relationship-state change
sift relationships meetings proposals createCria uma proposta imutável, com evidências citadas, para uma ação de relacionamento registrada.
- Flags
--idempotency-key <value>— 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
sift relationships meetings proposals listLista propostas de relacionamento derivadas de reuniões e seu ciclo de vida de revisão.
- 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
sift relationships meetings proposals reviewAnexa uma aprovação ou rejeição atribuível a uma proposta de reunião inalterada.
- Arguments
idrequired — 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
sift relationships meetings proposals showInspeciona uma proposta de relacionamento derivada de reunião, com suas evidências, diferenças e plano de recuperação.
- Arguments
idrequired — Meeting proposal UUID
sift relationships outcomes describeDescreve os contratos de resultado de relacionamento em tempo de execução e seus limites de segurança.
sift relationships outcomes inspectInspeciona resultados de relacionamento declarados no modo Answer/C0 sem persistência.
- Flags
--input <value>— Exact InspectRelationshipOutcomeInput JSON--input-file <value>— Path to exact inspection input JSON
sift relationships outcomes interventionsExibe o lote de intervenção único, limitado e revisável para um snapshot.
- Arguments
snapshotIdrequired — Relationship-outcome snapshot ID
sift relationships outcomes listLista snapshots de resultado de relacionamento com paginação por cursor limitado.
- Flags
--cursor <value>— Opaque cursor from the previous page--limit <value>— 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
sift relationships outcomes recordsLista registros exatos de snapshot com paginação por cursor limitado.
- Arguments
snapshotIdrequired — Relationship-outcome snapshot ID- Flags
--cursor <value>— Opaque cursor from the previous page--limit <value>— Maximum records to return--posture <value>— Filter by the declared record posture--risk <value>— Filter by low, moderate, high, or unknown operational risk
sift relationships outcomes reviewRegistra uma revisão idempotente de snapshot sem executar nenhuma ação registrada proposta.
- Arguments
snapshotIdrequired — Relationship-outcome snapshot ID- Flags
--dry-run— Validate authority and selected interventions without recording a review--idempotency-key <value>— 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
sift relationships outcomes runCria ou faz um dry-run de um snapshot de resultado de relacionamento C2; nunca executa as ações propostas.
- Flags
--dry-run— Validate and project without persisting a snapshot--idempotency-key <value>— 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
sift relationships outcomes showExibe um snapshot imutável de resultado de relacionamento.
- Arguments
snapshotIdrequired — Relationship-outcome snapshot ID
sift relationships playbook-recommendations createRegistra uma recomendação de impacto com no mínimo três passos plausíveis.
- Flags
--file <value>— Recommendation JSON file--yes— Confirm immutable recommendation creation
sift relationships playbook-recommendations listLista as recomendações de playbook de relacionamento registradas com seus passos alternativos.
- Flags
--limit <value>--subject-id <value>--subject-type <prospect|opportunity>
sift relationships playbooks createCria uma versão imutável e não aprovada do playbook de relacionamento a partir de um JSON de contrato em tempo de execução.
- Flags
--file <value>— Playbook version JSON file--yes— Confirm immutable version creation
sift relationships playbooks listLista as versões imutáveis de playbooks de relacionamento e as últimas decisões de aprovação.
- Flags
--limit <value>— Maximum versions--stable-key <value>— Filter by stable playbook key
sift relationships playbooks reviewAnexa uma decisão de aprovação humana a uma versão de playbook.
- Arguments
idrequired — Playbook version UUID- Flags
--decision <approved|rejected|needs_changes>--reason <value>— Attributable review reason--yes— Confirm append-only review
sift relationships playbooks showExibe uma versão imutável de playbook de relacionamento e sua aprovação mais recente.
- Arguments
idrequired — Playbook version UUID
sift relationships proposals getInspect one relationship action proposal and its evidence
- Arguments
idrequired — Proposal ID
sift relationships proposals listList 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
sift relationships proposals request-approvalRequest short-lived human approval for a proposal; cannot approve or consume it
- Arguments
idrequired — Proposal ID- Flags
--idempotency-key <value>— Stable 8-128 character key for safe retries--purpose <value>— Non-secret reason shown to the human approver
sift relationships queues listList relationship team queues in the active workspace
sift relationships recommendations executeExecute an accepted, current recommendation through the canonical action runtime
- Arguments
idrequired — Recommendation UUID- Flags
--yes— Confirm canonical action execution
sift relationships recommendations listList immutable relationship recommendation snapshots
- Flags
--lens <value>— Relationship lens identifier--limit <value>— Maximum recommendations--subject <value>— Filter by prospect:uuid or opportunity:uuid
sift relationships recommendations reviewAppend an ordinary review decision to a relationship recommendation
- Arguments
idrequired — Recommendation UUID- Flags
--decision <accepted|dismissed|snoozed|needs_information>— Review decision--reason <value>— Review reason--snoozed-until <value>— Offset-aware ISO date-time, required for snoozed--yes— Confirm the append-only review
sift relationships recommendations showShow a relationship recommendation with its exact citations and gates
- Arguments
idrequired — Recommendation UUID
sift relationships sequences createCreate 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>— Stable 8-128 character key for safe retries
sift relationships sequences dry-runPreview a supervised sequence on the server without committing it
- Arguments
idrequired — Sequence ID- Flags
--idempotency-key <value>— 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
sift relationships sequences enrollEnroll a relationship target in a supervised sequence
- Arguments
idrequired — Sequence ID- Flags
--idempotency-key <value>— Stable 8-128 character key for safe retries--input <value>— Enrollment input JSON object--input-file <value>— Path to enrollment input JSON
sift relationships sequences getShow one supervised relationship sequence
- Arguments
idrequired — Sequence ID
sift relationships sequences listList supervised relationship sequences
- Flags
--limit <value>— Maximum results--status <value>— Filter by sequence status
sift relationships sequences pausePause a supervised relationship sequence
- Arguments
idrequired — Sequence ID- Flags
--idempotency-key <value>— Stable 8-128 character key for safe retries--reason <value>— Non-secret pause reason
sift relationships sequences resumeResume a supervised relationship sequence
- Arguments
idrequired — Sequence ID- Flags
--idempotency-key <value>— Stable 8-128 character key for safe retries
sift relationships sequences runsList execution evidence for a supervised relationship sequence
- Arguments
idrequired — Sequence ID- Flags
--limit <value>— Maximum results--status <value>— Filter by run status
sift relationships sequences updateUpdate a supervised relationship sequence from a JSON definition
- Arguments
idrequired — Sequence ID- Flags
--definition <value>— Sequence update JSON object--definition-file <value>— Path to sequence update JSON--idempotency-key <value>— Stable 8-128 character key for safe retries
sift relationships showShow the current relationship collaboration snapshot
- Arguments
entityrequired — Relationship entity as opportunity:<uuid> or prospect:<uuid>
sift relationships source-assets createCria uma versão imutável e não aprovada de um recurso de origem fundamentado.
- Flags
--file <value>— Source-asset version JSON file--yes— Confirm immutable version creation
sift relationships source-assets listLista as versões imutáveis de recursos de origem fundamentados e as decisões de aprovação mais recentes.
- Flags
--limit <value>— Maximum versions--stable-key <value>— Filter by stable source-asset key
sift relationships source-assets reviewAnexa uma decisão de aprovação humana a uma versão de recurso de origem.
- Arguments
idrequired — Source-asset version UUID- Flags
--decision <approved|rejected|needs_changes>--reason <value>--yes— Confirm append-only review
sift relationships source-assets showExibe uma versão exata e imutável de um recurso de origem e sua revisão mais recente.
- Arguments
idrequired — Source-asset version UUID
Pesquisa
Planejamento e orquestração de fluxos de pesquisa.
4 comandos
sift research initCria um projeto de pesquisa e conjuntos de dados padrão
- Arguments
namerequired — Research project name- Flags
--dry-run— Preview project/dataset creation without writing--template <historical-research>— Research template--yes— Confirm creation without prompting
sift research planPlaneje um fluxo de pesquisa determinístico antes de gravar os dados.
- Arguments
goalrequired — Research goal- Flags
--project <value>— Existing project ID--source-dataset <value>— Existing sources dataset ID
sift research runCrie o trabalho de agentes determinísticos para uma receita de pesquisa.
- Arguments
reciperequired — Research run recipe- Flags
--agent <value>— 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
sift research statusInspecione o contexto do projeto de pesquisa e a prontidão da CLI.
- Arguments
project— Project ID
Skills
Skillpacks do Siftable para instalação.
2 comandos
sift skills installInstala um skillpack do Siftable em um diretório local de skills
- Arguments
idrequired — Skillpack ID- Flags
--force— Replace an existing installed skill--target <value>— Installed skills directory-y, --yes— Confirm replacing an existing skill
sift skills listLista os skillpacks do Siftable disponíveis para instalação
Tarefas
Tarefas de planejamento humano.
11 comandos
sift tasks bulk-deleteVisualiza ou exclui tarefas em massa
- 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>
sift tasks completeMarca uma tarefa como concluída
- Arguments
idrequired — Task ID
sift tasks coupling-createCria um vínculo de acoplamento CSN entre tarefas do mesmo projeto
- Arguments
idrequired — Source task IDtargetrequired — Target task ID- Flags
--note <value>— Optional note--strength <value>— Coupling strength (0-1)--type <info|resource>— Coupling type
sift tasks coupling-deleteExclui um vínculo de acoplamento CSN de uma tarefa
- Arguments
idrequired — Task IDedgeIdrequired — Coupling edge ID- Flags
-y, --yes— Skip confirmation
sift tasks coupling-listListar conexões de acoplamento CSN de uma tarefa
- Arguments
idrequired — Task ID
sift tasks createCriar uma tarefa de planejamento humano
- 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>— Task title
sift tasks deleteExcluir uma tarefa
- Arguments
idrequired — Task ID- Flags
-y, --yes— Skip confirmation
sift tasks getVer detalhes de uma tarefa de planejamento humano
- Arguments
idrequired — Task ID
sift tasks listListar tarefas de planejamento humano
- Flags
--cursor <value>— Continuation cursor from a previous page--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
sift tasks planning-updateAtualizar campos de planejamento CSN de uma tarefa
- Arguments
idrequired — 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)
sift tasks updateAtualizar uma tarefa de planejamento humano
- Arguments
idrequired — 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
Linha do tempo
Fatos e narrativas da linha do tempo.
4 comandos
sift timeline createCria um fato na linha do tempo escrito por você
- Flags
--body <value>— Fact body or notes--confidence <low|medium|high>— Confidence level--entity <value>— Participant/entity as type:uuid or type:uuid:role; repeatable--fact-type <value>— Fact type--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era>— 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>— Fact title--visibility <org_public|private|restricted>— Timeline visibility--year <value>— Historical year CE--year-end <value>— Historical end year CE
sift timeline deleteExclui um fato da linha do tempo
- Arguments
idrequired — Timeline fact ID- Flags
--yes— Confirm retraction without prompting
sift timeline listLista fatos da linha do tempo com filtros delimitados
- 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>— Maximum items to return--order <asc|desc>— Sort order--q <value>— Text search query--source-types <value>— Comma-separated source types--start <value>— Start boundary, ISO timestamp or supported historical boundary
sift timeline narrativeGera um resumo narrativo ou explicação dos fatos da linha do tempo
- Flags
--action <summarize|changed_since|led_to|what_next|cross_object>— Narrative action--entity <value>— Entity scope as type:uuid--entity-roles <value>— Comma-separated entity roles--fact-type <value>— Fact type filter--limit <value>— 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
Vault
Cofre de segredos.
15 comandos
sift vault auditList Vault audit events (requires vault:audit:read)
- Flags
--limit <value>— Maximum number of results--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault createArmazena um novo segredo criptografado
- Flags
--category <value>— Category--description <value>— Description--name <value>— Secret name--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--payload <value>— 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
sift vault leases cleanLimpa um artefato de lease local e atesta o estado como confirmado, falho ou desconhecido.
- Arguments
idrequired- Flags
--checkout-root <value>— Git checkout used to prove runtime separation--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault leases listLista os leases de ambiente (sem valores) e seus metadados de limpeza.
- Flags
--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault leases revokeRevoga o uso futuro de um lease, remove o artefato local (se existir) e atesta a limpeza.
- Arguments
idrequired- Flags
--checkout-root <value>— Git checkout used to prove runtime separation--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault leases statusInspeciona o ciclo de vida de um lease de ambiente (sem valores).
- Arguments
idrequired- Flags
--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault listLista as entradas do cofre (apenas metadados)
- 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
sift vault materialize environmentObtém um pacote exato e governado do Vault para um arquivo de ambiente de desenvolvimento gerenciado pelo Siftable.
- Flags
--approval-timeout <value>--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>— Explicit endpoint policy class; managed pulls accept development only--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--purpose <value>--replace— Replace a changed Sift-managed file using its exact observed precondition
sift vault materialize requestRequest human approval for one destination-bound Vault materialization
- Flags
--destination <value>--entry <value>--expected-digest <value>--field <value>--materializer-digest <value>--mode <0400|0600>--nonce <value>--overwrite--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--purpose <value>--runner-fingerprint <value>--runner-public-key <value>--tracked-exception--workspace-root <value>— Absolute local workspace root containing the destination
sift vault materialize revokeRevoga uma materialização pendente do Vault vinculada a um destino.
- Arguments
idrequired — 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>
sift vault materialize runRequest approval, wait, and materialize one Vault field at the exact approved path
- Flags
--approval-timeout <value>--destination <value>— Destination path; relative paths resolve inside --workspace-root before approval--entry <value>--field <value>--mode <0400|0600>--overwrite--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--purpose <value>--tracked-exception--workspace-root <value>— Absolute local workspace root containing the destination
sift vault materialize statusInspect safe status for a destination-bound Vault materialization
- Arguments
idrequired- 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>
sift vault searchPesquise entradas no vault
- Arguments
queryrequired — Search query- Flags
--limit <value>— Maximum number of results--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>
sift vault updateAtualize os metadados de uma entrada do vault
- Arguments
idrequired — 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
sift vault use leaseCria um artefato de pacote de ambiente exato e de curta duração fora da worktree do Git.
- Flags
--approval-timeout <value>--checkout-root <value>— Checkout containing .sift/environment.yaml--consumer <value>— 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>--holder <value>— Bound holder identifier; defaults to the local runner fingerprint--owner <value>— Exact Vault owner: personal or workspace:<tenant-id>--purpose <value>--ttl <value>
Trabalho
Fila de trabalho do agente executável.
25 comandos
sift work blockMarque um item de trabalho como bloqueado
- Arguments
idrequired — 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"?}]
sift work cancelCancele um item de trabalho
- Arguments
idrequired — 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"?}]
sift work claimAssuma o próximo item de trabalho disponível de um agente executável
- Arguments
id— Optional specific work item ID- Flags
--agent <value>— Agent alias to claim for--lease <value>— Lease seconds--owner <value>— Claim owner identity
sift work completeAprove e conclua um item de trabalho de um agente executável
- Arguments
idrequired — 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"?}]
sift work contract checkValida de forma determinística um arquivo de Contrato de Trabalho (Work Contract) V1 ou um item de trabalho buscado.
- Arguments
id— Work item ID to fetch and validate- Flags
--file <value>— Path to a Work Contract V1 JSON file
sift work createCrie um item de trabalho de um agente executável
- 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>— 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>— 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>— Queue rank--scope <value>— Included workspace-relative write scope; repeat for multiple paths--task <value>— Parent human planning task ID--title <value>— Executable work item title--verify <value>— Verification commands separated by semicolons--write-scope <value>— Write scope JSON object
sift work dependencies getGet authoritative dependencies and claimability for a work item
- Arguments
idrequired — Work item UUID
sift work dependencies setAtomically replace the authoritative dependencies for a work item
- Arguments
idrequired — Work item UUID- Flags
--depends-on <value>— Dependency JSON array; pass [] to clear dependencies
sift work dependency-policy getGet a project default work-dependency gate
- Flags
--project <value>— Project UUID
sift work dependency-policy setSet a project default work-dependency gate
- Flags
--gate <done|commands_passed>— Default gate for dependencies that omit requiredGate--project <value>— Project UUID
sift work editC2: 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
idrequired — 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>— Observed work item revision--idempotency-key <value>— 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>— 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
sift work failMarcar um item de trabalho como falha
- Arguments
idrequired — 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"?}]
sift work getObter detalhes de um item de trabalho do agente executável
- Arguments
idrequired — Work item ID
sift work heartbeatEstender a reserva de um item de trabalho
- Arguments
idrequired — 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"?}]
sift work listListar itens de trabalho do agente executável
- 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
sift work releaseLiberar um item de trabalho reservado de volta para a fila
- Arguments
idrequired — 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"?}]
sift work requeueReturn blocked work to the queue for a fresh claim
- Arguments
idrequired — 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"?}]
sift work reviewMarcar trabalho do agente executável para revisão humana
- Arguments
idrequired — 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"?}]
sift work revisionsList immutable, attributable work-item revision receipts and field diffs
- Arguments
idrequired — Work item ID- Flags
--limit <value>— Maximum revisions to return
sift work startMarcar um item de trabalho como em execução
- Arguments
idrequired — 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"?}]
sift work verification evidenceSubmit externally executed evidence for an exact plan version and step ID
- Arguments
idrequired — Work item ID- Flags
--artifacts <value>— Artifact reference JSON array for larger logs--attempt <value>— 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>— Execution environment label--exit-code <value>— Process exit code when applicable--outcome <passed|failed|error>— Attempt outcome--output <value>— Bounded output excerpt; secrets are redacted by the API--plan-version <value>— Active verification plan version--provenance <value>— Evidence provenance JSON object--ran-at <value>— RFC3339 execution timestamp--step <value>— Stable verification step UUID
sift work verification historyList immutable verification-plan history and coverage
- Arguments
idrequired — Work item ID
sift work verification planShow the active versioned verification plan and coverage
- Arguments
idrequired — Work item ID
sift work verification reviseCreate an audited active verification-plan revision
- Arguments
idrequired — Work item ID- Flags
--expected-version <value>— Observed active plan version--provenance <value>— Revision provenance JSON object--reason <value>— Audited revision reason--steps <value>— Verification step JSON array--steps-file <value>— Path to a verification step JSON array--yes— Confirm activation without prompting
sift work verifyDeprecated compatibility command. Hosted LLM verification is retired; use verification-command evidence.
- Arguments
idrequired — 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
Worker
Executores locais de tarefas.
2 comandos
sift worker dispatchCria um plano sem custo e sem impacto visível para exatamente dois agentes de trabalho da AWS.
- Flags
--max-runtime-minutes <value>— 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>— Calling control surface; does not change dispatch identity--work-item <value>— Queued Sift work-item UUID; repeat exactly twice
sift worker runAssuma tarefas executáveis, rode um comando de worker local e relate artefatos que precisam de revisão.
- Flags
--agent <value>— Agent alias to claim work for--command <value>— Local command to run for the claimed work item--cwd <value>— Fallback working directory for the local command--lease <value>— Lease seconds--owner <value>— Worker owner fingerprint
Workspaces
3 comandos
sift workspaces currentExibe o workspace Pessoal ou colaborativo selecionado no momento.
sift workspaces listLista os workspaces colaborativos disponíveis para o usuário autenticado.
sift workspaces useSeleciona um workspace colaborativo para descoberta, ou "Personal" para limpar a seleção.
- Arguments
idrequired — Workspace ID, or "personal"
Copilot Interativo
O comando sift interactive inicia um copilot de terminal que conversa, executa ferramentas, edita código, cria ramificações paralelas de agentes, planeja o trabalho e renderiza diagramas — tudo no terminal, atuando no seu sistema de arquivos e no gráfico de trabalho do Siftable.
$ sift interactive
Requisitos e inicialização
- O Bun é necessário. O
sift interactiveexecuta o Bun novamente; se ele não estiver instalado, o comando exibecurl -fsSL https://bun.sh/install | bash. - A autenticação é obrigatória — via
--token,SIFT_TOKENousift auth login. - O cérebro roda no próprio processo — não é necessário iniciar um daemon separado.
- As alterações ficam restritas à raiz do workspace — o diretório ancestral mais próximo da pasta de inicialização que contém
.git. Esse é o limite que o/statusreporta e que o caminho de escrita nativo impõe.
A interface
The composer is a full readline-capable text area. Enter submits; Shift+Enter / Ctrl+J insert a newline; submitting while the agent is busy queues your message. !command runs via bash -lc into the transcript (a bare !cd <path> changes the session directory; output clipped to ~4000 chars). Large or structured pastes become a collapsed chip; pasted images are validated, normalized, and attached. ? on an empty composer shows hotkeys.
Comandos de barra
Digite / para abrir o menu de comandos. Comandos ocultos continuam funcionando se digitados, mas não aparecem no menu.
| Command | Group | Description |
|---|---|---|
/help, /hotkeys, /status | Session | Command list, keyboard shortcuts, and current model/scope/queue status |
/cwd [path] | Session | Show or change the working directory (recomputes the workspace root) |
/copy [last|all|explorer] | Session | Copy the latest reply, whole transcript, or latest explorer report to the clipboard |
/clear, /quit | Session | Reset the transcript; exit |
/threads [clear], /compact | Session | Manage the persisted thread; force a context compaction (requires context compaction enabled) |
/model [id] [effort] | Model | Open the model picker or select a model and reasoning effort directly |
/codex [login|on|use|off|logout|status] | Model | Control the Codex (ChatGPT) engine; default subcommand is status |
/key <provider> <key>, /key vault <provider> | Model | Store a provider API key, or hydrate it from Siftable Vault |
/login | Model | Siftable device-code login from inside the TUI |
/explorer | Model | Configure the repo Explorer (context-gathering backend) |
/skills [name] | Skills | List discovered skills, or print one skill's body |
/branches | Branches | Open the parallel-agent branches hub |
/spawn <title> [--rw <globs>|--rw-any|--ro] | Branches | Start a child agent branch in its own git worktree with an access mode |
/merge, /rebase, /sendback, /reject | Branches | Land, replay, resume, or reject a child branch |
/work | Work | Open the work-queue hub (board of agents and items by status) |
/plan [objective | work [--apply] [--after SRC:DST] [--limit N] | view] | Work | Plan from an objective, or compute a precedence DAG over the agent work queue as a Mermaid graph |
/handoff <title> [--agent ..] [--files ..] [--acceptance ..] [--verify ..] | Work | Create a Siftable work item from the current context |
/proof <claim>, /remember <fact> --category <..> | Work | Gather code/test evidence; store durable code memory |
/crew [list|show|new|run], /collab | Crews | Manage and run multi-agent crews; show in-process collaboration sessions |
/mermaid [request|file.mmd|source], /view | Diagrams | Render Mermaid (NL request, file, or source) in the terminal; open the pannable viewer |
/theme, /sounds [on|off] | Appearance | Open the appearance picker; toggle UI sounds |
Modelos e motores
The model picker (/model) is two-stage: choose a model, then a reasoning effort (saved to ~/.siftable/prefs.json). The catalog includes GPT-5.6 Sol, Terra, and Luna (ChatGPT plan via the Codex engine — /codex login / /codex on select Sol by default), Claude Opus 4.8 (OpenRouter or direct Anthropic with ANTHROPIC_API_KEY), Claude Sonnet 4.6 / Haiku 4.5, Gemini 3.x Flash / Flash-Lite, GPT-5.4 mini / nano, and Morph v3 Large (apply-only). Codex drives the OpenAI codex app-server sidecar (ChatGPT device-code login). All other providers route through the bundled OpenFunction agent via <PROVIDER>_API_KEY. /key vault <provider> hydrates a key from Siftable Vault behind an approval prompt; the secret is never printed or written to disk.
Repo Explorer
/explorer configures repository context gathering before a turn. Modes: auto, off, deterministic, scout, fanout, warpgrep. Pick a scout model and budget (cheap/normal/deep). warpgrep needs MORPH_API_KEY (auto-hydrated from Vault when available). Settings persist in prefs.json.
Skills
As skills SKILL.md são detectadas (projeto > usuário > integradas) em <root>/{.sift,.claude,.codex,.agents}/skills, ~/.claude|.codex|.agents/skills, ~/.config/sift/skills e nas skills incluídas no pacote. O agente pode acionar uma skill por meio de uma ferramenta, e até ~50 são exibidas no seu prompt de sistema.
Atalhos de teclado
As sobreposições capturam o teclado primeiro, então os atalhos são específicos de cada modo.
- Enter submit (queues if busy) · Shift+Enter/Ctrl+J newline · Tab complete a lone
/foo· ↑/↓ prompt history - Esc abort turn → clear draft → deselect · Ctrl+C abort → clear → deselect → quit (never copies) · Ctrl+D quit on empty draft
- Cmd/Super+A select all · Cmd+C/Ctrl+Shift+C copy selection or latest reply · Ctrl+O Explorer diagnostics · ? hotkeys
- Approval gate: y/Enter allow once · a always · b bypass-all · n/Esc deny
Aceleração nativa
Processos críticos de desempenho (compactação de contexto, memória de threads longas, varredura do sistema de arquivos, orquestração de mesclagem, manipulação de imagens) rodam via módulos nativos em Zig carregados pelo Bun FFI, cada um com um fallback em TypeScript. O pacote inclui bibliotecas pré-compiladas para macOS (Apple Silicon) e Linux (x64); outras plataformas usam o fallback. Defina SIFT_NO_NATIVE=1 para forçar os fallbacks e SIFT_CONTEXT_COMPACTION=1 para ativar o medidor de tokens de contexto em tempo real, além da persistência e retomada de threads.
Aparência & som
O /theme oferece 10 esquemas (o padrão é o "sieve" — âmbar quente sobre carvão), salvos em ~/.siftable/appearance.json. O /sounds ativa ou desativa os efeitos sonoros da interface (desativados por padrão), salvos em ~/.siftable/sounds.json e que podem ser sobrescritos com SIFT_SOUNDS.
The copilot is read-only by default; write/edit tools are scoped to the workspace root and gated by a four-way approval prompt (allow once / always / bypass-all / deny). With nothing listening, requests deny. Auto-approve environment overrides are always scrubbed at launch.
Referência completa, incluindo todos os comandos de barra, atalhos de teclado, variáveis de ambiente e arquivos de configuração: docs/interactive.md no GitHub.