Claude
Skills
Sign in
Back

bonfire

Included with Lifetime
$97 forever

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

AI Agents

What this skill does


# 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:

```bash
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](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 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.
Files: 4
Size: 14.2 KB
Complexity: 27/100
Category: AI Agents

Related in AI Agents