sdtk-brain — Command Reference

Standalone second-brain vault CLI. Not part of the sdtk-kit umbrella — install it on its own:

npm install -g sdtk-brain-kit
sdtk-brain --help

A vault is a standalone folder (per person, cross-project — never inside a product repo): raw/ holds immutable sources, wiki/ holds the compiled markdown knowledge layer, workspace/ is scratch, .brain/ is CLI-owned machine state. The vault ships its own CLAUDE.md operating contract — your agent is the knowledge engine; the CLI provides only deterministic rails. Everything is local: no LLM in the CLI, no network, no telemetry, no entitlement.

Core workflow

mkdir my-vault && cd my-vault
sdtk-brain init                          # scaffold raw/ + wiki/ + workspace/ + CLAUDE.md
cp ~/some-article.md raw/inbox/
sdtk-brain ingest raw/inbox              # semantic extraction (report-first)
sdtk-brain compile --mode safe --apply   # compile into wiki/ knowledge pages
sdtk-brain search "topic"                # deterministic search over the vault
sdtk-brain open                          # docs view + graph view (local viewer, no server)

init refuses a non-empty folder that isn't already a vault (never scaffolds into a product repo); re-runs are idempotent and never overwrite your files. --vault <path> works on every command as an alias of --project-path.

Maintenance

sdtk-brain lint                          # orphans, broken links, stale claims, contradictions
sdtk-brain maintain --mode safe          # lint + discover + compile preview in one pass
sdtk-brain discover --plan               # gap-analysis plan from wiki evidence
sdtk-brain enrich --source github --mode review   # review-only external repo metadata
sdtk-brain status                        # vault status

All maintenance is report-first: reports land under .brain/reports, nothing is auto-modified.

Asking questions

There is deliberately no ask command. Open the vault in your agent (or Obsidian) and ask there — the agent reads wiki/ per the vault's CLAUDE.md contract and synthesizes grounded, cited answers. Deterministic retrieval (search) is the CLI's job; thinking is the agent's.

Relationship to SDTK

sdtk-brain shares its graph builder and viewer with SDTK-WIKI (byte-identity is CI-guarded) — and nothing else. If you also use SDTK on a project, sdtk-wiki atlas build --workspace brain=<vault> shows your project wiki and your vault in one viewer. The tool installs no SDTK skills and requires no other kit.