vieko-bonfire

Bonfire

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

Installation

npx skills add vieko/bonfire

Works with Claude Code, Cursor, and other Agent Skills compatible tools.

The Problem

AI agents are stateless. Every conversation starts from scratch. The agent doesn't remember what you decided yesterday, why you chose that architecture, or where you left off.

The Solution

Bonfire maintains a living context document—read at session start, updated at session end.

/bonfire start → work → /bonfire end

No complex setup. No external services. Just a Markdown file in your repo.

Commands

Command	Outcome
/bonfire start	Session started, context loaded, ready to work
/bonfire end	Work captured, context healthy

What Gets Created

.bonfire/
├── index.md      # Living context
└── .gitignore    # Ignored by default

Design

Commands define outcomes, not procedures. Each command specifies:

• What success looks like
• How to verify it worked
• Boundaries and constraints

The agent determines the procedure. This follows ctate's patterns for autonomous agents.

Requirements

• Git repository
• Agent Skills compatible tool

Links

• Blog
• skills.sh
• agentskills.io

Credits

Animation by Jon Romero Ruiz.

License

MIT © Vieko Franetovic