Spin your first clone
Nothing to a running, seeded clone in five minutes.
See how it works
The architecture behind a clone, in one diagram.
Connect your agent
Point your agent at a clone over its HTTP API or MCP.
Browse the CLI
Every command and flag, with real output.
The mental model
Hone Environments have two nouns, at two altitudes.Clone
One running instance of a SaaS product — a real backend, its own database,
real auth. The unit you build and compose.
Environment
A named composition of clones on shared infrastructure. The unit you point an
agent at and score.
The loop
Every environment session is the same five beats. Each is one command.1
Spin
hone env spin slack creates a clone, allocates ports, runs migrations,
and waits until it’s healthy. You get a live API endpoint back.2
Seed
Load a deterministic fixture for repeatable evals, or generate realistic data
with an LLM. Either leaves the clone in a known starting state.
3
Run
Point your agent at the clone’s HTTP API or MCP server. It reads, writes, and
acts against a real backend — every action lands in the clone’s own database.
4
Inspect
Read the database directly with
query to score exactly what the agent did.
Stream logs to debug.5
Reset or destroy
reset drops and re-seeds to the same starting state for the next trial.
destroy tears it down and frees the ports.Why a clone, not a mock
High fidelity, not stubs
Clones are real NestJS backends on real Postgres with real JWT auth — stateful,
referentially consistent, returning authentic errors. Not canned responses.
Reproducible to the row
Every clone has a stable id, its own database, and a recorded seed.
reset
rebuilds it to byte-for-byte the same starting state.Scorable
The agent’s work is just rows in a database you own. Read them with
query
to grade a run objectively, not by scraping output.Local-first
Everything runs through Docker on your machine. No cloud account, no external
dependencies. A connected control-plane mode is planned.
Concepts at a glance
What’s in the box
Next steps
Quickstart
Spin, seed, and point an agent at your first clone.
How it works
CLI, contract, providers, shared infra, and templates.
Connect your agent
HTTP API and MCP, with working examples.
Available templates
The clones you can spin today.