cli-reference.md

Interlinked CLI Command Reference

Overview

Usage: interlinked [options] [command]

Interlinked CLI: local hooks, activity capture, and developer observability

Options:
  -V, --version                              output the version number
  -h, --help                                 display help for command

Commands:
  activity [options]                         Recent activity feed
  adopt [options]                            Bootstrap all ratchet baselines + trigram index from the repo's current state
  allowlist                                  Manage the supply-chain package allowlist (.interlinked/package-allowlist.json)
  attach [options]                           Attach local CLI settings to workspace/agent and link remote identity
  audit                                      Verify tamper-evidence of the guard-decision audit chain in activity.jsonl
  caps [options]                             View, set, and explain quality caps (lines/function-tokens/complexity/CRAP/coverage)
  check [options]                            Scan project for structural issues and optionally run external tool checks (tsc, biome, eslint, semgrep, gitleaks, mypy, ruff, etc.)
  checkpoint [options] [message]             Git checkpoint management
  ci-status [options]                        Surface CI failure-rate patterns from GitHub Actions (uses gh CLI)
  clean [options]                            Remove stale data
  cloud                                      Inspect the cloud governor (reads cloud_governor from config.local.json)
  collect [options]                          Sync external model sessions (Codex) into .interlinked/timeline.jsonl
  compact [options]                          Gzip + archive the synced prefix of activity.jsonl plus the collection/timeline logs (lossless), reclaiming disk
  completions <shell>                        Output shell completion script (bash, zsh, fish)
  context [options]                          Show effective configuration (merged from all sources)
  coverage                                   Per-file coverage ratchet — fails on any file whose coverage drops
  daemons [options]                          List active harness daemons, PID liveness, socket paths, and health
  deadcode [options]                         Scan the whole repo for dead-code candidates: unreachable files, unused import bindings, unused exports
  debt                                       Inspect pair-scoped TDD debts (coverage / red_suite) from the obligation ledger
  design [options] [path]                    Run Impeccable's deterministic design-slop detector (overused fonts, accent stripes, gradient text, AI palettes, bounce easing, broken images, copy tells) on frontend files. Requires the optional `impeccable` CLI on PATH; degrades gracefully when absent. The built-in `design_slop` check covers a regex subset natively.
  disable [options]                          Stand the harness down for this project (recorded); --uninstall to remove hooks + config
  doctest [options]                          Run doctest-tagged (```bash doctest) code blocks in docs and verify they exit 0
  doctor [options]                           Diagnose issues (local + server checks)
  enable [options]                           Install hooks + create .interlinked/ config
  env [options]                              Show supported environment variables and their current values
  experience                                 Agent-readable trajectory export + analysis (trajectory-v1 interop / trajectory-ix.v1 annotated)
  explain [options]                          Reconstruct what happened (narrative view)
  findings                                   Ingest external review findings and drive them to closure
  git                                        Git bridge: metadata, trailers, and notes
  guard                                      File reservation enforcement via git hooks
  handoff [options] <from-agent> <to-agent>  Explicit agent-to-agent handoff with context transfer
  harness                                    Local harness server: guard evaluation, auto-reservations, agent lifecycle
  impact [options]                           Report evidence-classed local impact facts without causal attribution
  inbox [options]                            Show recent messages from the server
  index                                      Manage the trigram search index for grep acceleration
  init [options]                             One-command onboarding: detect clients, configure, login, verify
  install-hooks [options]                    Install agent hooks for detected runners (adapter-based, manifest-driven)
  login [options]                            Authenticate with the server (opens browser)
  logout [options]                           Clear authentication credentials (preserves other config)
  logs [options]                             View local activity log (offline, no server needed)
  mcp                                        Record mediated MCP server protocol traffic
  metrics [options]                          Scan the whole codebase: function tokens, companion-test presence, coverage, complexity, and CRAP
  mode [options] [name]                      Show current enforcement mode, or switch to balanced / strict / lenient
  multi-edit [options] [path]                Apply N old/new string edits atomically to one or more files. Gate runs once on final content. Ambiguity evaluated after prior edits.
  mutation                                   Mutation testing: report-score ratchet, local runner measurement, and experimental durable cloud jobs
  plan                                       Show agent-emitted plans captured from TaskCreate / ExitPlanMode / structured prompts
  query [options] [source]                   Bounded query over .interlinked JSONL logs (blocks/checks/recurrences/costs/… or a .jsonl path)
  recurrence                                 Surface repeating agent behaviors (harness_caught / harness_missed / codebase_existing / tool_failure)
  reload [options]                           One-command dogfood loop: rebuild the CLI from its source checkout, refresh this repo's hooks, restart the daemon — reporting only what actually changed
  reminder                                   File reminder management (warnings when files are touched)
  replay                                     Capture + replay substrate for the RL/eval environment (G1 inference proxy)
  reset [options]                            Nuclear: clear all local state
  resume [options] [checkpoint-id]           Resume from latest or specified checkpoint with context
  rewind [options] [checkpoint-id]           Restore working tree to a checkpoint state
  scanner                                    PII filter (content scanner) — toggle, inspect, audit
  scratch                                    Manage the sanctioned session/agent-script home (<repo>/scratch/)
  search [options] <query>                   Search the local codebase (ripgrep with native fallback)
  semantic                                   Build and query the optional local semantic function index
  send [options] <to> [message]              Send a message to an agent
  setup [options]                            One-command setup: install hooks, configure server, authenticate
  simplify                                   Simplification evidence, explicit recording, and Agent CI handoff preparation
  skill                                      Skill marker management (scopes distilled rules via active_when)
  spec                                       Spec-substrate utilities (fact ledger, review agenda)
  sponsor                                    Opt-in sponsor slot on the statusline (free-sponsor phase)
  status [options]                           Dashboard: local sessions, recent activity, sync status
  structure                                  Generic artifact structure management (manifests, catalogs, adoption)
  sync [options]                             Push locally-buffered events to the server
  tasks                                      Task management via the server
  tdd                                        Inspect and clear TDD cycle state (what the commit gate believes)
  telemetry [options]                        View or tail the local telemetry spool (.interlinked/offline-spool.jsonl)
  trace                                      Agent trace export/import
  trajectory                                 Inspect trajectory snapshots; replay recorded event streams through sequence detectors
  uninstall-hooks [options]                  Remove hooks previously installed via install-hooks (manifest-driven)
  update|upgrade [options]                   Clone or pull from GitHub, rebuild, and link the CLI
  verify [options] [target]                  Run the default high-signal external catalog plus diff-safe inline checks. Target can be a local path, GitHub URL, or any git remote URL.
  verify-changeset [options]                 Preview the content-quality gate (pre_block + biome + tsc diff-overlay) over a PROPOSED changeset WITHOUT writing — the agent-callable self-gate. Input JSON {version:1, changes:[{path,content}|{path,old_string,new_string}|{path,edits}]} via --file or --stdin.
  version                                    Show Interlinked CLI + server version
  viz                                        Baseline-test visualizer — the cells, interlinked (loopback dashboard)
  watch [options]                            Monitor server for pending work (messages, tasks, agents)
  workspace                                  Registry workspace management (ws_ IDs)
  write [options] [path]                     Write file(s) through the content-quality gate (pre_block + biome + tsc diff-overlay). Supports --stdin, --from-file, and --batch <manifest.json> with rollback protection.
  help [command]                             display help for command

Structure

Usage: interlinked structure [options] [command]

Generic artifact structure management (manifests, catalogs, adoption)

Options:
  -h, --help                   display help for command

Commands:
  init [options]               Create interlinked/structure.json and scaffold
                               artifact files
  scan [options]               Build or refresh local generated artifact
                               catalogs
  status [options]             Show adoption coverage, cache staleness, and
                               invalid references
  accept [options]             Promote extracted findings into committed
                               artifact files
  doctor [options]             Validate structure files, cache freshness, and
                               cross-references
  baseline [options] <action>  Manage structure baselines (save, clear, status)
  help [command]               display help for command

structure init

Usage: interlinked structure init [options]

Create interlinked/structure.json and scaffold artifact files

Options:
  --mode <mode>        Structure mode: minimal, standard, strict (default:
                       "standard")
  --with <categories>  Comma-separated artifact categories to scaffold
  --write              Actually write files (default is dry-run)
  --json               Machine-readable output
  -h, --help           display help for command

structure scan

Usage: interlinked structure scan [options]

Build or refresh local generated artifact catalogs

Options:
  --full         Force full rescan
  --incremental  Only refresh changed categories
  --json         Machine-readable output
  -h, --help     display help for command

structure status

Usage: interlinked structure status [options]

Show adoption coverage, cache staleness, and invalid references

Options:
  --json      Machine-readable output
  -h, --help  display help for command

structure accept

Usage: interlinked structure accept [options]

Promote extracted findings into committed artifact files

Options:
  --json      Machine-readable output
  -h, --help  display help for command

structure doctor

Usage: interlinked structure doctor [options]

Validate structure files, cache freshness, and cross-references

Options:
  --json      Machine-readable output
  -h, --help  display help for command

structure baseline

Usage: interlinked structure baseline [options] <action>

Manage structure baselines (save, clear, status)

Options:
  --json      Machine-readable output
  -h, --help  display help for command

Verify

Usage: interlinked verify [options] [target]

Run the default high-signal external catalog plus diff-safe inline checks.
Target can be a local path, GitHub URL, or any git remote URL.

Options:
  --only <tool>            Run one named external check (for example: tsc,
                           biome, oxlint, eslint, semgrep, gitleaks, knip,
                           docs-check, sca)
  --suggestions            Also run scored regex heuristics (sql-injection,
                           perf, quality)
  --json                   Machine-readable output
  --details                Show per-file details for all findings
  --cwd <path>             Project root (default: current directory)
  --branch <ref>           Branch, tag, or commit to check (remote repos)
  --subdir <path>          Only scan a subdirectory (useful for monorepos)
  --skip <checks>          Skip specific checks (comma-separated:
                           semgrep,knip,complexity,silent_catches,...)
  --suppress <entries...>  Suppress a finding: file:check or file:check:reason
  --show-suppressions      List all active suppressions
  --structure              Include generic artifact structure checks
  --structure-only         Run only structure checks
  --adoption-gate          Fail when adopted categories drop below thresholds
  --all-checks             Include broad advisory smell checks and dead-code
                           scans in addition to the default high-signal audit
  --dead-code              Run Supermodel's cloud dead-code analysis (opt-in;
                           requires the `supermodel` CLI)
  -h, --help               display help for command

Metrics

Usage: interlinked metrics [options] [command]

Scan the whole codebase: function tokens, companion-test presence, coverage,
complexity, and CRAP

Options:
  --cwd <path>        Project root (default: current directory)
  --top <n>           Number of function/file token and CRAP hotspots to show
                      (default: 25)
  --include-tests     Include test/spec functions as advisory token
                      measurements
  --json              Machine-readable output (full per-file + per-function)
  --short             One-line summary
  --full              Show every per-file and per-function token measurement
  -h, --help          display help for command

Commands:
  coupling [options]  Change coupling from git history — co-changed file pairs;
                      pairs with no import edge are flagged 'hidden'
  arch [options]      Martin metrics per directory (Ca/Ce/instability) +
                      propagation cost from the import graph
  rework [options]    Churn age from git blame — share of changed lines whose
                      previous version was written in the last --window days

metrics coupling

Usage: interlinked metrics coupling [options]

Change coupling from git history — co-changed file pairs; pairs with no import
edge are flagged 'hidden'

Options:
  --cwd <path>            Project root (default: current directory)
  --since <when>          git --since expression (default: '90 days ago')
  --min-support <n>       Minimum co-change commits per pair (default: 4)
  --max-commit-files <n>  Skip bulk commits touching more files (default: 30)
  --min-strength <pct>    Minimum Tornhill strength percentage (default: 30)
  --limit <n>             Maximum pairs to report (default: 25)
  --json                  Machine-readable output
  --short                 One-line summary
  -h, --help              display help for command

metrics arch

Usage: interlinked metrics arch [options]

Martin metrics per directory (Ca/Ce/instability) + propagation cost from the
import graph

Options:
  --cwd <path>     Project root (default: current directory)
  --depth <n>      Directory fold depth (default: 2)
  --include-tests  Include test files in the edge set
  --json           Machine-readable output
  --short          One-line summary
  -h, --help       display help for command

metrics rework

Usage: interlinked metrics rework [options]

Churn age from git blame — share of changed lines whose previous version was
written in the last --window days

Options:
  --cwd <path>            Project root (default: current directory)
  --days <n>              How far back to scan commits (default: 30)
  --window <n>            Rework age threshold in days (default: 14)
  --max-commits <n>       Commit scan cap (default: 100)
  --max-commit-files <n>  Skip bulk commits touching more files (default: 30)
  --json                  Machine-readable output
  --short                 One-line summary
  -h, --help              display help for command

Harness

Usage: interlinked harness [options] [command]

Local harness server: guard evaluation, auto-reservations, agent lifecycle

Options:
  -h, --help                display help for command

Commands:
  start [options]           Start the harness server (background daemon by
                            default)
  stop [options]            Stop the harness server
  restart [options]         Stop and restart the harness server (picks up
                            config changes)
  status [options]          Show harness status, loaded rules, and active
                            agents
  checks [options]          Show the authoritative check inventory — per-family
                            counts + total (static; no daemon needed)
  health [options]          Check-health report from the recurrence log:
                            repeat-rate per check id, probation candidates
                            (demotion signal)
  test [options] [command]  Fire a synthetic PreToolUse event at the running
                            harness and show its decision. Default: a Bash
                            command. Use --write/--edit to test a file
                            operation.
  reap [options]            List (default) or kill orphan harness daemons.
                            --force to SIGTERM. --all also targets the active
                            daemon.
  clean [options]           Remove stale harness.sock + harness.pid (refuses if
                            a daemon is running)
  mode [options] [name]     Show or switch the operational tier
                            (budget|quality|ci) — drives
                            HARNESS_POST_TIMEOUT_MS
  latency [options]         Show per-event latency report from
                            .interlinked/logs/latency.jsonl
  help [command]            display help for command

harness start

Usage: interlinked harness start [options]

Start the harness server (background daemon by default)

Options:
  --no-daemon        Run in foreground instead of background
  --protocol <mode>  Socket protocol: raw, framed, or dual (default: "dual")
  --session-id <id>  Framed socket session id (default: "default")
  --verbose          Verbose logging
  --json             Machine-readable output
  -h, --help         display help for command

harness stop

Usage: interlinked harness stop [options]

Stop the harness server

Options:
  --json      Machine-readable output
  -h, --help  display help for command

harness restart

Usage: interlinked harness restart [options]

Stop and restart the harness server (picks up config changes)

Options:
  --no-daemon        Run in foreground instead of daemon
  --protocol <mode>  Socket protocol: raw, framed, or dual (default: "dual")
  --session-id <id>  Framed socket session id (default: "default")
  --verbose          Verbose output
  --json             Machine-readable output
  -h, --help         display help for command

harness status

Usage: interlinked harness status [options]

Show harness status, loaded rules, and active agents

Options:
  --json      Machine-readable output
  -h, --help  display help for command

harness test

Usage: interlinked harness test [options] [command]

Fire a synthetic PreToolUse event at the running harness and show its decision.
Default: a Bash command. Use --write/--edit to test a file operation.

Options:
  --tool <name>       Tool name to simulate for the positional command
                      (default: "Bash")
  --write <file>      Simulate a Write to <file> (pair with --from-file or
                      --stdin)
  --from-file <path>  Read the proposed Write content from <path>
  --stdin             Read the proposed Write content from stdin
  --edit <file>       Simulate an Edit to <file> (pair with --old and --new)
  --old <str>         old_string for --edit
  --new <str>         new_string for --edit
  --json              Machine-readable output
  -h, --help          display help for command

Checkpoint

Usage: interlinked checkpoint [options] [command] [message]

Git checkpoint management

Arguments:
  message                        Checkpoint message

Options:
  --agent <name>                 Agent name
  --json                         Machine-readable output
  -h, --help                     display help for command

Commands:
  list [options]                 List checkpoints
  show [options] <id>            Show checkpoint details
  compare [options] <id1> <id2>  Diff two checkpoints
  prune [options]                Remove old checkpoints
  archive [options]              Archive old stash checkpoints to metadata-only

checkpoint list

Usage: interlinked checkpoint list [options]

List checkpoints

Options:
  --agent <name>      Filter by agent
  --since <duration>  e.g. 1h, 1d
  --limit <n>         Max entries
  --json              Machine-readable output
  -h, --help          display help for command

checkpoint show

Usage: interlinked checkpoint show [options] <id>

Show checkpoint details

Options:
  --json      Machine-readable output
  -h, --help  display help for command

checkpoint compare

Usage: interlinked checkpoint compare [options] <id1> <id2>

Diff two checkpoints

Options:
  --json      Machine-readable output
  -h, --help  display help for command

checkpoint prune

Usage: interlinked checkpoint prune [options]

Remove old checkpoints

Options:
  --older-than <days>  Remove checkpoints older than N days
  --keep-latest <n>    Keep the N most recent checkpoints
  --json               Machine-readable output
  -h, --help           display help for command

checkpoint archive

Usage: interlinked checkpoint archive [options]

Archive old stash checkpoints to metadata-only

Options:
  --json      Machine-readable output
  -h, --help  display help for command

Tasks

Usage: interlinked tasks [options] [command]

Task management via the server

Options:
  -h, --help                display help for command

Commands:
  list [options]            List tasks
  create [options] <title>  Create a new task
  show [options] <id>       Show task detail
  claim [options] <id>      Claim a task
  complete [options] <id>   Mark a task as complete
  help [command]            display help for command

tasks list

Usage: interlinked tasks list [options]

List tasks

Options:
  --status <status>   Filter by status
  --assignee <name>   Filter by assignee
  --priority <level>  Filter by priority
  --limit <n>         Max entries
  --json              Machine-readable output
  --short             One-line summary
  --full              Detailed output
  -h, --help          display help for command

tasks create

Usage: interlinked tasks create [options] <title>

Create a new task

Options:
  --description <text>  Task description
  --assignee <name>     Assign to agent
  --priority <level>    Task priority
  --json                Machine-readable output
  -h, --help            display help for command

tasks show

Usage: interlinked tasks show [options] <id>

Show task detail

Options:
  --json      Machine-readable output
  -h, --help  display help for command

tasks claim

Usage: interlinked tasks claim [options] <id>

Claim a task

Options:
  --json      Machine-readable output
  -h, --help  display help for command

tasks complete

Usage: interlinked tasks complete [options] <id>

Mark a task as complete

Options:
  --json      Machine-readable output
  -h, --help  display help for command

Workspace

Usage: interlinked workspace [options] [command]

Registry workspace management (ws_ IDs)

Options:
  -h, --help      display help for command

Commands:
  list [options]  Show workspaces
  switch <id>     Change active workspace
  help [command]  display help for command

workspace list

Usage: interlinked workspace list [options]

Show workspaces

Options:
  --json      Machine-readable output
  -h, --help  display help for command

workspace switch

Usage: interlinked workspace switch [options] <id>

Change active workspace

Options:
  -h, --help  display help for command

Index

Usage: interlinked index [options] [command]

Manage the trigram search index for grep acceleration

Options:
  -h, --help                 display help for command

Commands:
  build [options]            Build a full trigram index from the current
                             codebase
  update [options]           Incrementally update the index from git changes
  status [options]           Show index status and statistics
  query [options] <pattern>  Query the index for candidate files (debug tool)
  help [command]             display help for command

index build

Usage: interlinked index build [options]

Build a full trigram index from the current codebase

Options:
  --cwd <path>              Working directory (default:
                            "<cwd>")
  --max-file-size <bytes>   Skip files larger than this (default: "1048576")
  --stop-threshold <ratio>  Stop trigram threshold (0-1) (default: "0.4")
  -h, --help                display help for command

index update

Usage: interlinked index update [options]

Incrementally update the index from git changes

Options:
  --cwd <path>  Working directory (default:
                "<cwd>")
  -h, --help    display help for command

index status

Usage: interlinked index status [options]

Show index status and statistics

Options:
  --cwd <path>  Working directory (default:
                "<cwd>")
  --json        Output as JSON
  -h, --help    display help for command

index query

Usage: interlinked index query [options] <pattern>

Query the index for candidate files (debug tool)

Options:
  --cwd <path>  Working directory (default:
                "<cwd>")
  --regex       Treat pattern as regex (default: false)
  -h, --help    display help for command

Trace

Usage: interlinked trace [options] [command]

Agent trace export/import

Options:
  -h, --help               display help for command

Commands:
  export [options]         Export local activity as agent trace
  import [options] <file>  Import trace file into local activity
  help [command]           display help for command

trace export

Usage: interlinked trace export [options]

Export local activity as agent trace

Options:
  --since <duration>  e.g. 1h, 1d
  --agent <name>      Filter by agent
  --output <file>     Output file (default: stdout)
  --format <fmt>      Format: json (default) or jsonl
  --json              Machine-readable output
  -h, --help          display help for command

trace import

Usage: interlinked trace import [options] <file>

Import trace file into local activity

Options:
  --json      Machine-readable output
  -h, --help  display help for command

Guard

Usage: interlinked guard [options] [command]

File reservation enforcement via git hooks

Options:
  -h, --help           display help for command

Commands:
  install [options]    Install pre-commit hook for reservation checks
  check [options]      Check files against active reservations
  status [options]     Show guard configuration and hook status
  uninstall [options]  Remove guard hooks
  help [command]       display help for command

guard install

Usage: interlinked guard install [options]

Install pre-commit hook for reservation checks

Options:
  --mode <mode>  warn (default) or block (default: "warn")
  --pre-push     Also install pre-push hook
  --json         Machine-readable output
  -h, --help     display help for command

guard check

Usage: interlinked guard check [options]

Check files against active reservations

Options:
  --files <paths...>  File paths to check (default: staged files)
  --json              Machine-readable output
  -h, --help          display help for command

guard status

Usage: interlinked guard status [options]

Show guard configuration and hook status

Options:
  --json      Machine-readable output
  -h, --help  display help for command

guard uninstall

Usage: interlinked guard uninstall [options]

Remove guard hooks

Options:
  --json      Machine-readable output
  -h, --help  display help for command

Git

Usage: interlinked git [options] [command]

Git bridge: metadata, trailers, and notes

Options:
  -h, --help                 display help for command

Commands:
  context [options]          Show Interlinked metadata for HEAD or a commit
  link-checkpoint [options]  Link a server checkpoint to a git commit
  help [command]             display help for command

git context

Usage: interlinked git context [options]

Show Interlinked metadata for HEAD or a commit

Options:
  --commit <sha>  Specific commit (default: HEAD)
  --json          Machine-readable output
  -h, --help      display help for command

git link-checkpoint

Usage: interlinked git link-checkpoint [options]

Link a server checkpoint to a git commit

Options:
  --checkpoint <id>  Checkpoint ID (default: latest)
  --commit <sha>     Commit SHA (default: HEAD)
  --apply            Apply trailers and notes to HEAD (amends commit)
  --json             Machine-readable output
  -h, --help         display help for command

Other Commands

enable

Usage: interlinked enable [options]

Install hooks + create .interlinked/ config

Options:
  --server <url>      Server URL
  --agent <name>      Default agent name
  --clients <list>    Comma-separated client list
                      (claude,copilot,gemini,codex,cursor,opencode,pi)
  --sync-mode <mode>  Sync mode: realtime (default), local, manual
  --data-dir <path>   Override data directory for activity logs and sessions
  --dry-run           Show what would change without modifying files
  --structure <mode>  Scaffold structure manifests: minimal, standard, strict
  -h, --help          display help for command

disable

Usage: interlinked disable [options]

Stand the harness down for this project (recorded); --uninstall to remove hooks
+ config

Options:
  --team              Write a committed marker (shared, shows in PR diffs)
                      instead of a personal one
  --reason <text>     Why the harness is being stood down (recorded in the
                      audit log)
  --until <duration>  Auto-expire the stand-down (e.g. 30m, 2h, 1d)
  --by <name>         Who is standing it down (defaults to agent name / $USER)
  --uninstall         Destructive teardown: remove hooks from all clients and
                      delete .interlinked/
  --keep-config       With --uninstall, preserve .interlinked/ config files
  -h, --help          display help for command

status

Usage: interlinked status [options]

Dashboard: local sessions, recent activity, sync status

Options:
  --short            One-line summary
  --full             Per-session detail with tools and files
  --json             Machine-readable output
  --watch [seconds]  Auto-refresh interval (default 10s)
  -h, --help         display help for command

activity

Usage: interlinked activity [options]

Recent activity feed

Options:
  --agent <name>      Filter by agent
  --limit <n>         Max entries (default: "30")
  --since <duration>  e.g. 1h, 30m
  --json              Machine-readable output
  -h, --help          display help for command

doctor

Usage: interlinked doctor [options]

Diagnose issues (local + server checks)

Options:
  --fix       Auto-fix what's possible
  --json      Machine-readable output
  -h, --help  display help for command

clean

Usage: interlinked clean [options]

Remove stale data

Options:
  --dry-run   Show what would be removed (default)
  --force     Actually delete
  --json      Machine-readable output
  -h, --help  display help for command

login

Usage: interlinked login [options]

Authenticate with the server (opens browser)

Options:
  --server <url>   Server URL
  --token <token>  Manual token for CI/headless use
  -h, --help       display help for command

sync

Usage: interlinked sync [options]

Push locally-buffered events to the server

Options:
  --dry-run    Show what would be synced without sending
  --limit <n>  Max events to sync
  --json       Machine-readable output
  -h, --help   display help for command

send

Usage: interlinked send [options] <to> [message]

Send a message to an agent

Options:
  --file <path>         Send file contents as message body
  --importance <level>  Message importance: normal, urgent
  --json                Machine-readable output
  -h, --help            display help for command

inbox

Usage: interlinked inbox [options]

Show recent messages from the server

Options:
  --all               Show all messages (default: unread only)
  --agent <name>      Filter by recipient agent
  --limit <n>         Max entries
  --since <duration>  e.g. 1h, 30m
  --json              Machine-readable output
  --short             One-line summary
  --full              Detailed output
  -h, --help          display help for command

watch

Usage: interlinked watch [options]

Monitor server for pending work (messages, tasks, agents)

Options:
  --interval <seconds>  Refresh interval (default 10s)
  --short               One-line summary
  --json                Machine-readable output
  -h, --help            display help for command