Save Your Progress

Your AI partner forgets everything. Bonfire remembers.

@vieko

The Problem

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

You end up re-explaining context, re-making decisions, and watching your AI partner repeat the same mistakes. I wrote about this in November--a pattern for maintaining context across sessions using Markdown files and slash commands[1].

The Solution

Bonfire maintains a living context document that gets read at session start and updated at session end. Your AI partner picks up exactly where you left off. It's like a saved game for your work.

/bonfire:startreads context
work
/bonfire:endsaves context

That's the core. No complex setup. No external services. Just Markdown files in your repo. It complements your issue tracker--use that for what needs to be done, use Bonfire for where you are and what you decided.

Beyond Start and End

The original pattern was two commands and a Markdown file[2]. The plugin does more--but every addition addresses the same insight: the work has shifted from writing to directing.

Claude can write code for twenty minutes and often get it right. What's expensive is everything around it--building the wrong thing, missing edge cases, losing context, discovering misalignment after the code is written. The cost moved from typing to thinking.

These features are responses to that shift:

  • Session state--preserve context so you don't re-explain
  • Spec interviews--research the codebase, then surface ambiguity before it derails[3]
  • Work review--catch blindspots before they ship
  • Subagents--isolate heavy operations so sessions last longer[4]
  • Proactive skills--read context automatically, suggest archiving when done

All feedback loops. All addressing where the bottleneck actually is now.

/bonfire:startRead context, scaffold on first run
/bonfire:endUpdate context, commit changes
/bonfire:specCreate implementation spec
/bonfire:reviewFind blindspots and quick wins
/bonfire:documentDocument a codebase topic
/bonfire:archiveArchive completed work
/bonfire:configureChange project settings

Save Your Progress

claude plugin marketplace add vieko/bonfire
claude plugin install bonfire@vieko


[1] My colleague Aman suggested turning the pattern into a tool. I built create-sessions-dir first, which evolved into the Bonfire plugin.

[2] Adam Wolff from the Claude Code team put this well: “Most of the fancy stuff you can do with bespoke tools, custom agents, and elaborate skills can also be achieved with a prompt.”

[3] Inspired by Thariq's spec-based workflow--start minimal, have Claude interview you to resolve ambiguity, then execute in a fresh session. I added a research phase so questions are informed by codebase context.

[4] Boris Cherny, who created Claude Code, uses subagents for code review--parallel instances checking different aspects, then more to challenge the findings. The plugin applies this pattern for research and review, isolating heavy operations from the main conversation.