Agent-Skills.md

Agent Skills: Bonfire (fallback skill)

Session context persistence for AI coding. Pick up exactly where you left off.

UncategorizedID: vieko/bonfire/bonfire

Repository

vieko/bonfire
viekoLicense: MIT
9

Install this agent skill to your local

pnpm dlx add-skill https://github.com/vieko/bonfire/tree/HEAD/skills/bonfire

Skill Files

Browse the full folder contents for bonfire.

Download Skill

Loading file tree…

skills/bonfire/SKILL.md

Skill Metadata

Name
bonfire
Description
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).

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

| 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 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.