Documentation Reference · 06

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.

เริ่มต้นใช้งานด่วน

เชื่อมต่อ agent ของคุณได้ภายใน 5 นาที

1. รับ Personal Access Token

ล็อกอินเข้า Siftable ไปที่ Settings → API Tokens แล้วสร้าง token ใหม่ Token ถูก scope — คุณเลือกว่า token เข้าถึงโดเมนไหนได้บ้าง

2. ตั้งค่า MCP client

เพิ่ม Siftable ในการตั้งค่า MCP ของ agent ใช้ได้กับ Claude Code, Cursor, Windsurf และทุก MCP-compatible client

claude_code_config.json
{
  "mcpServers": {
    "siftable": {
      "url": "https://siftable.io/api/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer sift_pat_your_token_here"
      }
    }
  }
}

3. ตรวจสอบการเชื่อมต่อ

ขอให้ agent แสดงรายการโปรเจกต์หรืองานของคุณ ถ้าได้ข้อมูลกลับมา แสดงว่าเชื่อมต่อสำเร็จ

Example agent interaction
# 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

The Siftable CLI gives you the full command surface — 169 commands across every domain — from your terminal. Same API, same data, same permissions, plus an interactive copilot. The binary installs as sift (with siftable and the exf compatibility alias).

1. Install

Terminal
npm install  -g @siftable/cli     # npm · current: @siftable/cli@0.5.29
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.

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

Terminal
$ 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.

การยืนยันตัวตน

Siftable รองรับวิธีการตรวจสอบสิทธิ์สองวิธี ใช้ device flow สำหรับเซสชัน CLI แบบโต้ตอบ หรือใช้ Personal Access Tokens สำหรับไคลเอนต์ MCP และ CI/CD

โฟลว์อุปกรณ์ (CLI)

รัน exf auth login CLI จะเปิดเบราว์เซอร์ของคุณ ให้คุณลงชื่อเข้าใช้ด้วย Google และอนุมัติรหัสอุปกรณ์ PAT จะถูกสร้างขึ้นและจัดเก็บไว้ใน ~/.config/exf/ โดยอัตโนมัติ ไม่ต้องคัดลอกและวางโทเค็น

โทเค็นการเข้าถึงส่วนบุคคล (MCP & API)

สำหรับไคลเอนต์ MCP และการเข้าถึงผ่านโปรแกรม ให้สร้างโทเค็นใน Settings → API Tokens แล้วส่งในส่วนหัว Authorization:

HTTP Header
Authorization: Bearer sift_pat_your_token_here

โทเค็นจะถูกกำหนดขอบเขตตามโดเมนเฉพาะ (เฉพาะงาน, เฉพาะปฏิทิน, การเข้าถึงแบบเต็ม ฯลฯ) สำหรับ CI pipeline ให้ตั้งค่า EXF_PAT เป็นตัวแปรสภาพแวดล้อม

Auth Commands
$ sift auth login
$ sift auth status
$ sift auth logout

ขอบเขตของ Token และการดำเนินการเขียนที่ใช้ได้จะขึ้นอยู่กับการตั้งค่าเวิร์กสเปซและแพ็กเกจของคุณ ตรวจสอบ การตั้งค่า → API Tokens และราคาสำหรับขีดจำกัดปัจจุบันในบัญชีของคุณ

การเชื่อมต่อ MCP

Siftable ใช้ Server-Sent Events (SSE) transport สำหรับ MCP endpoint คือ:

MCP Endpoint
https://siftable.io/api/v1/mcp/sse

ใช้ได้กับทุก MCP client ที่รองรับ SSE transport: Claude Code, Claude Desktop, Cursor, Windsurf, Continue และ custom implementations ที่ใช้ MCP SDK

งาน

Task Domain 6 tools
MCP ToolCLIAccessDescription
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.
CLI Examples
$ 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"}

ปฏิทิน

Calendar Domain 4 tools
MCP ToolCLIAccessDescription
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.
CLI Examples
$ 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

โปรเจกต์

Project Domain 5 tools
MCP ToolCLIAccessDescription
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.

ความรู้

Knowledge Domain 6 tools
MCP ToolCLIAccessDescription
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

Dataset Domain 19 commands

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.

CapabilityCLIAccessDescription
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.
CLI Examples
$ 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"}]'

คน

People Domain 5 tools
MCP ToolCLIAccessDescription
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.

Codebase

Codebase Domain 12 tools

จัดทำ index repository ของคุณสำหรับ semantic code search Siftable แยกโค้ดเป็น symbols และ embeddings สำหรับการค้นหาที่รวดเร็ว

MCP ToolCLIAccessDescription
codebase_list sift codebase list READ List all indexed repositories.
codebase_register sift codebase register WRITE Register a repository for indexing. Set root path, name, include/exclude patterns.
codebase_status sift codebase status READ Check indexing status for a repository.
codebase_index sift codebase WRITE Full index: scan and upload all files matching patterns.
codebase_index_incremental sift codebase incremental WRITE Git-aware incremental index. Only processes changed files since last index.
codebase_search sift codebase search READ Semantic code search. Filter by repository, language, symbol type (function, class, interface, type, export, impl).
codebase_snapshot_status sift codebase snapshot READ Get the latest index snapshot for a repository, optionally filtered by branch or materialized for download.
codebase_delete sift codebase delete DELETE Delete a repository and all indexed code data.
code_who_knows sift code who-knows READ Find developers with expertise in a code area. Based on git history and contribution patterns.
code_compute_expertise sift code expertise WRITE Refresh the expertise index for a repository.
code_history sift code history READ Get commit history. Filter by file path.
git_blame_symbol sift code blame READ Git blame for a file or line range. Shows who last modified each line.
Related Code CLI
$ sift code history <repo-id> --path src/auth/service.ts
$ sift code blame src/auth/service.ts --root .
$ sift code expertise <repo-id>
$ sift code who-knows <repo-id> src/auth
$ sift code link <task-id> --repo <repo-id> --file src/auth/service.ts

Code Memory

Code Memory Domain 4 tools

จัดเก็บและเรียกค้นข้อเท็จจริงเกี่ยวกับ codebase ของคุณ การตัดสินใจด้านสถาปัตยกรรม conventions gotchas ownership — ความรู้ถาวรที่อยู่ข้าม session

MCP ToolCLIAccessDescription
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.

เอกสาร

Document Domain 1 command
MCP ToolCLIAccessDescription
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

Vault Domain 5 tools

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 ToolCLIAccessDescription
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.
CLI Examples
$ 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 read <id>
# Retired: opens no secret. Use the first-party web Vault.

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.

MCP
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")
CLI
$ 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.

CLI
# 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.

MCP (agent prompt)
# 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.
CLI
$ sift calendar list --start 2026-02-26 --end 2026-02-26
$ sift tasks list --status completed --limit 20 --json | jq '.[] | .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.

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

Idempotency

การเขียน (task_create, note_create, calendar_create_event ฯลฯ) รับ parameter idempotencyKey แบบ optional ถ้าคุณส่ง request ซ้ำด้วย key เดิม Siftable จะส่งผลลัพธ์เดิมกลับมาแทนที่จะสร้างซ้ำ

Idempotent task creation
task_create(
  title: "Review PR #247",
  priority: "do_now",
  idempotencyKey: "agent-run-42-task-pr247"
)

# Safe to retry. Same key = same result.

สิทธิ์

Token ถูก scope ตามโดเมน Token สำหรับปฏิทินอย่างเดียวอ่านงานหรือคนไม่ได้ scope token ของคุณให้เข้าถึงน้อยที่สุดเท่าที่ agent ต้องการ

Scope ที่ใช้ได้:

  • tasks:read / tasks:write — Task listing, CRUD, and completion
  • calendar:read / calendar:write — Event listing and creation
  • projects:read / projects:write — Project management and context
  • knowledge:read / knowledge:write — Notes, search, document upload
  • people:read / people:write — Contact search and CRM updates
  • work:read / work:write — Agent work queue items
  • org:read — Workspace org metadata
  • mcp:* — All MCP operations (recommended for IDE and agent use)

การดำเนินการเขียนที่ใช้ได้ขึ้นอยู่กับขอบเขต Token ของคุณและแพ็กเกจเวิร์กสเปซปัจจุบัน ตรวจสอบ Token ที่คุณออกและหน้าราคาปัจจุบันก่อนที่จะพึ่งพาการเขียนในระบบโปรดักชัน

ข้อมูลอ้างอิงคำสั่ง 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).

ทุกคำสั่งรองรับ global flags ต่อไปนี้: --json (เอาต์พุต JSON แบบดิบ), --token / SIFT_TOKEN, --api-url / SIFT_API_URL (ค่าเริ่มต้นคือ https://siftable.io), --workspace / SIFT_WORKSPACE_ID และ --no-input (ปิดการถามตอบ) สำหรับคำสั่งที่มีการลบข้อมูล จำเป็นต้องใช้ --confirm หรือ -y

ทั่วไป

คำสั่งหลักและการวินิจฉัย

6 คำสั่ง
Shellsift
sift capabilities

แสดงความสามารถและสถานะความพร้อมของ Siftable CLI

Shellsift
sift codebase

ทำดัชนีโค้ดเบส (สแกนและอัปโหลดไฟล์)

Arguments
id — Repository ID
Flags
--exclude <value> — Comma-separated exclude glob patterns
--include <value> — Comma-separated include glob patterns
--incremental — Git-aware incremental index (changed files only)
--path <value> — Absolute path to repository root
Shellsift
sift commands

แสดงหัวข้อคำสั่งและจุดเริ่มต้นเวิร์กโฟลว์สำหรับเอเจนต์

Shellsift
sift doctor

วินิจฉัยการตั้งค่า Siftable CLI ในเครื่องโดยไม่แสดงข้อมูลลับ

Shellsift
sift interactive

เปิดใช้งาน Siftable terminal copilot (sift interactive) — ผู้ช่วย AI ในตัวสำหรับจัดการงาน ปฏิทิน โปรเจกต์ และผู้คน

Shellsift
sift mermaid

แสดงไดอะแกรม Mermaid ในเทอร์มินัล (flowchart, sequence, state, class, ER, C4, architecture, mindmap) โดยอ่านจากไฟล์ .mmd หรือ stdin

Arguments
file — Path to a .mmd file (omit to read stdin)
Flags
--ascii — Use ASCII glyphs instead of Unicode box drawing
--color <none|truecolor> default: "truecolor" — Color mode
--height <value> — Fit into an exact N-row pane (pads/clips)
--max-height <value> — Bound the diagram to N rows (no padding)
--max-width <value> — Bound the diagram to N columns (no padding)
--overflow <allow|clip|error> default: "clip" — What to do when the diagram exceeds the bounds
--unicode — Use Unicode box drawing (default)
--width <value> — Fit into an exact N-column pane (pads/clips)

เอเจนท์

นามแฝงเอเจนท์

6 คำสั่ง
Shellsift
sift agents create

สร้างนามแฝงเอเจนท์

Flags
--alias <value> required — Stable alias slug, e.g. codex
--capabilities <value> — Capabilities JSON object
--hidden — Hide from normal user-visible lists
--name <value> — Display name
--operator <value> — Linked daemon/operator ID
--permissions <value> — Default permissions JSON object
--type <value> default: "custom" — Agent type
Shellsift
sift agents disable

ปิดใช้งานนามแฝงเอเจนท์

Arguments
alias required — Agent alias or ID
Shellsift
sift agents get

เรียกดูนามแฝงเอเจนท์

Arguments
alias required — Agent alias or ID
Shellsift
sift agents list

แสดงรายการนามแฝงเอเจนท์

Flags
--include-disabled — Include disabled aliases
Shellsift
sift agents update

อัปเดตนามแฝงเอเจนท์

Arguments
alias required — Agent alias or ID
Flags
--capabilities <value> — Capabilities JSON object
--hidden — Hide from normal user-visible lists
--name <value> — Display name
--operator <value> — Linked daemon/operator ID
--permissions <value> — Default permissions JSON object
--status <active|disabled> — Alias status
--type <value> — Agent type
--visible — Show in normal user-visible lists
Shellsift
sift agents work

แสดงรายการงานที่มอบหมายให้นามแฝงเอเจนท์

Arguments
alias required — Agent alias or ID
Flags
--limit <value> — Maximum results
--status <value> — Work item status

ยืนยันตัวตน

คำสั่งยืนยันตัวตน

3 คำสั่ง
Shellsift
sift auth login

ยืนยันตัวตนกับ Siftable

Shellsift
sift auth logout

ลบข้อมูลการยืนยันตัวตน

Shellsift
sift auth status

แสดงสถานะการยืนยันตัวตน

ปฏิทิน

กิจกรรมในปฏิทิน

4 คำสั่ง
Shellsift
sift calendar create

สร้างกิจกรรมในปฏิทิน

Flags
--description <value> — Event description
--end <value> required — End time (ISO 8601)
--location <value> — Event location
--start <value> required — Start time (ISO 8601)
--title <value> required — Event title
Shellsift
sift calendar delete

ลบกิจกรรมในปฏิทิน

Arguments
id required — Event ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift calendar list

แสดงรายการกิจกรรมในปฏิทิน

Flags
--end <value> — End date (ISO 8601)
--limit <value> — Maximum number of results
--start <value> — Start date (ISO 8601)
Shellsift
sift calendar update

อัปเดตกิจกรรมในปฏิทิน

Arguments
id required — Event ID
Flags
--description <value> — Event description
--end <value> — End time (ISO 8601)
--location <value> — Event location
--start <value> — Start time (ISO 8601)
--title <value> — Event title

โค้ด

เครื่องมือจัดการโค้ด

9 คำสั่ง
Shellsift
sift code blame

Git blame สำหรับไฟล์

Arguments
file required — Relative file path
Flags
--root <value> default: "." — Repository root path
Shellsift
sift code expertise

รีเฟรชดัชนีความเชี่ยวชาญของนักพัฒนาสำหรับเรโพซิทอรี

Arguments
repo required — Repository ID
Shellsift
sift code history

ดูประวัติการ commit ของเรโพซิทอรี

Arguments
repo required — Repository ID
Flags
--limit <value> — Maximum number of results
--path <value> — Filter by file path
Shellsift
sift code link

เชื่อมโยงงานกับโค้ด (ไฟล์, commit หรือเรโพซิทอรี)

Arguments
task-id required — Task ID
Flags
--commit <value> — Commit SHA
--file <value> — File path
--notes <value> — Notes about the link
--repo <value> required — Repository ID
Shellsift
sift code memory delete

ลบข้อมูลโค้ดเบสที่บันทึกไว้

Arguments
id required — Memory ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift code memory list

แสดงรายการข้อมูลโค้ดเบสที่บันทึกไว้

Flags
--limit <value> — Maximum number of results
--repo <value> — Repository ID
Shellsift
sift code memory search

ค้นหาข้อมูลโค้ดเบสที่บันทึกไว้

Arguments
query required — Search query
Flags
--category <architecture|integration|convention|entrypoint|gotcha|ownership> — Filter by category
--limit <value> — Maximum number of results
--repo <value> — Repository ID
Shellsift
sift code memory store

บันทึกข้อมูลโค้ดเบส

Flags
--category <architecture|integration|convention|entrypoint|gotcha|ownership> required — Fact category
--fact <value> required — Fact to store (1-2 sentences)
--file <value> — Related file path
--repo <value> — Repository ID
Shellsift
sift code who-knows

ค้นหาผู้เชี่ยวชาญในส่วนของโค้ด

Arguments
repo required — Repository ID
area required — Path, glob, or symbol
Flags
--limit <value> — Maximum number of results

โค้ดเบส

การทำดัชนีและค้นหาโค้ด

7 คำสั่ง
Shellsift
sift codebase delete

ลบเรพอสิทอรีและข้อมูลดัชนีทั้งหมด

Arguments
id required — Repository ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift codebase incremental

ทำดัชนีโค้ดเบสเพิ่มเติมโดยอ้างอิงไฟล์ที่เปลี่ยนแปลงจาก git

Arguments
id required — Repository ID
Flags
--exclude <value> — Comma-separated exclude glob patterns
--include <value> — Comma-separated include glob patterns
--path <value> required — Absolute path to repository root
Shellsift
sift codebase list

แสดงรายการเรพอสิทอรีที่ทำดัชนีแล้ว

Shellsift
sift codebase register

ลงทะเบียนโค้ดเบสเพื่อทำดัชนี

Flags
--auto-index — Enable automatic indexing
--name <value> required — Repository name
--path <value> required — Absolute path to repository root
--project <value> — Project ID to associate
Shellsift
sift codebase search

ค้นหาโค้ดเชิงความหมาย

Arguments
query required — Search query
Flags
--language <value> — Filter by language
--limit <value> — Maximum number of results
--project <value> — Project ID
--repo <value> — Repository ID
--symbol-type <function|class|interface|type|export|impl> — Filter by symbol type
Shellsift
sift codebase snapshot

ดึงสแนปชอตดัชนีล่าสุดของเรพอสิทอรี

Arguments
id required — Repository ID
Flags
--branch <value> — Filter by branch
--materialize — Generate a download URL for the snapshot
Shellsift
sift codebase status

ตรวจสอบสถานะการทำดัชนีของเรพอสิทอรี

Arguments
id required — Repository ID

Codex

เครื่องมือช่วยจัดการระบบอัตโนมัติใน Codex

1 คำสั่ง
Shellsift
sift codex daily-review collect

รวบรวมบริบท Siftable แบบอ่านอย่างเดียวและ git ในเครื่องสำหรับการรีวิวงานรายวันของ Codex

Flags
--calendar-days <value> default: 7 — Calendar lookahead days
--limit <value> default: 20 — Maximum records per source
--skip-git — Skip local git summary

ชุดข้อมูล

ชุดข้อมูลที่มีโครงสร้าง

41 คำสั่ง
Shellsift
sift datasets add

เพิ่มข้อมูลลงในชุดข้อมูล

Arguments
id required — Dataset ID
Flags
--record <value> repeatable — Record as JSON object, e.g. '{"name":"Alice","age":"30"}'
--records <value> — Multiple records as JSON array
Shellsift
sift datasets aggregate

สรุปผลข้อมูลในชุดข้อมูลด้วยตัวชี้วัดแบบกลุ่ม (count, avg, sum, min, max, median, stddev, percentile, ratio)

Arguments
id required — Dataset ID
Flags
--filters <value> — JSON array of filters
--group-by <value> — Comma-separated field names to group by
--having <value> — JSON array of having clauses [{metric, operator, value}]
--limit <value> default: 100 — Max rows
--metrics <value> — JSON array of metrics [{operation, field, as}]
--sorts <value> — JSON array of sorts
Shellsift
sift datasets analyze

สร้างข้อมูลเชิงลึกด้วยภาษาธรรมชาติที่อ้างอิงข้อมูลจริงจากชุดข้อมูล

Arguments
id required — Dataset ID
Flags
--filters <value> — JSON array of filters
--focus-fields <value> — Comma-separated field names to focus analysis on
--max-insights <value> default: 5 — Max insights to generate
--mode <descriptive|operational> — Analysis mode
--signal-limit <value> — Max decision signals to return
Shellsift
sift datasets apply-diff

ใช้แผนการเปรียบเทียบความต่าง (diff) ของชุดข้อมูลที่บันทึกไว้

Arguments
plan required — Path to a local diff plan or persisted diff plan ID
Flags
--yes — Confirm applying the saved diff plan without prompting
Shellsift
sift datasets archive

เก็บถาวรชุดข้อมูลโดยไม่ลบตารางจริง

Arguments
id required — Dataset ID
Flags
-y, --yes — Confirm dataset archival without prompting
Shellsift
sift datasets bucket

จัดกลุ่มฟิลด์ตัวเลขหรือวันที่เป็นช่วง พร้อมแสดงเมทริกซ์สรุปผลรายกลุ่ม

Arguments
id required — Dataset ID
Flags
--boundaries <value> — Comma-separated boundary values (omit for auto-bucketing)
--bucket-count <value> — Number of auto-buckets (default: 5)
--field <value> required — Field to bucket
--filters <value> — JSON array of filters
--metrics <value> — JSON array of metrics
Shellsift
sift datasets cleanup

วางแผนหรือดำเนินการล้างชุดข้อมูลชั่วคราวที่ติดแท็กวงจรชีวิต

Flags
--dry-run — Return a deterministic cleanup plan without deleting datasets
--lifecycle <value> — Lifecycle kind to clean, e.g. scratch, benchmark, research-run
--limit <value> default: 100 — Maximum lifecycle datasets to inspect
--now <value> — Deterministic timestamp for tests and scheduled cleanup
--older-than <value> — Only include datasets older than this duration, e.g. 12h, 7d
--orphaned — Include stale dataset notes that no longer have a backing dataset row
--tag <value> — Lifecycle tag to clean, e.g. benchmark
-y, --yes — Confirm deletion when applying cleanup with --no-dry-run
Shellsift
sift datasets compare

เปรียบเทียบเมทริกซ์ตามหมวดหมู่แบบเคียงข้างกัน

Arguments
id required — Dataset ID
Flags
--filters <value> — JSON array of filters
--limit <value> default: 10 — Max segment values to compare
--metrics <value> — JSON array of metrics
--segment-field <value> required — Categorical field to segment by
--segment-values <value> — Comma-separated segment values (auto-discovers if omitted)
Shellsift
sift datasets compute

คำนวณฟิลด์ที่ดัดแปลงมาจากชุดข้อมูลหรือผลลัพธ์ก่อนหน้า

Arguments
id — Dataset ID
Flags
--computed-fields <value> required — JSON array of computed fields, e.g. '[{"as":"spread","expression":"right.Close-left.Close"}]'
--filters <value> — JSON array of filters
--limit <value> default: 50 — Maximum rows
--order-by <value> — JSON array of order clauses
--select <value> — Comma-separated fields to include
--sorts <value> — JSON array of output sorts
--source-result <value> — Inline JSON for a prior derived result
--source-result-file <value> — Path to a JSON file containing a prior derived result
Shellsift
sift datasets contract

แสดงสกีมาและข้อกำหนดความสามารถของชุดข้อมูลที่ AI อ่านได้

Arguments
id required — Dataset ID
Flags
--resolve <value> — Comma-separated semantic field references to resolve
--template <value> — Validate contract against a built-in template
Shellsift
sift datasets create

สร้างชุดข้อมูล

Flags
--description <value> — Dataset description
--fields <value> — Field definitions as JSON array, e.g. '[{"name":"age","type":"number"}]'
--lifecycle <value> — Lifecycle kind for generated datasets, e.g. scratch, benchmark, research-run
--metadata <value> — Dataset metadata as JSON object
--note-id <value> — Link to an existing note
--run-id <value> — Lifecycle run identifier
--scratch — Shortcut for --lifecycle scratch --tags scratch
--tags <value> — Comma-separated lifecycle tags
--title <value> required — Dataset title
--ttl <value> — Lifecycle TTL duration, e.g. 12h, 7d, 30d
Shellsift
sift datasets dedupe

ค้นหารายการที่ซ้ำใน dataset ตาม key โดยไม่แก้ไขข้อมูล

Arguments
id required — Dataset ID
Flags
--key <value> required — Field name used to group duplicates
--limit <value> default: 500 — Maximum records to scan in one bounded pass
Shellsift
sift datasets delete

ลบ dataset อย่างถาวรและลบ physical table

Arguments
id required — Dataset ID
Flags
-y, --yes — Confirm dataset deletion without prompting
Shellsift
sift datasets delete-record

ลบรายการออกจาก dataset

Arguments
id required — Dataset ID
record-id required — Record ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift datasets diff

ดูตัวอย่างการเปลี่ยนแปลงข้อมูลใน dataset จากไฟล์ CSV, JSON หรือ JSONL

Arguments
id required — Dataset ID
Flags
--batch-size <value> default: 100 — Records per backend batch
--from-file <value> required — Path to CSV, JSON, or JSONL rows to compare
--persist — Persist the diff plan in Siftable for later review/apply
--save-plan <value> — Write an applyable diff plan JSON file
--template <sources|people|events|claims|evidence_sources|evidence_source_fragments|evidence_claims|evidence_people|evidence_organizations|evidence_places|evidence_artifacts|evidence_events|evidence_relationships|evidence_contradictions> — Built-in template name
--upsert-by <value> — Field name used to match existing rows
Shellsift
sift datasets diff-plans list

แสดงรายการ dataset diff plan ที่บันทึกไว้

Flags
--dataset-id <value> — Filter by dataset ID
--limit <value> default: 50 — Maximum plans to return
--status <draft|validated|applied|rejected|expired> — Filter by plan status
Shellsift
sift datasets diff-plans show

แสดง dataset diff plan ที่บันทึกไว้

Arguments
id required — Diff plan ID
Shellsift
sift datasets export

ส่งออกรายการใน dataset เป็นไฟล์ CSV, JSON, JSONL หรือ Markdown

Arguments
id required — Dataset ID
Flags
--filters <value> — JSON array of filters
--format <csv|json|jsonl|markdown> default: "csv" — Export format
--limit <value> default: 500 — Max rows to export
-o, --output <value> — Output file path (writes to stdout if omitted)
--sorts <value> — JSON array of sorts
Shellsift
sift datasets facets

แสดงข้อมูลสรุป facet ของฟิลด์ใน dataset

Arguments
id required — Dataset ID
Flags
--fields <value> — Comma-separated field names to facet
--limit <value> default: 20 — Maximum values per facet
Shellsift
sift datasets formula-plan

คำนวณฟิลด์สูตรและดูตัวอย่างการอัปเดต dataset

Arguments
id required — Dataset ID
Flags
--computed-fields <value> required — JSON array of computed fields, e.g. '[{"as":"score","expression":"confidence * reliability"}]'
--filters <value> — JSON array of filters for compute source
--limit <value> default: 100 — Maximum rows to compute and plan
--order-by <value> — JSON array of order clauses
--save-plan <value> — Write an applyable diff plan JSON file
--select <value> — Comma-separated fields to include in compute source
--sorts <value> — JSON array of output sorts
--target-fields <value> — Comma-separated computed field names to write; defaults to every computed field alias
--template <sources|people|events|claims> — Built-in template name for validation
--upsert-by <value> required — Field used to match rows for update
Shellsift
sift datasets get

เรียกดูรายละเอียดและ schema ของ dataset

Arguments
id required — Dataset ID
Shellsift
sift datasets impact

อธิบายผลกระทบของสูตร กราฟ มุมมอง คุณภาพ และ materialization ของชุดข้อมูล

Arguments
id required — Dataset ID
Flags
--from-plan <value> — Persisted diff plan ID to inspect
--operation <value> — Committed dataset operation ID to inspect
Shellsift
sift datasets import

นำเข้าแถวข้อมูล CSV, JSON หรือ JSONL ไปยังชุดข้อมูลใหม่หรือที่มีอยู่เดิม

Arguments
file required — Path to CSV, JSON, or JSONL file
Flags
--batch-size <value> default: 100 — Records per backend batch
--dataset-id <value> — Import into existing dataset instead of creating a new one
--description <value> — Dataset description
--dry-run — Validate and plan the import without writing
--lifecycle <value> — Lifecycle kind for generated datasets, e.g. scratch, benchmark, research-run
--metadata <value> — Dataset metadata as JSON object when creating a new dataset
--run-id <value> — Lifecycle run identifier
--scratch — Shortcut for --lifecycle scratch --tags scratch
--tags <value> — Comma-separated lifecycle tags
--template <sources|people|events|claims|evidence_sources|evidence_source_fragments|evidence_claims|evidence_people|evidence_organizations|evidence_places|evidence_artifacts|evidence_events|evidence_relationships|evidence_contradictions> — Built-in template name
--title <value> — Dataset title (defaults to filename)
--ttl <value> — Lifecycle TTL duration, e.g. 12h, 7d, 30d
--upsert-by <value> — Field name used to update matching rows instead of creating duplicates
--yes — Confirm mutating imports without prompting
Shellsift
sift datasets join

Join ชุดข้อมูลกับตัวเองโดยใช้ฟิลด์ที่ระบุ alias เช่น left.Close และ right.Close

Arguments
id required — Dataset ID
Flags
--join-keys <value> required — JSON array of join keys, e.g. '[{"leftField":"Date","rightField":"Date"}]'
--join-type <inner|left|right> default: "inner" — Join type
--left-alias <value> default: "left" — Left alias
--left-filters <value> — JSON array of left-side filters
--limit <value> default: 50 — Maximum joined rows
--right-alias <value> default: "right" — Right alias
--right-filters <value> — JSON array of right-side filters
--select <value> — Comma-separated alias-scoped fields to return
--sorts <value> — JSON array of sorts
Shellsift
sift datasets list

แสดงรายการชุดข้อมูล

Flags
--limit <value> default: 50 — Maximum number of results
Shellsift
sift datasets lookup

ค้นหาเรคคอร์ดในชุดข้อมูลด้วยการจับคู่ key/value ที่ตรงกัน

Arguments
id required — Dataset ID
Flags
--key <value> required — Field name to match
--limit <value> default: 25 — Maximum matching records
--value <value> required — Exact value to match
Shellsift
sift datasets materialize

Materialize ผลลัพธ์ที่ได้ไปยังชุดข้อมูล scratch ใหม่

Flags
--description <value> — Dataset description
--source-result <value> — Inline JSON for a derived result
--source-result-file <value> — Path to a JSON file containing a derived result
--title <value> required — Title of the new dataset
Shellsift
sift datasets pivot

สร้างสรุปแบบ pivot จาก metrics ของชุดข้อมูลที่จัดกลุ่มไว้

Arguments
id required — Dataset ID
Flags
--cols <value> required — Column field
--filters <value> — JSON array of filters
--limit <value> default: 500 — Maximum grouped cells to request
--metrics <value> — JSON metrics array; defaults to count
--rows <value> required — Row field
Shellsift
sift datasets plot

ตรวจสอบและ normalize payload ของพล็อตขนาดเล็กจากผลลัพธ์ที่ได้

Flags
--chart-type <line|bar|scatter> required — Chart type
--series-field <value> — Optional series field
--source-result <value> — Inline JSON for a derived result
--source-result-file <value> — Path to a JSON file containing a derived result
--x-field <value> required — X-axis field
--y-fields <value> required — Comma-separated Y-axis fields
Shellsift
sift datasets profile

แสดงข้อมูลโปรไฟล์แบบจำกัดขอบเขตของชุดข้อมูล

Arguments
id required — Dataset ID
Flags
--sample-limit <value> default: 10 — Number of sample rows to include
Shellsift
sift datasets query

คิวรีข้อมูลจากชุดข้อมูล

Arguments
id required — Dataset ID
Flags
--cursor <value> — Pagination cursor from previous query
--filters <value> — Filter conditions as JSON array, e.g. '[{"field":"status","value":"active"}]'
--include-deleted — Include soft-deleted records
--limit <value> default: 25 — Maximum number of records
--sorts <value> — Sort spec as JSON array, e.g. '[{"field":"name","direction":"asc"}]'
Shellsift
sift datasets rank

จัดลำดับข้อมูลในชุดข้อมูลด้วยการเรียงลำดับหรือสูตรคำนวณแบบถ่วงน้ำหนัก

Arguments
id required — Dataset ID
Flags
--filters <value> — JSON array of filters
--formula <value> — JSON formula object {weights: [{field, weight}]}
--limit <value> default: 25 — Max rows
--sorts <value> — JSON array of sorts
Shellsift
sift datasets reconcile

เปรียบเทียบชุดข้อมูลสองชุดด้วยคีย์โดยไม่เปลี่ยนแปลงข้อมูลเดิม

Arguments
left required — Left dataset ID
right required — Right dataset ID
Flags
--left-key <value> required — Left dataset key field
--limit <value> default: 500 — Maximum rows to scan from each dataset
--right-key <value> — Right dataset key field; defaults to --left-key
Shellsift
sift datasets schema

แก้ไข schema ของชุดข้อมูล (เพิ่ม อัปเดต หรือลบฟิลด์)

Arguments
id required — Dataset ID
Flags
--field <value> — Field definition as JSON, e.g. '{"name":"email","type":"text"}'
--field-id <value> — Field ID (required for update/delete)
--operation <add_field|update_field|delete_field> required — Schema operation
Shellsift
sift datasets search

ค้นหาข้อมูลในชุดข้อมูลจากฟิลด์ประเภทข้อความที่เลือก

Arguments
id required — Dataset ID
query required — Search text
Flags
--fields <value> — Comma-separated fields to search; defaults to profile columns
--filters <value> — JSON array of base filters applied to every field search
--limit <value> default: 25 — Maximum merged records
--per-field-limit <value> default: 25 — Maximum records to request per searched field
Shellsift
sift datasets summarize

ดูสรุปข้อมูลของชุดข้อมูล (จำนวนแถว ฟิลด์ และตัวอย่างข้อมูล)

Arguments
id required — Dataset ID
Shellsift
sift datasets templates list

แสดงรายการเทมเพลตชุดข้อมูลที่มีให้

Shellsift
sift datasets templates show

แสดง schema ของเทมเพลตชุดข้อมูล

Arguments
template required — Template name
Shellsift
sift datasets timeseries

วิเคราะห์ข้อมูลอนุกรมเวลาในชุดข้อมูลด้วย lag, pct_change, rolling windows, drawdown, volatility และ correlation

Arguments
id required — Dataset ID
Flags
--date-field <value> required — Date field name
--filters <value> — JSON array of filters
--limit <value> default: 100 — Maximum output rows
--metrics <value> — JSON array of metric definitions
--order-direction <asc|desc> default: "asc" — Time ordering
--pivot — Emit explicit pivoted output
--segment-field <value> — Optional segment field
--segment-values <value> — Comma-separated segment values
--transforms <value> — JSON array of transform definitions
Shellsift
sift datasets update-record

อัปเดตเรคคอร์ดในชุดข้อมูล

Arguments
id required — Dataset ID
record-id required — Record ID
Flags
--fields <value> required — Field updates as JSON object, e.g. '{"status":"done"}'
Shellsift
sift datasets validate

ตรวจสอบชุดข้อมูลเทียบกับเทมเพลตมาตรฐาน

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

เอกสาร

การอัปโหลดเอกสาร

1 คำสั่ง
Shellsift
sift documents upload

อัปโหลดเอกสาร (PDF, Markdown หรือข้อความ) เป็นโน้ต

Arguments
file required — Path to file
Flags
--project <value> — Project ID
--title <value> — Note title (defaults to filename)
--type <note|concept|meeting|reference|daily|dataset> — Note type

เหตุการณ์

เหตุการณ์การวิจัยที่อ้างอิงจากข้อมูลไทม์ไลน์

3 คำสั่ง
Shellsift
sift events attach-person

เพิ่มผู้เข้าร่วมในเหตุการณ์การวิจัยที่มีอยู่

Arguments
event required — Existing temporal fact ID
person required — Person UUID to attach
Flags
--role <value> default: "subject" — Participant role
--yes — Confirm participant attachment without prompting
Shellsift
sift events create

สร้างข้อมูลไทม์ไลน์เหตุการณ์การวิจัยพร้อมผู้เข้าร่วม

Flags
--body <value> — Event notes/body
--confidence <low|medium|high> — Confidence level
--entity <value> repeatable — Participant/entity as type:uuid or type:uuid:role; repeatable
--org <value> repeatable — Organization UUID participant; repeatable
--person <value> repeatable — Person UUID participant; repeatable
--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era> default: "year" — Temporal precision
--source <value> repeatable — Source entity as type:uuid or type:uuid:role; repeatable
--source-label <value> — Source/provenance label
--source-note <value> — Source/provenance note
--source-url <value> — Source/provenance URL
--timestamp <value> — ISO timestamp
--title <value> required — Event title
--visibility <org_public|private|restricted> — Timeline visibility
--year <value> — Historical year CE
--year-end <value> — Historical end year CE
Shellsift
sift events list

แสดงรายการข้อเท็จจริงในไทม์ไลน์เหตุการณ์การวิจัย

Flags
--cursor <value> — Pagination cursor
--end <value> — End boundary
--entity <value> — Filter by entity ref type:uuid
--limit <value> default: 50 — Maximum events
--order <asc|desc> default: "asc" — Sort order
--person <value> — Filter by person UUID
--q <value> — Text search query
--start <value> — Start boundary

Evidence

การตั้งค่า Evidence Graph และการจัดการเวิร์กโฟลว์การพิสูจน์

11 คำสั่ง
Shellsift
sift evidence diff apply

ปรับใช้แผน diff ของ Evidence Graph ที่ตรวจสอบแล้ว

Arguments
id required — Persisted diff plan ID
Flags
--yes — Confirm applying the reviewed diff plan without prompting
Shellsift
sift evidence diff impact

อธิบายผลกระทบต่อ Evidence Graph จากแผน diff ที่บันทึกไว้

Arguments
id required — Persisted diff plan ID, or local when using --from-file
Flags
--from-file <value> — Local diff plan JSON file to explain without API access
Shellsift
sift evidence diff list

แสดงรายการแผน diff ของ Evidence Graph ที่บันทึกไว้

Flags
--dataset-id <value> — Filter by evidence dataset ID
--limit <value> default: 50 — Maximum plans to return
--project <value> — Filter locally by Evidence Graph project ID when present on plans
--status <draft|validated|applied|rejected|expired> — Filter by plan status
Shellsift
sift evidence diff show

แสดงแผน diff ของ Evidence Graph พร้อมสรุปข้อมูลตามบริบทโดเมน

Arguments
id required — Persisted diff plan ID
Shellsift
sift evidence extract

สร้างงานเอเจนต์แบบ no-apply เพื่อดึงข้อมูล candidate ของ Evidence Graph

Flags
--agent <value> default: "researcher" — Assigned agent alias
--context <value> — Additional input context JSON object
--context-file <value> — Additional input context JSON file
--dry-run — Preview work item payload without writing
--no-apply — Keep extraction in proposed/diff-first mode
--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack
--project <value> — Project ID
--source-dataset <value> required — Evidence sources dataset ID
--targets <value> — Comma-separated extraction targets
--yes — Confirm work item creation without prompting
Shellsift
sift evidence init

สร้างโปรเจกต์ Evidence Graph และตารางงานที่เชื่อมกับชุดข้อมูล

Arguments
name required — Evidence Graph project name
Flags
--dry-run — Preview project/dataset creation without writing
--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack
--yes — Confirm creation without prompting
Shellsift
sift evidence plan

วางแผนเวิร์กโฟลว์ Evidence Graph ก่อนบันทึก trusted state

Arguments
goal required — Evidence Graph goal
Flags
--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack
--project <value> — Existing project ID
--source-dataset <value> — Existing evidence sources dataset ID
Shellsift
sift evidence project

จำลองไทม์ไลน์และการคาดการณ์ความสัมพันธ์ของ Evidence Graph

Flags
--dry-run — Preview projection without writing
--from-file <value> — Local diff plan JSON file to project from without API access
--from-plan <value> — Persisted diff plan ID to project from
--pack <company-origin|family-history|investigation|compliance-evidence|account-history|codebase-history> default: "company-origin" — Evidence workflow pack
--project <value> — Evidence Graph project ID
Shellsift
sift evidence proof report

สร้างรายงานการพิสูจน์ Evidence Graph จากแพ็กเกจหลักฐานที่อ้างอิงชุดข้อมูล

Flags
--format <json|markdown> default: "markdown" — Report format
--from-file <value> required — Evidence packet JSON file to report on
--project <value> — Evidence Graph project ID for report metadata
Shellsift
sift evidence sources import

นำเข้าแถวข้อมูลจากบัญชีแหล่งที่มาของ Evidence Graph ไปยังตารางต้นทาง

Arguments
file required — Path to CSV, JSON, or JSONL source ledger rows
Flags
--batch-size <value> default: 100 — Records per backend batch
--dataset-id <value> — Evidence sources dataset ID
--dry-run — Validate and plan source import without writing
--upsert-by <value> default: "source_id" — Field name used to update matching source rows
--yes — Confirm mutating imports without prompting
Shellsift
sift evidence verify

ตรวจสอบความถูกต้องของแหล่งที่มา การรีวิว การคาดการณ์ และการอ้างอิงของ Evidence Graph

Flags
--from-file <value> required — Evidence packet JSON file to verify
--project <value> — Evidence Graph project ID for report metadata

กราฟ

การค้นหากราฟเอนทิตีและความเชื่อมโยงรอบข้าง

5 คำสั่ง
Shellsift
sift graph between

อธิบายเส้นทางในกราฟระหว่างสองเอนทิตี

Arguments
source required — Source entity reference as type:uuid
target required — Target entity reference as type:uuid
Flags
--depth <value> default: 4 — Maximum path depth, backend clamps to 1-5
--frontier-limit <value> default: 500 — Maximum links to inspect per path expansion, backend clamps to 1-1000
Shellsift
sift graph explain

อธิบายเส้นทางในกราฟระหว่างสองเอนทิตี

Arguments
source required — Source entity reference as type:uuid
target required — Target entity reference as type:uuid
Flags
--depth <value> default: 4 — Maximum path depth, backend clamps to 1-5
--frontier-limit <value> default: 500 — Maximum links to inspect per path expansion, backend clamps to 1-1000
Shellsift
sift graph neighbors

แสดงเอนทิตีที่เชื่อมโยงรอบข้าง

Arguments
entity required — Entity reference as type:uuid
Flags
--depth <value> default: 1 — Graph depth, backend clamps to 1-3
--limit <value> default: 80 — Maximum graph items, backend clamps to 1-200
Shellsift
sift graph preview

ดูตัวอย่างเอนทิตีกราฟ

Arguments
entity required — Entity reference as type:uuid
Shellsift
sift graph search

ค้นหาเอนทิตีที่เชื่อมโยงได้สำหรับงานกราฟ

Arguments
query required — Search query
Flags
--limit <value> default: 20 — Maximum results
--types <value> — Comma-separated entity types

โน้ต

บันทึกความรู้

7 คำสั่ง
Shellsift
sift notes bulk-delete

ดูตัวอย่างหรือลบบันทึกแบบกลุ่ม

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>
Shellsift
sift notes create

สร้างบันทึก

Flags
--content <value> — Note content (markdown)
--metadata <value> — Note metadata as JSON
--metadata-file <value> — Read note metadata JSON from a file
--project <value> — Project ID
--title <value> required — Note title
--type <note|concept|meeting|reference|daily|dataset> — Note type
Shellsift
sift notes delete

ลบบันทึก

Arguments
id required — Note ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift notes get

ดึงข้อมูลบันทึกพร้อมเนื้อหาทั้งหมด

Arguments
id required — Note ID
Shellsift
sift notes list

แสดงรายการบันทึก

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
Shellsift
sift notes search

ค้นหาโน้ต

Arguments
query required — Search query
Flags
--limit <value> — Maximum number of results
--project <value> — Filter by project ID
Shellsift
sift notes update

อัปเดตโน้ต

Arguments
id required — Note ID
Flags
--content <value> — Note content (markdown)
--metadata <value> — Replace note metadata with this JSON object
--metadata-file <value> — Read replacement note metadata JSON from a file
--title <value> — Note title
--type <note|concept|meeting|reference|daily|dataset> — Note type

องค์กร

องค์กรและบริษัท

5 คำสั่ง
Shellsift
sift organizations bulk-delete

ดูตัวอย่างหรือลบองค์กรแบบกลุ่ม

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
Shellsift
sift organizations create

สร้างองค์กร

Flags
--domain <value> — Domain (e.g. acme.com)
--industry <value> — Industry
--linkedin-url <value> — LinkedIn page URL
--location <value> — Location
--name <value> required — Organization name
--notes <value> — Notes
--relationship-status <value> — Relationship status (e.g. prospect, customer, partner, vendor)
--type <value> — Organization type (e.g. company, nonprofit, government, school)
--website <value> — Website URL
Shellsift
sift organizations delete

ลบองค์กร

Arguments
id required — Organization ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift organizations search

ค้นหาองค์กร

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
Shellsift
sift organizations update

อัปเดตองค์กร

Arguments
id required — Organization ID
Flags
--domain <value> — Domain (e.g. acme.com)
--industry <value> — Industry
--linkedin-url <value> — LinkedIn page URL
--location <value> — Location
--name <value> — Organization name
--notes <value> — Notes
--relationship-status <value> — Relationship status
--type <value> — Organization type
--website <value> — Website URL

บุคคล

บุคคลและผู้ติดต่อ

11 คำสั่ง
Shellsift
sift people bulk-delete

ดูตัวอย่างหรือลบผู้ติดต่อแบบกลุ่ม

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
Shellsift
sift people create

สร้างผู้ติดต่อ

Flags
--birth-year <value> — Birth year
--birthday <value> — Birthday (YYYY-MM-DD)
--company <value> — Company name (auto-links to organization if exists)
--email <value> — Email address
--estimated-age <value> — Estimated age
--job-title <value> — Job title
--linkedin-url <value> — LinkedIn profile URL
--location <value> — Location
--mbti <value> — MBTI type (e.g. INTJ, ENFP)
--name <value> required — Full name
--notes <value> — Notes about this person
--phone <value> — Phone number
--relationship <value> — Relationship to user (e.g. friend, colleague, client, mentor)
--website <value> — Personal website
Shellsift
sift people delete

ลบผู้ติดต่อ

Arguments
id required — Person ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift people get

ดึงข้อมูลโปรไฟล์พร้อมคุณลักษณะและความสัมพันธ์

Arguments
id required — Person ID
Shellsift
sift people graph

แสดงกราฟความสัมพันธ์โดยเน้นที่บุคคล

Arguments
id required — Person ID
Flags
--depth <value> default: 2 — Relationship graph depth
--include-inactive — Include inactive relationship edges
Shellsift
sift people kinship

อธิบายลำดับญาติหรือระยะห่างความสัมพันธ์ระหว่างบุคคลสองคน

Arguments
egoPersonId required — Ego/source person ID
targetPersonId required — Target person ID
Flags
--max-depth <value> default: 6 — Maximum relationship depth
Shellsift
sift people list

แสดงรายการผู้ติดต่อ

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
Shellsift
sift people relate

สร้างหรืออัปเดตความสัมพันธ์ระหว่างบุคคล

Arguments
personAId required — First person ID
personBId required — Second person ID
Flags
--dry-run — Preview the relationship payload without writing
--notes <value> — Relationship notes
--type <value> required — Relationship type, e.g. colleague, sibling, spouse, collaborator
-y, --yes — Apply without prompting
Shellsift
sift people search

ค้นหารายชื่อติดต่อ

Arguments
query required — Search query
Flags
--contains <value> — Name substring filter
--equals <value> — Exact name filter
--has-no-email — Only contacts without an email
--limit <value> — Maximum number of results
--relationship <value> — Filter by relationshipToUser
--starts-with <value> — Name prefix filter
Shellsift
sift people timeline

แสดงรายการข้อมูลไทม์ไลน์ที่เชื่อมโยงกับบุคคล

Arguments
id required — Person ID
Flags
--limit <value> default: 50 — Maximum facts to return
--order <asc|desc> default: "asc" — Sort order
--role <value> — Filter by entity role, comma-separated
Shellsift
sift people update

อัปเดตรายชื่อติดต่อ

Arguments
id required — Person ID
Flags
--birth-year <value> — Birth year
--birthday <value> — Birthday (YYYY-MM-DD)
--company <value> — Company name
--email <value> — Email address
--estimated-age <value> — Estimated age
--job-title <value> — Job title
--linkedin-url <value> — LinkedIn profile URL
--location <value> — Location
--mbti <value> — MBTI type (e.g. INTJ, ENFP)
--name <value> — Full name
--notes <value> — Notes about this person
--phone <value> — Phone number
--relationship <value> — Relationship to user
--website <value> — Personal website

โปรเจกต์

การจัดการโปรเจกต์

7 คำสั่ง
Shellsift
sift projects archive

เก็บถาวรโปรเจกต์

Arguments
id required — Project ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift projects context

ดึงบริบทของโปรเจกต์ (งาน, บันทึก, สัญญาณ)

Arguments
id required — Project ID
Shellsift
sift projects create

สร้างโปรเจกต์

Flags
--emoji <value> — Single emoji
--name <value> required — Project name
--status <planning|active|on_hold|blocked|completed> — Project status
--summary <value> — Project summary
Shellsift
sift projects list

แสดงรายการโปรเจกต์

Flags
--include-archived — Include archived projects
--status <planning|active|on_hold|blocked|completed> — Filter by status
Shellsift
sift projects planning

ดึงข้อมูลสแนปชอตการวางแผน CSN หลักของโปรเจกต์

Arguments
id required — Project ID
Shellsift
sift projects planning-recompute

คำนวณสแนปชอตการวางแผน CSN หลักของโปรเจกต์ใหม่

Arguments
id required — Project ID
Shellsift
sift projects update

อัปเดตโปรเจกต์

Arguments
id required — Project ID
Flags
--emoji <value> — Single emoji
--name <value> — Project name
--status <planning|active|on_hold|blocked|completed> — Project status
--summary <value> — Project summary

สูตร

สูตรเวิร์กโฟลว์การวิจัยที่มีมาให้ในตัว

2 คำสั่ง
Shellsift
sift recipes list

แสดงรายการสูตรเวิร์กโฟลว์การวิจัยที่มีมาให้ในตัว

Shellsift
sift recipes show

แสดงรายละเอียดสูตรเวิร์กโฟลว์การวิจัยที่มีมาให้ในตัว

Arguments
id required — Recipe ID

งานวิจัย

การวางแผนและจัดการเวิร์กโฟลว์งานวิจัย

4 คำสั่ง
Shellsift
sift research init

สร้างโปรเจกต์วิจัยและชุดข้อมูลมาตรฐาน

Arguments
name required — Research project name
Flags
--dry-run — Preview project/dataset creation without writing
--template <historical-research> default: "historical-research" — Research template
--yes — Confirm creation without prompting
Shellsift
sift research plan

วางแผนเวิร์กโฟลว์งานวิจัยแบบ Deterministic ก่อนเริ่มเขียนข้อมูล

Arguments
goal required — Research goal
Flags
--project <value> — Existing project ID
--source-dataset <value> — Existing sources dataset ID
Shellsift
sift research run

สร้างงานของเอเจนต์แบบ Deterministic สำหรับสูตรการวิจัย

Arguments
recipe required — Research run recipe
Flags
--agent <value> default: "researcher" — Assigned agent alias
--context <value> — Additional input context JSON object
--context-file <value> — Additional input context JSON file
--dry-run — Preview work item payload without writing
--project <value> — Project ID
--source-dataset <value> — Source dataset ID
--yes — Confirm work item creation without prompting
Shellsift
sift research status

ตรวจสอบบริบทของโปรเจกต์วิจัยและความพร้อมของ CLI

Arguments
project — Project ID

สกิล

Siftable skillpack ที่ติดตั้งได้

2 คำสั่ง
Shellsift
sift skills install

ติดตั้ง Siftable skillpack ลงในไดเรกทอรีสกิลในเครื่อง

Arguments
id required — Skillpack ID
Flags
--force — Replace an existing installed skill
--target <value> default: "skills" — Installed skills directory
-y, --yes — Confirm replacing an existing skill
Shellsift
sift skills list

แสดงรายการ Siftable skillpack ที่ติดตั้งได้

งาน

งานสำหรับการวางแผนโดยมนุษย์

11 คำสั่ง
Shellsift
sift tasks bulk-delete

ดูตัวอย่างหรือลบงานจำนวนมาก

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>
Shellsift
sift tasks complete

ทำเครื่องหมายว่างานเสร็จสิ้นแล้ว

Arguments
id required — Task ID
Shellsift
sift tasks coupling-create

สร้าง CSN coupling edge ระหว่างงานในโปรเจกต์เดียวกัน

Arguments
id required — Source task ID
target required — Target task ID
Flags
--note <value> — Optional note
--strength <value> — Coupling strength (0-1)
--type <info|resource> required — Coupling type
Shellsift
sift tasks coupling-delete

ลบ CSN coupling edge ออกจากงาน

Arguments
id required — Task ID
edgeId required — Coupling edge ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift tasks coupling-list

แสดงรายการ CSN coupling edges สำหรับงาน

Arguments
id required — Task ID
Shellsift
sift tasks create

สร้างงานสำหรับการวางแผนโดยมนุษย์

Flags
--acceptance-criteria <value> — Acceptance criteria (semicolon-separated text, e.g. "tests pass; docs updated")
--description <value> — Task description
--due <value> — Due date (ISO 8601)
--effort <trivial|small|medium|large|epic|unknown> — Effort estimate
--phase <draft|open|in_flight|review|blocked|done|cancelled> — Lifecycle phase
--priority <do_now|schedule|delegate|someday> — Priority level
--project <value> — Project ID
--scope <value> — Scope boundaries (JSON object with include/exclude arrays)
--title <value> required — Task title
Shellsift
sift tasks delete

ลบงาน

Arguments
id required — Task ID
Flags
-y, --yes — Skip confirmation
Shellsift
sift tasks get

ดูรายละเอียดงานสำหรับการวางแผนโดยมนุษย์

Arguments
id required — Task ID
Shellsift
sift tasks list

แสดงรายการงานสำหรับการวางแผนโดยมนุษย์

Flags
--effort <trivial|small|medium|large|epic|unknown> — Filter by effort
--limit <value> — Maximum number of results
--phase <draft|open|in_flight|review|blocked|done|cancelled> — Filter by phase
--project <value> — Filter by project ID
--status <inbox|next_action|in_progress|waiting_for|completed|archived> — Filter by status
--title-contains <value> — Title substring filter
--title-equals <value> — Exact title filter
--title-starts-with <value> — Title prefix filter
Shellsift
sift tasks planning-update

อัปเดตฟิลด์การวางแผน CSN สำหรับงาน

Arguments
id required — Task ID
Flags
--cynefin-confidence <value> — Cynefin confidence (0-1)
--cynefin-domain <clear|complicated|complex|chaotic|aporetic> — Cynefin domain
--cynefin-rationale <value> — Why this domain fits
--cynefin-source <user|assistant|classifier> — Source of the planning classification
--duration-model <value> — Duration model JSON, e.g. {"kind":"point","days":2}
--reversibility <value> — Reversibility score (0-1)
Shellsift
sift tasks update

อัปเดตงานสำหรับการวางแผนโดยมนุษย์

Arguments
id required — Task ID
Flags
--acceptance-criteria <value> — Acceptance criteria (semicolon-separated text, e.g. "tests pass; docs updated")
--blocked-reason <value> — Reason task is blocked
--description <value> — Task description
--due <value> — Due date (ISO 8601)
--effort <trivial|small|medium|large|epic|unknown> — Effort estimate
--phase <draft|open|in_flight|review|blocked|done|cancelled> — Lifecycle phase
--priority <do_now|schedule|delegate|someday> — Priority level
--project <value> — Project ID
--scope <value> — Scope boundaries (JSON object with include/exclude arrays)
--status <inbox|next_action|in_progress|waiting_for|completed|archived> — Task status
--title <value> — Task title

ไทม์ไลน์

ข้อมูลและคำอธิบายไทม์ไลน์

4 คำสั่ง
Shellsift
sift timeline create

สร้างข้อมูลไทม์ไลน์ที่เขียนโดยผู้ใช้

Flags
--body <value> — Fact body or notes
--confidence <low|medium|high> — Confidence level
--entity <value> repeatable — Participant/entity as type:uuid or type:uuid:role; repeatable
--fact-type <value> default: "event" — Fact type
--precision <millisecond|minute|hour|day|month|year|decade|century|millennium|mega_year|era> default: "year" — Temporal precision
--source-label <value> — Source/provenance label
--source-note <value> — Source/provenance note
--source-url <value> — Source/provenance URL
--timestamp <value> — ISO timestamp
--title <value> required — Fact title
--visibility <org_public|private|restricted> — Timeline visibility
--year <value> — Historical year CE
--year-end <value> — Historical end year CE
Shellsift
sift timeline delete

ลบข้อมูลไทม์ไลน์

Arguments
id required — Timeline fact ID
Flags
--yes — Confirm retraction without prompting
Shellsift
sift timeline list

แสดงรายการข้อมูลไทม์ไลน์พร้อมตัวกรองตามขอบเขต

Flags
--cursor <value> — Pagination cursor
--end <value> — End boundary, ISO timestamp or supported historical boundary
--entity <value> — Entity filter as type:uuid
--entity-role <value> — Comma-separated entity roles
--fact-types <value> — Comma-separated fact types
--limit <value> default: 50 — Maximum items to return
--order <asc|desc> default: "asc" — Sort order
--q <value> — Text search query
--source-types <value> — Comma-separated source types
--start <value> — Start boundary, ISO timestamp or supported historical boundary
Shellsift
sift timeline narrative

สร้างสรุปหรือคำอธิบายสำหรับข้อมูลไทม์ไลน์

Flags
--action <summarize|changed_since|led_to|what_next|cross_object> default: "summarize" — Narrative action
--entity <value> — Entity scope as type:uuid
--entity-roles <value> — Comma-separated entity roles
--fact-type <value> — Fact type filter
--limit <value> default: 60 — Maximum timeline facts to include
--participant <value> — Participant filter as type:uuid
--prompt <value> — Question or custom narrative prompt
--q <value> — Text query filter
--related-entity <value> — Related entity as type:uuid
--source-type <value> — Source type filter

Vault

คลังเก็บรหัสลับ

5 คำสั่ง
Shellsift
sift vault create

บันทึกรหัสลับแบบเข้ารหัส

Flags
--category <value> — Category
--description <value> — Description
--name <value> required — Secret name
--payload <value> required — JSON payload to encrypt
--slug <value> — Machine-friendly identifier
--tags <value> — Comma-separated tags
--type <env_var|credential|oauth_token|ssh_key|certificate|note> — Entry type
--url <value> — Associated URL
Shellsift
sift vault list

แสดงรายการในคลัง (เฉพาะเมทาดาตา)

Flags
--category <value> — Filter by category
--limit <value> — Maximum number of results
--type <env_var|credential|oauth_token|ssh_key|certificate|note> — Filter by entry type
Shellsift
sift vault read

Retired: Vault plaintext reveal is unavailable from the CLI

Arguments
id required — Vault entry ID
Shellsift
sift vault search

ค้นหารายการใน Vault

Arguments
query required — Search query
Flags
--limit <value> — Maximum number of results
Shellsift
sift vault update

อัปเดตข้อมูลเมตาของรายการใน Vault

Arguments
id required — Vault entry ID
Flags
--category <value> — Category
--description <value> — Description
--name <value> — Entry name
--tags <value> — Comma-separated tags
--url <value> — Associated URL

งาน

คิวงานของเอเจนต์ที่รันได้

12 คำสั่ง
Shellsift
sift work block

ระบุว่ารายการงานถูกบล็อก

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work cancel

ยกเลิกรายการงาน

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work claim

รับรายการงานของเอเจนต์ที่รันได้ลำดับถัดไป

Arguments
id — Optional specific work item ID
Flags
--agent <value> — Agent alias to claim for
--lease <value> default: 1800 — Lease seconds
--owner <value> required — Claim owner identity
Shellsift
sift work complete

อนุมัติและปิดรายการงานของเอเจนต์ที่รันได้

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work create

สร้างรายการงานของเอเจนต์ที่รันได้

Flags
--acceptance-criteria <value> — Acceptance criteria JSON array or semicolon-separated text
--agent <value> — Assigned agent alias
--allowed-actions <value> — Allowed actions JSON object
--context <value> — Input context JSON object
--project <value> — Linked project ID
--prompt <value> — Agent prompt or instructions
--rank <value> default: 0 — Queue rank
--task <value> — Parent human planning task ID
--title <value> required — Executable work item title
--verify <value> — Verification commands separated by semicolons
--write-scope <value> — Write scope JSON object
Shellsift
sift work fail

ระบุว่ารายการงานล้มเหลว

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work get

ดึงรายละเอียดรายการงานของเอเจนต์ที่รันได้

Arguments
id required — Work item ID
Shellsift
sift work heartbeat

ต่ออายุการถือครองรายการงาน

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work list

แสดงรายการงานของเอเจนต์ที่รันได้

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
Shellsift
sift work release

คืนรายการงานที่จองไว้กลับเข้าคิว

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work review

ระบุว่างานของเอเจนต์ต้องให้คนตรวจสอบ

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work start

ระบุว่ารายการงานกำลังทำงาน

Arguments
id required — Work item ID
Flags
--artifacts <value> — Artifact refs JSON array
--claim-token <value> — Claim token returned by work claim
--lease <value> — Lease seconds
--owner <value> — Claim owner identity
--reason <value> — Block or failure reason
--summary <value> — Result summary
--verification-results <value> — Verification evidence JSON array: [{"command","exitCode","output"?}]
Shellsift
sift work verify

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

Arguments
id required — Work item ID
Flags
--history — List prior verifier runs instead of running a new one
--model <value> — Verifier model override
--reps <value> — Repeated evaluations per criterion (1-8, default 3)

Worker

ตัวรันงานที่ประมวลผลในเครื่อง

1 คำสั่ง
Shellsift
sift worker run

รับงานที่รันได้ รันคำสั่ง Worker ในเครื่อง และรายงานอาร์ติแฟกต์ที่ต้องตรวจสอบ

Flags
--agent <value> required — Agent alias to claim work for
--command <value> required — Local command to run for the claimed work item
--cwd <value> — Fallback working directory for the local command
--lease <value> default: 1800 — Lease seconds
--owner <value> required — Worker owner fingerprint

Copilot แบบโต้ตอบ

คำสั่ง sift interactive จะเปิดผู้ช่วยในเทอร์มินัลสำหรับแชท รันเครื่องมือ แก้ไขโค้ด แยกกิ่งเอเจนท์แบบขนาน วางแผนงาน และเรนเดอร์ไดอะแกรม — ทั้งหมดนี้ทำได้ในเทอร์มินัล โดยทำงานกับระบบไฟล์และกราฟงานของ Siftable

Terminal
$ sift interactive

ข้อกำหนดและการเริ่มต้นใช้งาน

  • ต้องติดตั้ง Bun sift interactive จะเรียกใช้งาน Bun หากยังไม่ได้ติดตั้ง ระบบจะแสดงคำสั่ง curl -fsSL https://bun.sh/install | bash
  • ต้องยืนยันตัวตน — ผ่าน --token, SIFT_TOKEN หรือ sift auth login
  • ระบบประมวลผลทำงานแบบ in-process — ไม่ต้องเปิดใช้งาน daemon แยกต่างหาก
  • การเขียนข้อมูลจะจำกัดขอบเขตอยู่ที่ workspace root — ซึ่งคือโฟลเดอร์ระดับบนสุดที่ใกล้ที่สุดที่มี .git นี่คือขอบเขตที่ /status รายงานและเป็นเส้นทางเขียนข้อมูลที่ระบบบังคับใช้

อินเทอร์เฟซ

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.

คำสั่ง Slash

พิมพ์ / เพื่อเปิดเมนูคำสั่ง คำสั่งที่ซ่อนอยู่ยังคงพิมพ์ใช้งานได้แต่จะไม่แสดงในเมนู

CommandGroupDescription
/help, /hotkeys, /statusSessionCommand list, keyboard shortcuts, and current model/scope/queue status
/cwd [path]SessionShow or change the working directory (recomputes the workspace root)
/copy [last|all|explorer]SessionCopy the latest reply, whole transcript, or latest explorer report to the clipboard
/clear, /quitSessionReset the transcript; exit
/threads [clear], /compactSessionManage the persisted thread; force a context compaction (requires context compaction enabled)
/model [id] [effort]ModelOpen the model picker or select a model and reasoning effort directly
/codex [login|on|use|off|logout|status]ModelControl the Codex (ChatGPT) engine; default subcommand is status
/key <provider> <key>, /key vault <provider>ModelStore a provider API key, or hydrate it from Siftable Vault
/loginModelSiftable device-code login from inside the TUI
/explorerModelConfigure the repo Explorer (context-gathering backend)
/skills [name]SkillsList discovered skills, or print one skill's body
/branchesBranchesOpen the parallel-agent branches hub
/spawn <title> [--rw <globs>|--rw-any|--ro]BranchesStart a child agent branch in its own git worktree with an access mode
/merge, /rebase, /sendback, /rejectBranchesLand, replay, resume, or reject a child branch
/workWorkOpen the work-queue hub (board of agents and items by status)
/plan [objective | work [--apply] [--after SRC:DST] [--limit N] | view]WorkPlan from an objective, or compute a precedence DAG over the agent work queue as a Mermaid graph
/handoff <title> [--agent ..] [--files ..] [--acceptance ..] [--verify ..]WorkCreate a Siftable work item from the current context
/proof <claim>, /remember <fact> --category <..>WorkGather code/test evidence; store durable code memory
/crew [list|show|new|run], /collabCrewsManage and run multi-agent crews; show in-process collaboration sessions
/mermaid [request|file.mmd|source], /viewDiagramsRender Mermaid (NL request, file, or source) in the terminal; open the pannable viewer
/theme, /sounds [on|off]AppearanceOpen the appearance picker; toggle UI sounds

โมเดลและเอนจิน

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.

ทักษะ

ระบบจะค้นหาทักษะจาก SKILL.md (โปรเจกต์ > ผู้ใช้ > ในตัว) จาก <root>/{.sift,.claude,.codex,.agents}/skills, ~/.claude|.codex|.agents/skills, ~/.config/sift/skills และทักษะที่มาพร้อมกับแพ็กเกจ เอเจนต์เรียกใช้ทักษะผ่านเครื่องมือได้ โดยจะมีการแสดงทักษะสูงสุดประมาณ 50 รายการใน system prompt

คีย์ลัด

โอเวอร์เลย์จะรับการกดคีย์บอร์ดก่อน คีย์ลัดจึงขึ้นอยู่กับแต่ละโหมด

  • 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

การเร่งความเร็วด้วย Native

ส่วนที่เน้นประสิทธิภาพ (การบีบอัดบริบท, ความจำเธรดยาว, การสแกนระบบไฟล์, การจัดการการรวมไฟล์, การจัดการรูปภาพ) จะทำงานผ่านโมดูล Zig แบบ native ที่โหลดผ่าน Bun FFI โดยมี TypeScript เป็นระบบสำรอง (fallback) ในทุกส่วน แพ็กเกจนี้มาพร้อมไลบรารีที่บิลด์ไว้ล่วงหน้าสำหรับ macOS (Apple Silicon) และ Linux (x64) ส่วนแพลตฟอร์มอื่นจะใช้ระบบสำรองแทน ตั้งค่า SIFT_NO_NATIVE=1 เพื่อบังคับใช้ระบบสำรอง และ SIFT_CONTEXT_COMPACTION=1 เพื่อเปิดใช้งานตัววัด context-token แบบเรียลไทม์ รวมถึงการบันทึกและกู้คืนเธรด

รูปลักษณ์และเสียง

/theme มีให้เลือก 10 ธีม (ค่าเริ่มต้นคือ "sieve" — สีอำพันอบอุ่นบนพื้นสีถ่าน) บันทึกไว้ที่ ~/.siftable/appearance.json ส่วน /sounds ใช้เปิด/ปิดเสียงประกอบ (ปิดเป็นค่าเริ่มต้น) บันทึกไว้ที่ ~/.siftable/sounds.json และกำหนดทับได้ด้วย 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.

ข้อมูลอ้างอิงฉบับเต็ม รวมถึงคำสั่งสแลช ปุ่มลัด ตัวแปรสภาพแวดล้อม และไฟล์กำหนดค่าทั้งหมด: docs/interactive.md บน GitHub

Give your agent a workspace.