CLI Reference — MisakaNet

`search_knowledge.py` — Core Search Tool

python3 search_knowledge.py <query> [options]

Argument	Target	Description	Example
`query`	(positional)	Search keywords	`python3 search_knowledge.py "pip install timeout"`
`--lessons`	Mode	Switch to lesson search mode (not a path/id filter)	`--lessons`
`--ref`	Mode	Switch to reference search mode (not a path/id filter)	`--ref`
`--top=<N>`	Pagination	Show top N results (default: 10)	`--top=3`
`--titles`	Display	Show titles only	`--titles`
`--json`	Display	Emit a JSON array with `title`, `domain`, `tags`, `score`, `path`, and `preview`; errors are JSON objects	`"pip timeout" --json \| jq '.[0]'`
`--broad`	Matching	Broader keyword matching	`--broad`
`--suggest`	Mode	List matching titles (≥2 chars)	`--suggest`
`--semantic`	Mode	Use sentence-transformers (optional dep)	`--semantic`
`--score`	Mode	Lesson quality scoring from telemetry	`--score --top=5`
`--telemetry=<path>`	Scoring	Custom telemetry DB path	`--telemetry=/tmp/t.db --score`
`--explain`	Search	Show BM25/Meta/Base score breakdown	`--explain`
`--verbose`	Search	Alias for `--explain`; JSON output includes `score_breakdown`	`--verbose --json`
`--env=<env>`	Filter	Filter by environment tag (wsl2, docker, ...)	`--env=wsl2`
`--domain=<d>`	Filter	Filter by domain (devops, rag, ...)	`--domain=devops`
`--lang=<lang>`	Filter	Filter by language	`--lang=zh`
`--heal`	Mode	Diagnose error logs from file/stdin	`--heal error.log`
`--harvest --from-file=<f>`	Mode	Parse log for errors → draft lesson	`--harvest --from-file=crash.log`

Exit codes: 0 = results found, 1 = no results or error.

--json keeps standard output machine-readable, so it can be piped directly to tools such as jq:

python3 search_knowledge.py "database locked" --json --top=3 | jq '.[].path'

Command	Description
`python3 scripts/new_lesson.py`	Interactive lesson generator
`python3 scripts/queue_lesson.py`	Queue a lesson via CLI args
`python3 scripts/tombstone_to_draft.py --from-file <f>`	fatal-guard tombstone → draft lesson
`python3 scripts/bench_orchestrator.py [--include-drafts]`	Agent benchmark runner (Phase B/C)
`python3 scripts/contribute.py --wizard`	7-step interactive lesson creation wizard
`python3 scripts/check_worker_secrets.py`	Scan workers/ for hardcoded secrets
`python3 search_knowledge.py --score`	Telemetry-based lesson ranking
`python3 -m misakanet.tools.dashboard`	Launch telemetry dashboard (stdlib HTTP server)

Variable	Default	Description
`MISAKANET_HOME`	`~/.misakanet`	Data directory (cache, telemetry DB)
`MISAKANET_TELEMETRY`	`$MISAKANET_HOME/langchain_telemetry.db`	Telemetry database path

Command	Description
`python3 hub/misaka_hub.py`	Start Hub orchestration server
`python3 -m misakanet.scripts.hub_poller`	Poll Hub for new lessons

Requires: pip install -r hub/requirements.txt