SKILL.md
Bonfire (fallback skill)
Session context persistence for AI coding.
Bonfire ships in three layers:
- File convention —
<git-root>/.bonfire/index.mdwith two managed fence blocks. - Native host adapters (preferred) — drop-in plugins that auto-update the file as you work. Available for Pi and Claude Code.
- This skill (fallback) — manual
/skill:bonfire endfor agents without a native adapter (Codex, OpenCode, etc.).
If you're on Pi or Claude Code, install the adapter from ~/dev/bonfire/{pi,claude}/ instead. The adapters are zero-ritual and richer than what this skill can do.
Git root: !git rev-parse --show-toplevel 2>/dev/null || echo ""
Opt-in
The skill (and the adapters) honor an opt-in gate per repo:
mkdir <repo>/.bonfireWithout .bonfire/ present, this skill exits silently. That keeps it from polluting random repos.
Routing
| Input | Action |
|---|---|
end |
Read [commands/end.md](commands/end.md) and execute |
migrate |
Read [commands/migrate.md](commands/migrate.md) and execute. One-off migration for a pre-v7 index.md that lacks the v1 fence markers — wraps the file in fences without destroying hand-curated content. |
Earlier versions of bonfire had start and handoff commands. Both are removed in 7.0:
start: redundant. Modern agents auto-read files fromcwd, so.bonfire/index.mdis already in context. No ritual needed.handoff: Pi has a richer first-partyhandoffextension. For non-Pi agents, use Linear, a notes file consumed via@fileinjection, or a draft PR description.