second-brainlisted
Install: claude install-skill stancsz/second-brain
# Second Brain
Use the user's local notes as durable memory across conversations. Markdown in the OKF Bundle is canonical; SQLite is a rebuildable index. Supported CLI/MCP writes are paired to the Bundle with a lock, receipt, and crash-recovery journal. Never substitute model memory or general web knowledge for a requested search of the user's brain.
## Locate the tools
Treat the directory containing this file as `<skill_root>`.
- Brain CLI: `<skill_root>/scripts/brain_cli.py`
- Snapshot CLI: `<skill_root>/scripts/storage_cli.py`
- MCP server: `<skill_root>/scripts/brain_mcp.py`
Use `SECONDBRAIN_CLI` instead when it is set. Run with an available Python 3 interpreter (`python3` or `python`). Do not guess a host-specific install path.
Global flags precede the subcommand:
```text
python <skill_root>/scripts/brain_cli.py --json search "query"
```
If a command is unclear, run that command with `--help` rather than inventing an option.
## Match intent to action
| User intent | Action |
|---|---|
| Save or remember one item | `add` one concise Concept. Infer a useful title and 2–5 tags; do not block on taxonomy. |
| Recall their knowledge about a topic | `search`, inspect the best results with `show`, then answer with Concept IDs. |
| Catch up on a project | `list --collection <project> --sort updated`, inspect the strongest notes, and use `related` when connections matter. |
| Find gaps | Search first, summarize what exists, then distinguish missing coverage from an empty