History‑linked checkpoints and file state restore

Open 💬 5 comments Opened Aug 27, 2025 by mkusaka

What feature would you like to see?

Provide a mechanism that ties conversation history to file state:

  • Automatically create a checkpoint whenever the agent modifies files (e.g., via apply_patch or approved shell writes).
  • When jumping to a past message from history/backtrack, restore the workspace to the file state at that message. Make this restore behavior configurable: automatic or prompt/manual.

Implementation note

  • Backend is implementation‑agnostic. A Git‑based approach is one practical option, but any local snapshot store that can recreate exact file states is acceptable.

Slash commands (especially for manual mode)

  • /checkpoint restore <message-id|checkpoint-id> → Restore files to the state associated with a specific history message or checkpoint (confirmation shown).
  • /checkpoint save [message] → Optional manual checkpoint at the current workspace state.
  • /checkpoint mode auto|manual → Toggle restore behavior when navigating history/backtrack.

Are you interested in implementing this feature?

Potentially—happy to help refine the design and contribute an implementation once maintainers confirm the scope and preferred storage backend.

Additional information

Inspiration: Gemini CLI checkpointing (conceptual prior art): https://github.com/google-gemini/gemini-cli/blob/main/docs/checkpointing.md

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗