bonfire

Original：🇺🇸 English

Translated

Session context persistence for AI coding. Start/end sessions, create specs and docs, review work. Use for session management, "start session", "end session", implementation specs, documentation, code review, or questions about previous work, decisions, blockers, "last time", "what we decided".

2installs

Sourcevieko/bonfire

Added on2026-02-07

NPX Install

npx skill4agent add vieko/bonfire bonfire

SKILL.md Content

View Translation Comparison →

Bonfire

Session context persistence for AI coding - save your progress at the bonfire.

Git root: !

git rev-parse --show-toplevel

Commands

Command	Purpose	Details
`/bonfire start`	Begin session, load context	commands/start.md
`/bonfire end`	Save context, health check	commands/end.md
`/bonfire config`	Change settings	commands/config.md
`/bonfire spec <topic>`	Create implementation spec	commands/spec.md
`/bonfire doc <topic>`	Create documentation	commands/doc.md
`/bonfire review`	Review current work	commands/review.md

Command Routing

Parse

$ARGUMENTS

to determine which command to run:

Input	Action
`start`	Read commands/start.md and execute
`end`	Read commands/end.md and execute
`config` or `configure`	Read commands/config.md and execute
`spec <topic>`	Read commands/spec.md and execute
`doc <topic>` or `document <topic>`	Read commands/doc.md and execute
`review`	Read commands/review.md and execute
Empty or context question	Read session context and answer

Quick Reference

Start Session

Check/create
```
.bonfire/
```
directory
Read
```
index.md
```
for session context
Ask what to work on

End Session

Update
```
index.md
```
with accomplishments
Run health check (garbage detection)

Config

Set specs/docs locations
Choose git strategy (ignore-all, hybrid, commit-all)
Enable/disable Linear integration

Spec

Research codebase (subagent)
Interview user for decisions
Write spec (subagent)
Verify required sections

Doc

Research codebase (subagent)
Write documentation (subagent)
Verify required sections

Review

Gather context (branch diff, session notes)
Analyze for blindspots (subagent)
Present findings by severity
Offer to fix, spec, or create issues

Passive Context

When user asks about previous work, decisions, blockers, or references "last time", "previously", "what we decided":

Read
```
<git-root>/.bonfire/index.md
```
Summarize relevant context
Answer the user's question

Bootstrap

If

.bonfire/index.md

doesn't exist when any command runs, create defaults:

Create
```
.bonfire/
```
with
```
specs/
```
and
```
docs/
```
subdirectories
Create
```
index.md
```
with frontmatter config (see templates/)
Create
```
.gitignore
```

See templates/ for default content.

File Structure

.bonfire/
├── index.md          # Session context with config in frontmatter
├── specs/            # Implementation specs
├── docs/             # Documentation
└── .gitignore        # Git strategy