RunTrim
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
View plans
No account requiredWorks with Claude, Codex, CursorLocal first

Quick start

Install once. Start in any repo.

Four commands cover the daily workflow.

$npm install -g runtrim
$runtrim start
$runtrim doctor
$runtrim agent "Fix the homepage copy" --copy
$runtrim finish

What runtrim agent --copy does

  • Creates a scoped contract. Task, memory, allowed scope, forbidden files.
  • Copies the guarded handoff. Paste into Claude, Codex, Cursor, or any agent.
  • Records the run locally. History and continuation pack.

Dispatch and MCP

Two ways to hand off to an agent.

Copy mode works with every agent. MCP mode works with compatible agents that support the Model Context Protocol.

Copy mode

Recommended

Creates a scoped contract and copies the guarded handoff. Paste into any agent UI.

$runtrim agent "your task" --copy

MCP mode

Optional

Run a local MCP server that compatible agents like Claude Code can call directly.

$runtrim mcp instructions
$runtrim mcp config --print
$runtrim mcp start

Protocol flow

Full command reference.

01
runtrim start

Analyze the project, write memory, detect agent files, and prepare MCP snippets.

02
runtrim doctor

Check whether project setup, agent instructions, and MCP readiness are in place.

03
runtrim agent "your task" --copy

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

04
runtrim finish

Check changed files, scope, sensitive files, proof gaps, and finish verdict.

05
runtrim approve "Allow <scope>"

Approve a scope extension for the current run only.

06
runtrim mcp instructions

Print MCP integration instructions for your agent.

07
runtrim mcp config --print

Print the MCP server config snippet.

08
runtrim mcp start

Start the local MCP server.

09
runtrim ci check

Run CLI-based CI safety checks for pull requests.

10
runtrim restore last --preview

Preview local restore before rewinding a broken AI run.

Cloud sync

Cloud sync is available now.

Free CLI runs locally. Paid plans add cloud sync and run history. Metadata only, source code stays on your machine.

View plans