Open source · Rust CLI · Pre-release

Your code stays local. Your database doesn’t have to.

Repobox connects each Git environment to persistent PlanetScale Postgres, then runs the rest of your stack locally. One terminal workflow for developers and coding agents.

View on GitHub See how it works
  • Local-first
  • Branch-scoped data
  • Agent-native
$ repobox auth login

$ cd ~/code/my-app
$ repobox run

$ repobox status

How it works

From repository to running stack.

Repobox works from the configuration your repository already has. It changes the development environment, not your application.

  1. 01

    Discover

    Resolve Docker Compose and identify the PostgreSQL services configured for the repository.

    docker compose config
  2. 02

    Provision

    Map the selected Git environment to persistent PlanetScale Postgres and keep credentials outside the repository.

    feature/payments → postgres
  3. 03

    Run locally

    Inject remote connection URLs into child processes and start the remaining services on your machine.

    repobox run

No hosted Repobox control plane. No always-on daemon. Source Compose files stay unchanged.

Branch-scoped data

Change branches. Keep context.

Each selected Git environment maps deterministically to its own remote database branch. Restart your stack without rebuilding the data it depends on.

Code
Your machine
State
PlanetScale
Identity
Git environment
One repository routed to three database branches A local repository splits into main, feature payments, and agent refactor environments. Each environment connects to a separate persistent Postgres database branch. LOCAL REPOSITORY my-app ~/code/my-app main persistent postgres feature/payments persistent postgres agent/refactor persistent postgres

The operating model

Built for the terminal era.

A / LOCAL-FIRST

A lighter local stack.

Keep application code, services, and the fast feedback loop on your machine. Move the stateful dependency that consumes local storage and memory.

LOCAL app · worker · frontend
REMOTE postgres
B / AGENT-NATIVE

One interface for people and agents.

Humans get a fast terminal experience. Coding agents get clean help, dry-runs, and versioned JSON and JSONL contracts. 

$ repobox agent-context --schemas --json
$ repobox status --json --no-input
$ repobox run --detach --yes --json --no-input

Product scope

Databases first.

Repobox starts with one expensive local dependency and a narrow, inspectable control surface. The runtime seam can grow later.

Now

Persistent development data

  • PlanetScale Postgres
  • Docker Compose projects
  • Linux and macOS
  • Human and agent CLI contracts
Direction

Remote development runtimes

  • Hosted runtime adapters
  • Additional stateful services
  • Periodic source resynchronization
  • More infrastructure providers

Pre-release status

Early, useful, and still being hardened.

Repobox is open source, but its first public version has not been tagged. Try it from source with disposable development data while live provider and recovery gates are completed.

PlanetScale resources may be billable. repobox pull replaces environment data from a base-branch backup. Hosted execution, masking, and periodic local-source resync are not current features.

Build with us

Make the heavy part of local development remote.

Repobox is being built in the open. Explore the code, read the current contract, or try it from source against a disposable project.

repobox run
Explore on GitHub Read the docs