mcpField
B
bonfire

bonfire

github.com/viekoAgent workflows10136 installsUpdated 2w ago
Repository

About bonfire

bonfire is a session-context persistence skill for AI coding agents, aimed at developers who want work context retained in a repository. It uses a `.bonfire/index.md` file convention, with native adapters for Pi and Claude Code and a manual fallback for agents without an adapter.

Key features

  1. 01Stores session context in `.bonfire/index.md`
  2. 02Enables persistence per repository
  3. 03Provides native Pi and Claude Code adapters
  4. 04Offers a manual `end` command as fallback
  5. 05Migrates older files with a one-off command

Use cases

  1. 01Save context at the end of a coding session
  2. 02Let later sessions read repository work notes
  3. 03Run manually with agents lacking native adapters
  4. 04Migrate legacy index files without markers

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vieko/bonfire --skill bonfire

After installing, type/bonfirein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

commands/
end.md
migrate.md
templates/
index.md

Details

From the project README

Bonfire (fallback skill)

Session context persistence for AI coding.

Bonfire ships in three layers:

  1. File convention — <git-root>/.bonfire/index.md with two managed fence blocks.
  2. Native host adapters (preferred) — drop-in plugins that auto-update the file as you work. Available for Pi and Claude Code.
  3. This skill (fallback) — manual /skill:bonfire end for 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

InputAction
endRead commands/end.md and execute
migrateRead 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 from cwd, so .bonfire/index.md is already in context. No ritual needed.
  • handoff: Pi has a richer first-party handoff extension. For non-Pi agents, use Linear, a notes file consumed via @file injection, or a draft PR description.

Comments

Markdown supported