dev.self-wiki

Personal AI-powered wiki + Second Brain — raw notes → structured wiki → query / audit.
Operating philosophy and agent rules: AGENTS.md.

privacy

Local-first by default (LLM_PROVIDER=mlx).
Raw and wiki stay on disk under self-wiki/.

Quick start

python3 -m venv .selfwikienv && .selfwikienv/bin/pip install -r requirements.txt
cp .env.example .env    # LLM_PROVIDER, LLM_URL, keys
make sync               # ingest changed raw → wiki
make query Q="what are my values?"
make query-web          # browser UI (same query pipeline)

Commands

Command	What it does
make sync	Ingest changed raw → wiki
make query	Ask wiki; saves to self-wiki/outputs/
make audit	Compliance tests + deterministic audit.md
make audit LINT=1	Above + one global cognitive lint (LLM)
make query-web	Web UI: ask + browse Wiki / Outputs / Profile

Advanced (Cursor mode, promote, twin, …): python scripts/cli.py --help
Technical reference: ARCHITECTURE.md

Override provider:
LLM_PROVIDER=gemini make query
LLM_PROVIDER=openai make query

License

© 2026 Bean Workshop Ltd.