MCP Server, CLI & API Reference

اعرض قدرات Siftable CLI وحالة الجاهزية

فهرس قاعدة شيفرة (فحص الملفات ورفعها)

Arguments

id — Repository ID

Flags

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

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

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

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

اعرض مواضيع الأوامر المتوافقة مع الوكلاء ونقاط دخول سير العمل

تشخيص إعدادات Siftable CLI المحلية دون عرض البيانات السرية

تشغيل مساعد Siftable في الطرفية (sift interactive) — مساعد AI مدمج لإدارة مهامك وعملك وتقويمك ومشاريعك وجهات اتصالك

عرض مخطط 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)

إنشاء اسم مستعار للمساعد

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

تعطيل اسم مستعار للمساعد

Arguments

alias required — Agent alias or ID

جلب اسم مستعار للمساعد

Arguments

alias required — Agent alias or ID

عرض قائمة الأسماء المستعارة للمساعدين

Flags

--include-disabled — Include disabled aliases

تحديث اسم مستعار للمساعد

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

عرض المهام المسندة لاسم مستعار للمساعد

Arguments

alias required — Agent alias or ID

Flags

--limit <value> — Maximum results

--status <value> — Work item status

المصادقة مع Siftable

إزالة بيانات المصادقة المخزنة

عرض حالة المصادقة

إنشاء حدث في التقويم

Flags

--description <value> — Event description

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

--location <value> — Event location

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

--title <value> required — Event title

حذف حدث من التقويم

Arguments

id required — Event ID

Flags

-y, --yes — Skip confirmation

عرض قائمة أحداث التقويم

Flags

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

--limit <value> — Maximum number of results

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

تحديث حدث في التقويم

Arguments

id required — Event ID

Flags

--description <value> — Event description

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

--location <value> — Event location

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

--title <value> — Event title

إجراء Git blame لملف

Arguments

file required — Relative file path

Flags

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

تحديث فهرس خبرات المطورين لمستودع

Arguments

repo required — Repository ID

جلب سجل الالتزامات لمستودع

Arguments

repo required — Repository ID

Flags

--limit <value> — Maximum number of results

--path <value> — Filter by file path

ربط مهمة بالشيفرة البرمجية (ملف، أو commit، أو مستودع)

Arguments

task-id required — Task ID

Flags

--commit <value> — Commit SHA

--file <value> — File path

--notes <value> — Notes about the link

--repo <value> required — Repository ID

حذف حقيقة مخزنة عن قاعدة الشيفرة

Arguments

id required — Memory ID

Flags

-y, --yes — Skip confirmation

عرض قائمة الحقائق المخزنة عن قاعدة الشيفرة

Flags

--limit <value> — Maximum number of results

--repo <value> — Repository ID

ابحث في حقائق قاعدة الشيفرة المخزنة

Arguments

query required — Search query

Flags

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

--limit <value> — Maximum number of results

--repo <value> — Repository ID

احفظ حقيقة في قاعدة الشيفرة

Flags

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

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

--file <value> — Related file path

--repo <value> — Repository ID

اعثر على خبراء في جزء معين من الشيفرة البرمجية

Arguments

repo required — Repository ID

area required — Path, glob, or symbol

Flags

--limit <value> — Maximum number of results

احذف مستودعًا وجميع البيانات المفهرسة

Arguments

id required — Repository ID

Flags

-y, --yes — Skip confirmation

فهرس قاعدة الشيفرة تدريجيًا باستخدام ملفات git المتغيرة

Arguments

id required — Repository ID

Flags

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

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

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

اعرض قائمة بالمستودعات المفهرسة

سجّل قاعدة شيفرة لفهرستها

Flags

--auto-index — Enable automatic indexing

--name <value> required — Repository name

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

--project <value> — Project ID to associate

بحث دلالي في الشيفرة

Arguments

query required — Search query

Flags

--language <value> — Filter by language

--limit <value> — Maximum number of results

--project <value> — Project ID

--repo <value> — Repository ID

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

جلب أحدث لقطة لفهرس المستودع

Arguments

id required — Repository ID

Flags

--branch <value> — Filter by branch

--materialize — Generate a download URL for the snapshot

التحقق من حالة فهرسة المستودع

Arguments

id required — Repository ID

جمع سياق Siftable (للقراءة فقط) وسياق git المحلي لمراجعات العمل اليومية في Codex

Flags

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

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

--skip-git — Skip local git summary

إضافة سجلات إلى مجموعة بيانات

Arguments

id required — Dataset ID

Flags

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

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

تجميع سجلات مجموعة البيانات بمقاييس مجمعة (العدد، المتوسط، المجموع، الحد الأدنى، الحد الأقصى، الوسيط، الانحراف المعياري، المئوية، النسبة)

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

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

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

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

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

--sorts <value> — JSON array of sorts

توليد رؤى دقيقة باللغة الطبيعية لمجموعة بيانات

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

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

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

--mode <descriptive|operational> — Analysis mode

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

تطبيق خطة فروقات محفوظة لمجموعة بيانات

Arguments

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

Flags

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

أرشفة مجموعة بيانات دون حذف جدولها الفعلي

Arguments

id required — Dataset ID

Flags

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

تقسيم حقل رقمي أو تاريخي إلى فئات مع مقاييس تجميعية لكل فئة

Arguments

id required — Dataset ID

Flags

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

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

--field <value> required — Field to bucket

--filters <value> — JSON array of filters

--metrics <value> — JSON array of metrics

تخطيط أو تنفيذ تنظيف مجموعات البيانات المؤقتة الموسومة بدورة الحياة

Flags

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

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

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

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

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

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

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

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

مقارنة المقاييس عبر شرائح حقل فئوي جنبًا إلى جنب

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

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

--metrics <value> — JSON array of metrics

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

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

حساب حقول مشتقة من مجموعة بيانات أو من نتيجة مشتقة سابقة

Arguments

id — Dataset ID

Flags

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

--filters <value> — JSON array of filters

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

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

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

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

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

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

عرض مخطط مجموعة البيانات وعقد الإمكانيات بصيغة قابلة للقراءة من قِبل الوكيل

Arguments

id required — Dataset ID

Flags

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

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

إنشاء مجموعة بيانات

Flags

--description <value> — Dataset description

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

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

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

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

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

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

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

--title <value> required — Dataset title

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

البحث عن السجلات المكررة في مجموعة البيانات حسب المفتاح دون تعديل البيانات

Arguments

id required — Dataset ID

Flags

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

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

حذف مجموعة بيانات نهائيًا وإسقاط جدولها الفعلي

Arguments

id required — Dataset ID

Flags

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

حذف سجل من مجموعة بيانات

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

-y, --yes — Skip confirmation

معاينة تغييرات صفوف مجموعة البيانات من ملف CSV أو JSON أو JSONL

Arguments

id required — Dataset ID

Flags

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

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

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

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

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

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

عرض خطط فروق مجموعة البيانات المحفوظة

Flags

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

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

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

عرض خطة فروق مجموعة بيانات محفوظة

Arguments

id required — Diff plan ID

تصدير سجلات مجموعة البيانات المحدودة بصيغة CSV أو JSON أو JSONL أو Markdown

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

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

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

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

--sorts <value> — JSON array of sorts

عرض ملخصات الأوجه المحدودة لحقول مجموعة البيانات

Arguments

id required — Dataset ID

Flags

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

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

حساب حقول الصيغ ومعاينة تحديثات مجموعة البيانات القابلة للمراجعة

Arguments

id required — Dataset ID

Flags

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

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

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

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

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

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

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

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

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

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

جلب تفاصيل مجموعة البيانات ومخططها

Arguments

id required — Dataset ID

شرح تأثير صيغة مجموعة البيانات ورسمها البياني وعرضها وجودتها وعملية الـ materialization

Arguments

id required — Dataset ID

Flags

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

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

استيراد صفوف CSV أو JSON أو JSONL إلى مجموعة بيانات جديدة أو موجودة

Arguments

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

Flags

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

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

--description <value> — Dataset description

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

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

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

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

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

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

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

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

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

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

--yes — Confirm mutating imports without prompting

ربط مجموعة بيانات بنفسها باستخدام حقول بأسماء مستعارة مثل left.Close و right.Close

Arguments

id required — Dataset ID

Flags

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

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

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

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

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

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

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

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

--sorts <value> — JSON array of sorts

عرض مجموعات البيانات

Flags

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

البحث عن سجلات مجموعة البيانات عبر مطابقة دقيقة للمفتاح والقيمة

Arguments

id required — Dataset ID

Flags

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

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

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

تحويل نتيجة مشتقة إلى مجموعة بيانات مسودة جديدة (materialize)

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

إنشاء ملخص بنمط pivot من مقاييس مجموعة البيانات المجمعة

Arguments

id required — Dataset ID

Flags

--cols <value> required — Column field

--filters <value> — JSON array of filters

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

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

--rows <value> required — Row field

التحقق من صحة وتوحيد بيانات الرسم البياني من نتيجة مشتقة

Flags

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

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

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

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

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

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

عرض معلومات ملف التعريف المحدودة لمجموعة بيانات

Arguments

id required — Dataset ID

Flags

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

استعلم عن السجلات في مجموعة بيانات

Arguments

id required — Dataset ID

Flags

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

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

--include-deleted — Include soft-deleted records

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

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

رتب سجلات مجموعة البيانات حسب عمليات الفرز أو صيغة رقمية مرجحة

Arguments

id required — Dataset ID

Flags

--filters <value> — JSON array of filters

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

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

--sorts <value> — JSON array of sorts

قارن بين مجموعتي بيانات بواسطة المفتاح دون تعديل أي منهما

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

عدّل مخطط مجموعة البيانات (إضافة الحقول أو تحديثها أو حذفها)

Arguments

id required — Dataset ID

Flags

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

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

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

ابحث في سجلات مجموعة البيانات ضمن الحقول النصية المختارة

Arguments

id required — Dataset ID

query required — Search text

Flags

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

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

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

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

احصل على ملخص لمجموعة البيانات (عدد الصفوف، والحقول، وعينات من الصفوف)

Arguments

id required — Dataset ID

اسرد قوالب مجموعات البيانات المدمجة

اعرض مخطط قالب مدمج لمجموعة بيانات

Arguments

template required — Template name

حلل السلاسل الزمنية لمجموعة البيانات باستخدام lag وpct_change وrolling windows وdrawdown وvolatility وcorrelation

Arguments

id required — Dataset ID

Flags

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

--filters <value> — JSON array of filters

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

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

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

--pivot — Emit explicit pivoted output

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

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

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

تحديث سجل في مجموعة بيانات

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

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

التحقق من صحة مجموعة بيانات مقابل قالب مدمج

Arguments

id required — Dataset ID

Flags

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

رفع مستند (PDF أو Markdown أو نص) كملاحظة

Arguments

file required — Path to file

Flags

--project <value> — Project ID

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

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

إرفاق شخص مشارك بحدث بحثي موجود

Arguments

event required — Existing temporal fact ID

person required — Person UUID to attach

Flags

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

--yes — Confirm participant attachment without prompting

إنشاء حقيقة في الجدول الزمني لحدث بحثي مع مشاركين

Flags

--body <value> — Event notes/body

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

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

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

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

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

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

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

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

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

--timestamp <value> — ISO timestamp

--title <value> required — Event title

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

--year <value> — Historical year CE

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

عرض حقائق الجدول الزمني لأحداث البحث

Flags

--cursor <value> — Pagination cursor

--end <value> — End boundary

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

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

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

--person <value> — Filter by person UUID

--q <value> — Text search query

--start <value> — Start boundary

تطبيق خطة فروقات مخطط الأدلة المراجعة

Arguments

id required — Persisted diff plan ID

Flags

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

شرح تبعات مخطط الأدلة لخطة فروقات محفوظة

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

عرض خطط فروقات مخطط الأدلة المحفوظة

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

عرض خطة فروقات مخطط الأدلة مع ملخص مدرك للمجال

Arguments

id required — Persisted diff plan ID

إنشاء مهام عمل للوكيل لاستخراج مرشحي مخطط الأدلة دون تطبيق

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

إنشاء مشروع مخطط الأدلة وجداول عمل مدعومة بمجموعة بيانات

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

خطط لسير عمل مخطط الأدلة قبل كتابة الحالة الموثوقة

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

أجرِ تشغيلاً تجريبياً للجدول الزمني وتوقعات العلاقات في مخطط الأدلة

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

أنشئ تقرير إثبات لمخطط الأدلة من حزمة أدلة مدعومة بمجموعة بيانات

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

استورد صفوف سجل المصادر لمخطط الأدلة إلى جدول مصادر مدعوم بمجموعة بيانات

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

تحقق من أصل مخطط الأدلة والمراجعة والتوقعات وثوابت الاقتباس

Flags

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

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

شرح مسار الرسم البياني المحدود بين كيانين

Arguments

source required — Source entity reference as type:uuid

target required — Target entity reference as type:uuid

Flags

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

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

شرح مسار الرسم البياني المحدود بين كيانين

Arguments

source required — Source entity reference as type:uuid

target required — Target entity reference as type:uuid

Flags

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

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

عرض الكيانات المجاورة في الرسم البياني لكيان معين

Arguments

entity required — Entity reference as type:uuid

Flags

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

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

معاينة كيان واحد في الرسم البياني

Arguments

entity required — Entity reference as type:uuid

البحث عن كيانات قابلة للربط للعمل على الرسم البياني

Arguments

query required — Search query

Flags

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

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

معاينة الملاحظات أو حذفها جماعيًا

Flags

--archived — Filter by archived state

--confirm — Execute deletion instead of preview

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

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

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

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

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

إنشاء ملاحظة

Flags

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

--metadata <value> — Note metadata as JSON

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

--project <value> — Project ID

--title <value> required — Note title

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

حذف ملاحظة

Arguments

id required — Note ID

Flags

-y, --yes — Skip confirmation

جلب ملاحظة بمحتواها الكامل

Arguments

id required — Note ID

عرض قائمة الملاحظات

Flags

--archived — Filter by archived state

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

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

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

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

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

بحث في الملاحظات

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

تحديث ملاحظة

Arguments

id required — Note ID

Flags

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

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

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

--title <value> — Note title

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

معاينة المؤسسات أو حذفها جماعيًا

Flags

--confirm — Execute deletion instead of preview

--contains <value> — Name substring filter

--equals <value> — Exact name filter

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

--relationship <value> — Filter by relationship status

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

--type <value> — Filter by organization type

إنشاء مؤسسة

Flags

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

--industry <value> — Industry

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

--location <value> — Location

--name <value> required — Organization name

--notes <value> — Notes

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

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

--website <value> — Website URL

حذف مؤسسة

Arguments

id required — Organization ID

Flags

-y, --yes — Skip confirmation

بحث عن المؤسسات

Arguments

query — Optional fuzzy search query

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationship status

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

--type <value> — Filter by organization type

تحديث مؤسسة

Arguments

id required — Organization ID

Flags

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

--industry <value> — Industry

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

--location <value> — Location

--name <value> — Organization name

--notes <value> — Notes

--relationship-status <value> — Relationship status

--type <value> — Organization type

--website <value> — Website URL

معاينة جهات الاتصال أو حذفها جماعيًا

Flags

--confirm — Execute deletion instead of preview

--contains <value> — Name substring filter

--equals <value> — Exact name filter

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

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

--relationship <value> — Filter by relationshipToUser

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

إنشاء جهة اتصال

Flags

--birth-year <value> — Birth year

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

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

--email <value> — Email address

--estimated-age <value> — Estimated age

--job-title <value> — Job title

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

--location <value> — Location

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

--name <value> required — Full name

--notes <value> — Notes about this person

--phone <value> — Phone number

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

--website <value> — Personal website

حذف جهة اتصال

Arguments

id required — Person ID

Flags

-y, --yes — Skip confirmation

جلب ملف شخصي مع السمات والعلاقات

Arguments

id required — Person ID

عرض مخطط علاقات متمحور حول الشخص

Arguments

id required — Person ID

Flags

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

--include-inactive — Include inactive relationship edges

شرح صلة القرابة أو مسافة العلاقة بين شخصين

Arguments

egoPersonId required — Ego/source person ID

targetPersonId required — Target person ID

Flags

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

عرض قائمة جهات الاتصال

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

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

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationshipToUser

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

إنشاء أو تحديث علاقة بين شخصين

Arguments

personAId required — First person ID

personBId required — Second person ID

Flags

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

--notes <value> — Relationship notes

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

-y, --yes — Apply without prompting

البحث في جهات الاتصال

Arguments

query required — Search query

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

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

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationshipToUser

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

عرض أحداث الجدول الزمني المرتبطة بشخص

Arguments

id required — Person ID

Flags

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

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

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

تحديث جهة اتصال

Arguments

id required — Person ID

Flags

--birth-year <value> — Birth year

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

--company <value> — Company name

--email <value> — Email address

--estimated-age <value> — Estimated age

--job-title <value> — Job title

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

--location <value> — Location

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

--name <value> — Full name

--notes <value> — Notes about this person

--phone <value> — Phone number

--relationship <value> — Relationship to user

--website <value> — Personal website

أرشفة مشروع

Arguments

id required — Project ID

Flags

-y, --yes — Skip confirmation

جلب سياق المشروع (المهام، الملاحظات، الإشارات)

Arguments

id required — Project ID

إنشاء مشروع

Flags

--emoji <value> — Single emoji

--name <value> required — Project name

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

--summary <value> — Project summary

عرض قائمة المشاريع

Flags

--include-archived — Include archived projects

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

جلب لقطة التخطيط المعتمدة (CSN) لمشروع ما

Arguments

id required — Project ID

إعادة حساب لقطة التخطيط المعتمدة (CSN) لمشروع ما

Arguments

id required — Project ID

تحديث مشروع

Arguments

id required — Project ID

Flags

--emoji <value> — Single emoji

--name <value> — Project name

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

--summary <value> — Project summary

عرض قائمة وصفات سير عمل الأبحاث المدمجة

عرض وصفة مدمجة لسير عمل الأبحاث

Arguments

id required — Recipe ID

إنشاء مشروع بحث ومجموعات بيانات قياسية

Arguments

name required — Research project name

Flags

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

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

--yes — Confirm creation without prompting

تخطيط سير عمل بحث حتمي قبل كتابة البيانات

Arguments

goal required — Research goal

Flags

--project <value> — Existing project ID

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

إنشاء عمل وكيل حتمي لوصفة بحث

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

فحص سياق مشروع البحث وجاهزية CLI

Arguments

project — Project ID

تثبيت حزمة مهارات Siftable في دليل مهارات محلي

Arguments

id required — Skillpack ID

Flags

--force — Replace an existing installed skill

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

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

عرض حزم مهارات Siftable القابلة للتثبيت

معاينة المهام أو حذفها جماعيًا

Flags

--confirm — Execute deletion instead of preview

--done — Filter by completed state

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

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

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

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

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

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

تحديد مهمة كمكتملة

Arguments

id required — Task ID

إنشاء رابط اقتران CSN بين مهام في المشروع نفسه

Arguments

id required — Source task ID

target required — Target task ID

Flags

--note <value> — Optional note

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

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

حذف رابط اقتران CSN من مهمة

Arguments

id required — Task ID

edgeId required — Coupling edge ID

Flags

-y, --yes — Skip confirmation

عرض روابط اقتران CSN لمهمة

Arguments

id required — Task ID

إنشاء مهمة تخطيط بشري

Flags

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

--description <value> — Task description

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

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

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

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

--project <value> — Project ID

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

--title <value> required — Task title

حذف مهمة

Arguments

id required — Task ID

Flags

-y, --yes — Skip confirmation

جلب تفاصيل مهمة تخطيط بشري

Arguments

id required — Task ID

عرض مهام التخطيط البشري

Flags

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

--limit <value> — Maximum number of results

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

--project <value> — Filter by project ID

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

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

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

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

تحديث حقول تخطيط CSN لمهمة

Arguments

id required — Task ID

Flags

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

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

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

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

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

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

تحديث مهمة تخطيط بشري

Arguments

id required — Task ID

Flags

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

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

--description <value> — Task description

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

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

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

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

--project <value> — Project ID

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

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

--title <value> — Task title

إنشاء حقيقة في الجدول الزمني من تأليف المستخدم

Flags

--body <value> — Fact body or notes

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

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

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

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

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

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

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

--timestamp <value> — ISO timestamp

--title <value> required — Fact title

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

--year <value> — Historical year CE

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

حذف حقيقة من الجدول الزمني

Arguments

id required — Timeline fact ID

Flags

--yes — Confirm retraction without prompting

عرض حقائق الجدول الزمني باستخدام فلاتر محددة النطاق

Flags

--cursor <value> — Pagination cursor

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

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

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

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

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

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

--q <value> — Text search query

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

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

إنشاء ملخص سردي أو شرح لحقائق الجدول الزمني

Flags

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

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

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

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

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

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

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

--q <value> — Text query filter

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

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

تخزين سر مشفر جديد

Flags

--category <value> — Category

--description <value> — Description

--name <value> required — Secret name

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

--slug <value> — Machine-friendly identifier

--tags <value> — Comma-separated tags

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

--url <value> — Associated URL

عرض مدخلات الخزنة (البيانات الوصفية فقط)

Flags

--category <value> — Filter by category

--limit <value> — Maximum number of results

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

Retired: Vault plaintext reveal is unavailable from the CLI

Arguments

id required — Vault entry ID

البحث في مدخلات الخزنة

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

تحديث البيانات الوصفية لمدخلات الخزنة

Arguments

id required — Vault entry ID

Flags

--category <value> — Category

--description <value> — Description

--name <value> — Entry name

--tags <value> — Comma-separated tags

--url <value> — Associated URL

تحديد عنصر عمل كمتوقف

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

إلغاء عنصر عمل

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

حجز عنصر عمل الوكيل التالي المتاح للتنفيذ

Arguments

id — Optional specific work item ID

Flags

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

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

--owner <value> required — Claim owner identity

اعتماد وإكمال عنصر عمل الوكيل القابل للتنفيذ

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

إنشاء عنصر عمل لوكيل قابل للتنفيذ

Flags

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

--agent <value> — Assigned agent alias

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

--context <value> — Input context JSON object

--project <value> — Linked project ID

--prompt <value> — Agent prompt or instructions

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

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

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

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

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

تحديد عنصر عمل كفاشل

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

جلب تفاصيل عنصر عمل الوكيل القابل للتنفيذ

Arguments

id required — Work item ID

تمديد مدة حجز عنصر العمل

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

عرض قائمة عناصر عمل الوكيل القابل للتنفيذ

Flags

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

--limit <value> — Maximum results

--project <value> — Filter by project ID

--status <value> — Filter by status

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

إعادة عنصر عمل محجوز إلى قائمة الانتظار

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

تحديد عمل الوكيل كمتطلب لمراجعة بشرية

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

تحديد عنصر عمل كقيد التشغيل

Arguments

id required — Work item ID

Flags

--artifacts <value> — Artifact refs JSON array

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

--lease <value> — Lease seconds

--owner <value> — Claim owner identity

--reason <value> — Block or failure reason

--summary <value> — Result summary

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

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

Arguments

id required — Work item ID

Flags

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

--model <value> — Verifier model override

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

استلام المهام القابلة للتنفيذ، وتشغيل أمر العامل المحلي، والإبلاغ عن المخرجات التي تتطلب مراجعة.

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