bonfire
Session context persistence for AI coding via a `.bonfire/index.md` file convention. This skill is the cross-agent fallback for hosts without a native bonfire adapter (Pi and Claude Code have first-party adapters that auto-update the file; install those when available).
How do I install this agent skill?
npx skills add https://github.com/vieko/bonfire --skill bonfireIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The 'bonfire' skill is a productivity tool for developers that manages coding session context locally within a '.bonfire' directory. It interacts with the local Git repository to automate status updates and session summaries. The skill does not access external network resources and limits its shell operations to Git and directory management, making it safe for its intended purpose.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
2/5 files flagged
What does this agent skill do?
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>/.bonfire
Without .bonfire/ present, this skill exits silently. That keeps it from polluting random repos.
Routing
| Input | Action |
|---|---|
end | Read commands/end.md and execute |
migrate | Read 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/vieko/bonfire/bonfire">View bonfire on skillZs</a>