Skip to content

Command line

Command Purpose
comind index <repo> [--enrich] [--flows] [--guide] [--no-embed] [--incremental] Index a single repo (embeds by default)
comind link <repos…> [--enrich] [--flows] [--guide] [--no-embed] [--incremental] Link several repos (cross-repo edges + blast radius)
comind explore <focus> [--index-dir <dir>] Zoom, blast radius, and context pack for a symbol
comind search <query…> [--repo <name>] [--index-dir <dir>] [--format md\|table] Graph-aware hybrid code search
comind find <query> [--repo <name>…] [--index-dir <dir>] Locate symbols by name/path substring
comind repos [--index-dir <dir>] List indexed repositories + symbol counts
comind stats [--repo <name>…] [--index-dir <dir>] Per-repo stats: symbols, edges, kinds, enrichment coverage
comind guide [--repo <name>…] [-o <file>] [--index-dir <dir>] Per-repo inferred coding style guides (built with --guide)
comind flow <focus> [--index-dir <dir>] Pre-generated flow walkthrough + live call trace
comind changed <repo> [--since <sha>] Files changed since a commit (git diff)
comind serve [--index-dir <dir>] [--format md\|json] MCP server over stdio
comind contracts [--type http\|sqs\|sns\|s3\|table] [--dangling] Service contracts with providers and consumers (FastAPI, Next.js, Express, Spring MVC, Feign, RestTemplate, WebClient, Go net/http/gin/echo/chi, axum, actix, reqwest, httpx/requests/fetch/axios, boto3, SQL; Terraform queues/topics/buckets and subscriptions)
comind packages [--skew] Internal packages: publisher, consumers, version skew
comind conventions [--repo <name>] Measured conventions, org baseline, recipes from history
comind preflight [repo] [--base <rev>] [--strict] Before committing or in MR CI: constraints, dead ends, failing checks, contracts, blast radius, missing companions (MR job)
comind remember <kind> --on <symbol> --title … Record a decision, failed attempt, constraint, gotcha, intent or question
comind why <symbol> Reasoning blame for a symbol (status, trust, evidence)
comind review <id> <confirm\|retract\|supersede\|dispute> Act on a ledger record
comind ledger [--inbox] [--check] [--compact] All ledger records, only those needing review, evaluate constraint checks (non-zero exit on a violated must, for CI), or fold the inbox into the Lance snapshot
comind erase <id…> \| --actor <id\|me> [--yes] Erase ledger records (and relations about them) for good, including old snapshot versions; dry run without --yes
comind distill git <repo> \| mr <repo> [--iid N] [--list] [--dry-run] Propose ledger records (failed attempts, decisions, constraints, gotchas) from commit messages, or from the merged GitLab MR of the current commit (run per merge in CI, no backfill; @mentions removed; --list shows what would be sent). Needs GITLAB_TOKEN for mr. Proposals land at T1 in the review inbox. Agent sessions are never read
comind doctor Check this machine's setup: index and ledger reachable, local mirror, hooks, LLM key, GitLab token, signing, SCIP indexers
comind harvest <repos…> Seed the ledger from git history (reverts, commit trailers)
comind hook claude <event> / comind init-hooks claude Claude Code hook adapter / config snippet
comind eval graph [--scip <dir>] Graph quality on the gold fixture (precision/recall per edge kind)
comind ui [--web [--port 7878]] [--index-dir <dir>] Terminal UI (incl. a ledger timeline), or a local web UI on 127.0.0.1 (overview, contracts, ledger review, explorer with a neighbourhood graph, conventions)
comind config <path\|init> Show or scaffold the config file

Run comind <command> --help for every flag. --index-dir is a local directory or an s3://… path and defaults to the configured index location.