MCP Server, CLI & API Reference

Affichez les capacités de la CLI Siftable et son état de préparation

Indexez une base de code (analyse et transfert de fichiers)

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

Affichez les thèmes de commandes adaptés aux agents et les points d'entrée des workflows

Diagnostiquez la configuration locale de la CLI Siftable sans afficher vos secrets

Lancez le copilot de terminal Siftable (sift interactive) : un assistant AI intégré pour vos tâches, votre travail, votre calendrier, vos projets et vos contacts

Générez un diagramme Mermaid dans le terminal (flux, séquence, état, classe, ER, C4, architecture, mindmap). Lit un fichier .mmd ou stdin

Arguments

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

Flags

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

--color <none|truecolor> 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)

Créer un alias d'agent

Flags

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

--capabilities <value> — Capabilities JSON object

--hidden — Hide from normal user-visible lists

--name <value> — Display name

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

--permissions <value> — Default permissions JSON object

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

Désactiver un alias d'agent

Arguments

alias required — Agent alias or ID

Récupérer un alias d'agent

Arguments

alias required — Agent alias or ID

Lister les alias d'agents

Flags

--include-disabled — Include disabled aliases

Mettre à jour un alias d'agent

Arguments

alias required — Agent alias or ID

Flags

--capabilities <value> — Capabilities JSON object

--hidden — Hide from normal user-visible lists

--name <value> — Display name

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

--permissions <value> — Default permissions JSON object

--status <active|disabled> — Alias status

--type <value> — Agent type

--visible — Show in normal user-visible lists

Lister le travail assigné à un alias d'agent

Arguments

alias required — Agent alias or ID

Flags

--limit <value> — Maximum results

--status <value> — Work item status

S'authentifier avec Siftable

Supprimer l'authentification enregistrée

Afficher le statut de l'authentification

Créer un événement de calendrier

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

Supprimer un événement de calendrier

Arguments

id required — Event ID

Flags

-y, --yes — Skip confirmation

Lister les événements de calendrier

Flags

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

--limit <value> — Maximum number of results

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

Mettre à jour un événement du calendrier

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 pour un fichier

Arguments

file required — Relative file path

Flags

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

Actualiser l'index d'expertise développeur d'un dépôt

Arguments

repo required — Repository ID

Obtenir l'historique des commits d'un dépôt

Arguments

repo required — Repository ID

Flags

--limit <value> — Maximum number of results

--path <value> — Filter by file path

Lier une tâche au code (fichier, commit ou dépôt)

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

Supprimer un fait enregistré sur la base de code

Arguments

id required — Memory ID

Flags

-y, --yes — Skip confirmation

Lister les faits enregistrés sur la base de code

Flags

--limit <value> — Maximum number of results

--repo <value> — Repository ID

Rechercher des faits enregistrés sur la base de code

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

Enregistrer un fait sur la base de code

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

Trouver les experts d'une zone du code

Arguments

repo required — Repository ID

area required — Path, glob, or symbol

Flags

--limit <value> — Maximum number of results

Supprimer un dépôt et toutes les données indexées

Arguments

id required — Repository ID

Flags

-y, --yes — Skip confirmation

Indexer une base de code de manière incrémentale via les fichiers modifiés dans 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

Lister les dépôts indexés

Enregistrer une base de code pour l'indexation

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

Recherche sémantique de code

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

Récupérer le dernier instantané d'index d'un dépôt

Arguments

id required — Repository ID

Flags

--branch <value> — Filter by branch

--materialize — Generate a download URL for the snapshot

Vérifier l'état de l'indexation d'un dépôt

Arguments

id required — Repository ID

Collecter le contexte Siftable en lecture seule et git local pour les revues quotidiennes Codex

Flags

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

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

--skip-git — Skip local git summary

Ajouter des enregistrements à un jeu de données

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

Agréguer les enregistrements d'un jeu de données avec des métriques groupées (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

Générer des analyses étayées en langage naturel pour un jeu de données

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

Appliquer un plan de diff de jeu de données enregistré

Arguments

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

Flags

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

Archiver un jeu de données sans supprimer sa table physique

Arguments

id required — Dataset ID

Flags

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

Segmenter un champ numérique ou de date en intervalles avec des métriques agrégées par segment

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

Planifier ou appliquer le nettoyage des jeux de données temporaires marqués par un cycle de vie

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

Comparer côte à côte les métriques des segments d'un champ catégoriel

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)

Calculer des champs dérivés à partir d'un jeu de données ou d'un résultat précédent

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

Afficher un schéma de jeu de données et un contrat de capacités lisibles par un agent

Arguments

id required — Dataset ID

Flags

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

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

Créer un jeu de données

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

Identifiez les doublons par clé sans modifier les données

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

Supprimez définitivement un jeu de données et sa table physique

Arguments

id required — Dataset ID

Flags

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

Supprimez un enregistrement d'un jeu de données

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

-y, --yes — Skip confirmation

Prévisualisez les modifications de lignes depuis un fichier CSV, JSON ou 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

Listez les plans de comparaison persistés

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

Affichez un plan de comparaison persisté

Arguments

id required — Diff plan ID

Exportez les enregistrements au format CSV, JSON, JSONL ou 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

Affichez les résumés des facettes pour les champs du jeu de données

Arguments

id required — Dataset ID

Flags

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

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

Calculez les champs de formule et prévisualisez les mises à jour

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

Récupérez les détails et le schéma du jeu de données

Arguments

id required — Dataset ID

Expliquez l'impact des formules, graphiques, vues, de la qualité et de la matérialisation du jeu de données

Arguments

id required — Dataset ID

Flags

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

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

Importez des lignes CSV, JSON ou JSONL dans un jeu de données nouveau ou existant

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

Joignez un jeu de données à lui-même via des champs avec alias comme left.Close et 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

Listez les jeux de données

Flags

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

Recherchez des enregistrements par correspondance exacte clé/valeur

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

Matérialisez un résultat dérivé dans un nouveau jeu de données temporaire

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

Créez un résumé de type pivot à partir des métriques groupées du jeu de données

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

Validez et normalisez une charge utile de graphique légère à partir d'un résultat dérivé

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

Affichez les informations de profil d'un jeu de données

Arguments

id required — Dataset ID

Flags

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

Interrogez les enregistrements d'un jeu de données

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

Classez les enregistrements d'un jeu de données par tri ou via une formule numérique pondérée

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

Comparez deux jeux de données par clé sans les modifier

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

Modifiez le schéma d'un jeu de données (ajout, mise à jour ou suppression de champs)

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

Recherchez des enregistrements dans les champs textuels sélectionnés

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

Obtenez un résumé d'un jeu de données (nombre de lignes, champs, exemples de lignes)

Arguments

id required — Dataset ID

Listez les modèles de jeux de données intégrés

Affichez le schéma d'un modèle de jeu de données intégré

Arguments

template required — Template name

Analysez les séries temporelles d'un jeu de données : lag, pct_change, fenêtres glissantes, drawdown, volatilité et corrélation

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

Mettre à jour un enregistrement dans un jeu de données

Arguments

id required — Dataset ID

record-id required — Record ID

Flags

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

Valider un jeu de données par rapport à un modèle intégré

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

Importer un document (PDF, Markdown ou texte) sous forme de note

Arguments

file required — Path to file

Flags

--project <value> — Project ID

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

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

Ajouter un participant à un événement de recherche existant

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

Créer un fait de chronologie pour un événement de recherche avec des participants

Flags

--body <value> — Event notes/body

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

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

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

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

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

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

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

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

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

--timestamp <value> — ISO timestamp

--title <value> required — Event title

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

--year <value> — Historical year CE

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

Lister les faits chronologiques des événements de recherche

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

Appliquer un plan de diff Evidence Graph révisé

Arguments

id required — Persisted diff plan ID

Flags

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

Expliquer les conséquences d'un plan de diff enregistré sur l'Evidence Graph

Arguments

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

Flags

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

Lister les plans de diff Evidence Graph enregistrés

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

Afficher un plan de diff Evidence Graph avec un résumé contextuel

Arguments

id required — Persisted diff plan ID

Créer une tâche d'agent (sans application) pour l'extraction de candidats 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

Créer un projet Evidence Graph et des tables de travail basées sur des jeux de données

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

Planifiez un workflow Evidence Graph avant d'écrire l'état de confiance

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

Simulez la chronologie et la projection des relations de l'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

Générez un rapport de preuve Evidence Graph à partir d'un paquet de preuves basé sur un jeu de données

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

Importez les lignes du registre source Evidence Graph dans une table source basée sur un jeu de données

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

Vérifiez la provenance, la révision, la projection et les invariants de citation de l'Evidence Graph

Flags

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

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

Expliquez un chemin délimité dans le graphe entre deux entités

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

Expliquez un chemin délimité dans le graphe entre deux entités

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

Affichez les voisins proches d'une entité dans le graphe

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

Prévisualiser une entité du graphe

Arguments

entity required — Entity reference as type:uuid

Rechercher des entités associables pour le graphe

Arguments

query required — Search query

Flags

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

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

Prévisualiser ou supprimer des notes par lot

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>

Créer une note

Flags

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

--metadata <value> — Note metadata as JSON

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

--project <value> — Project ID

--title <value> required — Note title

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

Supprimer une note

Arguments

id required — Note ID

Flags

-y, --yes — Skip confirmation

Récupérer une note avec son contenu complet

Arguments

id required — Note ID

Lister les notes

Flags

--archived — Filter by archived state

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

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

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

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

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

Rechercher des notes

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

--project <value> — Filter by project ID

Mettre à jour une note

Arguments

id required — Note ID

Flags

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

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

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

--title <value> — Note title

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

Prévisualiser ou supprimer des organisations en masse

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

Créer une organisation

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

Supprimer une organisation

Arguments

id required — Organization ID

Flags

-y, --yes — Skip confirmation

Rechercher des organisations

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

Mettre à jour une organisation

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

Prévisualiser ou supprimer des contacts en masse

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

Créer un contact

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

Supprimer un contact

Arguments

id required — Person ID

Flags

-y, --yes — Skip confirmation

Afficher le profil d'une personne avec ses traits et relations

Arguments

id required — Person ID

Afficher un graphe de relations centré sur une personne

Arguments

id required — Person ID

Flags

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

--include-inactive — Include inactive relationship edges

Expliquer les liens de parenté ou la distance relationnelle entre deux personnes

Arguments

egoPersonId required — Ego/source person ID

targetPersonId required — Target person ID

Flags

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

Lister les contacts

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

Créez ou mettez à jour une relation entre deux personnes

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

Recherchez des contacts

Arguments

query required — Search query

Flags

--contains <value> — Name substring filter

--equals <value> — Exact name filter

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

--limit <value> — Maximum number of results

--relationship <value> — Filter by relationshipToUser

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

Listez les faits de la timeline liés à une personne

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

Mettez à jour un contact

Arguments

id required — Person ID

Flags

--birth-year <value> — Birth year

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

--company <value> — Company name

--email <value> — Email address

--estimated-age <value> — Estimated age

--job-title <value> — Job title

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

--location <value> — Location

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

--name <value> — Full name

--notes <value> — Notes about this person

--phone <value> — Phone number

--relationship <value> — Relationship to user

--website <value> — Personal website

Archivez un projet

Arguments

id required — Project ID

Flags

-y, --yes — Skip confirmation

Obtenez le contexte du projet (tâches, notes, signaux)

Arguments

id required — Project ID

Créez un projet

Flags

--emoji <value> — Single emoji

--name <value> required — Project name

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

--summary <value> — Project summary

Lister les projets

Flags

--include-archived — Include archived projects

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

Obtenir l'instantané de planification CSN canonique d'un projet

Arguments

id required — Project ID

Recalculer l'instantané de planification CSN canonique d'un projet

Arguments

id required — Project ID

Mettre à jour un projet

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

Lister les recettes de workflow de recherche intégrées

Afficher une recette de workflow de recherche intégrée

Arguments

id required — Recipe ID

Créer un projet de recherche et des jeux de données standards

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

Planifier un workflow de recherche déterministe avant l'écriture des données

Arguments

goal required — Research goal

Flags

--project <value> — Existing project ID

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

Générer des tâches d'agent déterministes pour une recette de recherche

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

Vérifier le contexte du projet de recherche et la disponibilité de la CLI

Arguments

project — Project ID

Installez un skillpack Siftable dans un répertoire local de skills

Arguments

id required — Skillpack ID

Flags

--force — Replace an existing installed skill

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

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

Listez les skillpacks Siftable installables

Prévisualisez ou supprimez des tâches en masse

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>

Marquez une tâche comme terminée

Arguments

id required — Task ID

Créez un lien de couplage CSN entre des tâches d'un même projet

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

Supprimez un lien de couplage CSN d'une tâche

Arguments

id required — Task ID

edgeId required — Coupling edge ID

Flags

-y, --yes — Skip confirmation

Lister les liens de couplage CSN d'une tâche

Arguments

id required — Task ID

Créer une tâche de planification humaine

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

Supprimer une tâche

Arguments

id required — Task ID

Flags

-y, --yes — Skip confirmation

Afficher les détails d'une tâche de planification humaine

Arguments

id required — Task ID

Lister les tâches de planification humaine

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

Mettre à jour les champs de planification CSN d'une tâche

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)

Mettre à jour une tâche de planification humaine

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

Créer un fait de timeline rédigé par l'utilisateur

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

Supprimer un fait de la timeline

Arguments

id required — Timeline fact ID

Flags

--yes — Confirm retraction without prompting

Lister les faits de la timeline avec des filtres délimités

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

Générer un résumé narratif ou une explication des faits de la timeline

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

Stocker un nouveau secret chiffré

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

Lister les entrées du coffre-fort (métadonnées uniquement)

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

Recherchez des entrées dans le Vault

Arguments

query required — Search query

Flags

--limit <value> — Maximum number of results

Mettez à jour les métadonnées d'une entrée du 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

Marquez un élément de travail comme bloqué

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

Annulez un élément de travail

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

Récupérez le prochain élément de travail d'agent exécutable disponible

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

Approuvez et terminez un élément de travail d'agent exécutable

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

Créez un élément de travail d'agent exécutable

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

Marquer une tâche comme échouée

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

Afficher les détails d'une tâche d'agent exécutable

Arguments

id required — Work item ID

Prolonger le bail d'une tâche

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

Lister les tâches de l'agent exécutable

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

Libérer une tâche réservée vers la file d'attente

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

Marquer une tâche d'agent comme nécessitant une révision humaine

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

Marquer une tâche comme en cours

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)

Récupérez des tâches à exécuter, lancez une commande de worker local et signalez les artefacts à réviser.

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