Free CLI

Install RunTrim. Start any repo in one command.

Runs locally in your repo. No account required. Source code is never uploaded.

$npm install -g runtrim

No account requiredWorks with Claude, Codex, CursorLocal first

Quick start

Install once. Start in any repo.

Two commands cover the daily workflow.

$npm install -g runtrim

$runtrim go "your task"

What runtrim go does

Compiles a scoped contract — task, memory, allowed scope, forbidden files
Copies the guarded prompt — paste into Claude, Codex, Cursor, or any agent
Records the run locally — history, savings, and continuation pack

Agent mode

Choose how RunTrim delivers the prompt.

Copy mode works with every agent. Command mode wraps a local CLI directly.

Copy mode

Recommended

Prepares the contract and copies it. Paste into any agent UI.

$runtrim go "your task"

Command mode

Optional

Wraps a configured local agent CLI. Use only if you have one set up.

$runtrim agent set <agent>

$runtrim run "your task"

Protocol flow

Full command reference.

runtrim init

Initialize protocol, memory, and agent pointers in a repo.

runtrim go "your task"

Compile a scoped contract, load memory, and copy the guarded prompt.

runtrim check

Review changed files and proof gaps after the agent runs.

runtrim finish

Run the finish check — scope, risk, diff size, forbidden writes.

runtrim memory

Show project memory and resume context.

runtrim continue --reason usage_limit

Build a continuation prompt when a session hits context or usage limits.

Cloud sync

Cloud sync is in early access.

The free CLI runs entirely locally. Cloud sync and hosted run history are rolling out to approved early access users. When connected, sync uploads run metadata only — source code stays local.