bootstrap — deploy the toolkit into a project
The whole point of Botte Secrète is to make real projects cheaper to work on. This installs the stack into any project in one command.
Run it
python -m skills.bootstrap.cli /path/to/project
python -m skills.bootstrap.cli /path/to/project --create-agents-md # scaffold AGENTS.md if missing
python -m skills.bootstrap.cli /path/to/project --scan-subnet --json
What it does (idempotent)
- Discover local backends (
llm_backends) so routing has somewhere to send work. - Wire MCP — merges the
botte-llmserver into the project's.mcp.json(non-destructive; keeps any existing servers). The project's agent then gains:auto_route,local_chat,fusion,find_skills,audit_local_usage,route_task,discover_backends,list_models. - Audit directives (
directives_audit) — reports the CLAUDE.md/AGENTS.md health; with--create-agents-md, scaffolds a starterAGENTS.mdwhen none exists. - Write
.botte/config.json— chosen local model, detected cloud keys, token budget, routing mode (auto). - Write
.botte/setup-report.json+ print a summary with next steps.
Result
The project's agent now routes cheap work (classification, extraction, summaries,
tool/skill search) to local models for 0 cloud tokens, escalates only the hard
parts to the cloud (auto_router), and picks tools with find_skills instead of
reading every skill description with the expensive model.
.mcp.json and .botte/ hold per-machine absolute paths, so they are gitignored
in this repo — deploy on each machine.
Related: [[llm_mcp]] (the tools wired in), [[auto_router]], [[skill_finder]], [[directives_audit]], [[llm_backends]].