bonfire
64
总安装量
64
周安装量
#3416
全站排名
安装命令
npx skills add https://github.com/vieko/bonfire --skill bonfire
Agent 安装分布
claude-code
63
cursor
49
opencode
21
codex
21
amp
14
Skill 文档
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.mdfor session context - Ask what to work on
End Session
- Update
index.mdwith 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/withspecs/anddocs/subdirectories - Create
index.mdwith 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