Skip to content

kajogo777/bento

Repository files navigation

🍱 bento

Portable checkpoints for AI agent workspaces. Save code, agent memory, and dependencies as OCI artifacts. Push to any container registry. Resume anywhere.

License Go Release

Pack, ship, resume.

bento demo

Git tracks your code. Bento tracks everything else: agent memory, installed dependencies, build caches, conversation history. Checkpoints are standard OCI images you can push to any container registry.

One binary. Any agent. macOS, Linux, Windows. Works offline.

bento init                          # start tracking
bento save -m "auth module done"    # checkpoint
bento open cp-3                     # restore
bento push ghcr.io/myorg/project    # push (remembers remote)
bento pull                          # sync from remote
bento status                        # what's changed? am I in sync?

Install

# Homebrew
brew tap kajogo777/bento https://github.com/kajogo777/bento
brew install kajogo777/bento/bento

# From source
go install github.com/kajogo777/bento@latest

A different bento package exists in homebrew-core. Always use kajogo777/bento/bento.

Quick Start

cd my-project
bento init
# Detected: claude-code, node

bento save -m "refactored auth module"
#   deps:     1204 files, 89MB (unchanged, reusing)
#   agent:    8 files, 64KB
#   project:  42 files, 128KB
# Tagged: cp-1

bento open cp-1                     # restore any checkpoint
bento open undo                     # changed your mind? undo it
bento open cp-1 ~/workspace-b      # parallel workspace

Move Between Machines

# Laptop: leaving
bento save -m "moving to server"
bento push ghcr.io/me/myproject       # first push remembers the remote

# Server: cold start
bento open ghcr.io/me/myproject:latest ~/myproject
cd ~/myproject                        # remote is remembered here too
bento save -m "done on server"
bento push                            # no URL needed

# Laptop: back
bento status                          # "1 checkpoint behind"
bento pull
bento open latest

Undo Agent Mistakes

bento watch --debounce 5              # auto-checkpoints as you work

# Agent went off the rails? Roll back.
bento open cp-12
# To undo: bento open undo

# Restore just the deps layer, keep your code
bento open cp-12 --layers deps

How It Works

Each save creates a layered OCI artifact:

Layer Contents Changes
deps node_modules, .venv, vendor Rarely
agent Agent memory, plans, skills, configs Often
project Everything else Often

Unchanged layers are deduplicated. Your 200MB node_modules is stored once, not once per checkpoint.

Bento auto-detects what's in your workspace and assigns files to the right layer:

Agents: Claude Code · Codex · OpenCode · OpenClaw · Cursor · Stakpak · Pi · AGENTS.md Deps: Node · Python · Go · Rust · Ruby · Elixir · OCaml Tools: asdf / mise

No configuration needed. Add a new agent or framework mid-project and bento picks it up on the next save.

Secrets

Bento never stores secrets. A pre-save gitleaks scan (~200 rules) catches credentials before they're packed. Environment variables can reference external sources:

env:
  DATABASE_URL:
    source: env
    var: DATABASE_URL

More Use Cases

Comparison

Agent checkpoints (Claude Code, Cursor) save code changes via git or internal diffs. Cloud agent platforms run stateful sessions but lock you into their infrastructure. Bento captures the full workspace as a portable artifact.

Agent checkpoints Cloud agents* git Docker checkpoint Sandbox snapshots** Bento
Source code
Agent memory
Dependencies
Portable
Inspectable
Branching
Works with any agent
Docker interop
Works offline

*Claude Managed Agents (Anthropic) runs stateful sessions with persistent filesystems on Anthropic's cloud. **E2B, Vercel, and Daytona offer sandbox snapshots within their platform but snapshots are not portable across providers.

FAQ

Why not git? Git doesn't track dependencies, agent memory, or build caches.

Why not Docker commit? Opaque process memory dumps. Bento captures semantic file layers you can inspect and diff.

Why OCI? Every cloud runs a registry. No new accounts needed. COPY --from=<bento-ref> works in Dockerfiles.

Learn More

Roadmap

  • Core CLI, local store, deduplication
  • Remote push/pull with status sync
  • Secret scanning and hydration
  • Watch mode (auto-checkpointing)
  • Agents: Claude Code, Codex, OpenCode, OpenClaw, Cursor, Stakpak, Pi
  • GitHub Copilot
  • MCP server (agents checkpoint themselves)
  • Docker sandbox integration

License

Apache 2.0. See LICENSE.

About

Checkpoint everything git misses in AI agent workspaces. Save, fork, push to any OCI registry.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages