Development
Plugin
runtm
Open-source sandboxes where coding agents build and deploy. Spin up isolated environments where Claude Code, Cursor, Codex, and other agents code and ship software. With live URLs, logs, and previews.
Plugin Signal66/100Solid
maintained97
capable14
documented100
adopted52
Install
$ npx -y skills add runtm-ai/runtm --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
Badges
4
README
1Runtm
Open-source sandboxes where coding agents build and deploy.
Spin up isolated environments where Claude Code, Cursor, Codex, and other agents code and ship software. With live URLs, logs, and previews.
Website · Docs · Get Started
Demo
https://github.com/user-attachments/assets/8d6d5ab8-a5c4-4a3d-8ef1-5d20b67ed3ee
Why Runtm?
- Sandboxes for yolo agents – Let agents code with full permissions in isolated environments. No risk to your machine or cloud.
- Run any coding agent – Claude Code, Cursor, Codex, Gemini CLI, and more. Bring your favorite.
- Real URLs instantly – Agents deploy to live HTTPS endpoints. Test, share, and iterate.
- Logs and observability – See what your agent built, debug issues, fix and redeploy.
Quick Start
# Install
uv tool install runtm
# Start a local sandbox session
runtm session start
# Your agent builds inside the sandbox...
# Deploy to a live URL
runtm session deploy
You get a live HTTPS endpoint on auto-stopping infrastructure. Machines spin down when idle and wake up on traffic.
Local Sandbox Sessions
Run AI agents in isolated local environments with OS-level sandboxing:
# Start a sandbox (auto-installs deps on first run)
runtm session start
# Start with a template
runtm session start --template web-app
# Use a different agent
runtm session start --agent codex
# List all sandboxes
runtm session list
# Reattach to a sandbox
runtm session attach sbx_abc123
# Deploy from sandbox to live URL
runtm session deploy
What you get:
- OS-level isolation – Uses bubblewrap (Linux) or seatbelt (macOS) for fast, secure sandboxing
- Instant startup – Sandboxes start in <100ms, no containers needed
- Multi-agent support – Works with Claude Code, Codex, Gemini CLI, and more
- Persistent workspaces – Stop and resume sessions, files preserved
How It Works
┌────────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐
│ Your Agent │ ──▶ │ Sandbox │ ──▶ │ Runtm │ ──▶ │ Live URL │
└────────────┘ └─────────┘ └─────────┘ └──────────┘
- Spin up a sandbox – Your agent gets an isolated workspace
- Agent builds – Full permissions to code, install deps, run tests
- Deploy – One command to a real URL with logs and previews
- Iterate – Agent can see logs, fix bugs, and redeploy
Installation
The pip CLI (runtm) for local sandboxes, scaffolding, and deploys:
# Recommended
uv tool install runtm
# Alternative
pipx install runtm
# Or with pip
pip install runtm
The Go CLI (runtm-api) is a separate, lighter tool for AI coding agents driving the hosted Cloud API:
curl -fsSL https://runtm.com/install | bash
It is JSON-in / JSON-out, has stable exit codes, and ships with embedded skill files for Claude Code, Cursor, and Codex. See Agent CLI docs and the packages/agent/ source for details. The pip and Go CLIs share the same API key.
Commands
| Command | Description |
|---|---|
runtm session start | Start a new sandbox session |
runtm session list | List all sandboxes |
runtm session attach <id> | Reattach to a sandbox |
runtm session stop <id> | Stop a sandbox (preserves files) |
runtm session destroy <id> | Destroy sandbox and delete files |
runtm session deploy | Deploy from sandbox to live URL |
runtm init | Initialize a new project |
runtm deploy | Deploy to a live URL |
runtm logs <id> | View build, deploy, and runtime logs |
runtm status <id> | Check deployment status |
runtm destroy <id> | Tear down a deployment |
See the CLI docs for the full reference.
Self-Hosting
Runtm can be fully self-hosted. See the self-hosting guide.
git clone https://github.com/runtm-ai/runtm.git
cd runtm
cp infra/local.env.example .env
# Install packages (includes sandbox and agents)
./scripts/dev.sh setup
# Start local services
docker compose -f infra/docker-compose.yml up -d
# Use the development CLI
runtm-dev start # Start a sandbox session
runtm-dev prompt "Build an API" # Send prompt to agent
Note: Use runtm-dev (not runtm) when self-hosting. The dev CLI includes sandbox/agents packages.
Project Structure
packages/
shared/ # Types, manifest schema, errors
sandbox/ # Local sandbox runtime (OS-level isolation)
agents/ # AI coding agent adapters (Claude Code, Codex, etc.)
api/ # FastAPI control plane
worker/ # Build + deploy pipeline
cli/ # Python CLI (Typer) - `runtm` (local sandbox + deploy)
agent/ # Go CLI (Cobra) - `runtm-api` (hosted Cloud API for AI agents)
templates/ # Starter projects (backend, static, fullstack)
Documentation
Full docs at docs.runtm.com:
Contributing
See CONTRIBUTING.md for development setup and guidelines.
License
| Component | License |
|---|---|
| Server (api, worker, infra) | AGPLv3 |
| CLI, Sandbox, Shared | Apache-2.0 |
| Templates | MIT |
Support
Open an issue or join our Discord.
File tree
728runtm-ai/runtmView on GitHub
.cursorignore
.env.example
.github/
ISSUE_TEMPLATE/
bug_report.md
config.yml
feature_request.md
PULL_REQUEST_TEMPLATE.md
workflows/
ci.yml
lint.yml
publish.yml
release-agent.yml
.gitignore
.pre-commit-config.yaml
.vscode/
launch.json
settings.json
CHANGELOG.md
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
docs/
cloud-api/
activity/
agent-scorecard.mdx
personal-activity.mdx
personal-summary.mdx
recent-prompts.mdx
session-grade.mdx
session-usage.mdx
team-activity.mdx
team-deploy-metrics.mdx
team-events.mdx
team-members.mdx
team-summary.mdx
team-traces.mdx
agent-cli.mdx
agents/
create.mdx
delete.mdx
get.mdx
list.mdx
overview.mdx
trigger-credentials.mdx
update.mdx
authentication/
authentication.mdx
verify.mdx
configuration/
current-plan.mdx
deploy-limits.mdx
deploy-permission.mdx
onboarding-preferences.mdx
org-allowlist-policy.mdx
org-cleanup.mdx
org-instructions.mdx
org-limits.mdx
provider-keys-anthropic.mdx
provider-keys-openai.mdx
provider-keys-resolved.mdx
user-instructions.mdx
context/
knowledge/
catalog.mdx
create.mdx
delete.mdx
get.mdx
list.mdx
oauth-install.mdx
patch.mdx
rotate.mdx
test.mdx
org-instructions-get.mdx
org-instructions-set.mdx
skills/
attachments-list.mdx
attachments-replace.mdx
create.mdx
delete.mdx
discover-in-repo.mdx
facets.mdx
get.mdx
import.mdx
list.mdx
lock.mdx
patch.mdx
presign-upload.mdx
resync.mdx
unlock.mdx
user-instructions-get.mdx
user-instructions-set.mdx
conventions.mdx
deploy/
info.mdx
preflight.mdx
run.mdx
scaffold.mdx
validate.mdx
volumes-get.mdx
volumes-update.mdx
deployments/
destroy.mdx
get.mdx
list.mdx
logs.mdx
errors.mdx
groups/
usage.mdx
guardrails/
allowlist-policy-get.mdx
allowlist-policy-set.mdx
deploy-limits.mdx
deploy-permission.mdx
org-cleanup.mdx
org-limits-get.mdx
org-limits-set.mdx
integrations/
agent-directives/
attachments-list.mdx
attachments-replace.mdx
create.mdx
delete.mdx
discover-in-repo.mdx
get.mdx
import.mdx
list.mdx
patch.mdx
presign-upload.mdx
resync.mdx
email/
delete.mdx
list.mdx
provision.mdx
status.mdx
update.mdx
github-app/
installation-add-repo.mdx
installation-delete.mdx
installation-repos.mdx
installation-token.mdx
installations-list.mdx
repos-list.mdx
token-for-repo.mdx
github-user-tokens/
authorize.mdx
user-token-delete.mdx
user-token-status.mdx
user-token-validate.mdx
user-token.mdx
knowledge/
catalog.mdx
create.mdx
delete.mdx
get.mdx
list.mdx
oauth-install.mdx
patch.mdx
rotate.mdx
test.mdx
linear/
integration-delete.mdx
integration-get.mdx
integration-update.mdx
integrations-item.mdx
integrations-list.mdx
integrations-manual.mdx
oauth-install.mdx
projects.mdx
teams.mdx
user-connection-delete.mdx
user-connection-get.mdx
slack/
integration-delete.mdx
integration-get.mdx
integration-save.mdx
integration-test.mdx
manifest.mdx
oauth-install.mdx
overview.mdx
provider-keys/
current-plan.mdx
org-delete.mdx
org-get.mdx
org-set.mdx
resolved.mdx
user-delete.mdx
user-get.mdx
user-set.mdx
rate-limits.mdx
scheduled-agents/
create.mdx
delete.mdx
get.mdx
list.mdx
overview.mdx
run.mdx
update.mdx
scopes.mdx
secrets/
personal-delete.mdx
personal-list.mdx
personal-set.mdx
resolved.mdx
team-delete.mdx
team-list.mdx
team-set.mdx
sessions/
approvals-list.mdx
approvals-resolve.mdx
collaborators.mdx
create.mdx
delete.mdx
detect-env-vars.mdx
detected-env-vars.mdx
env-vars-delete.mdx
env-vars-get.mdx
env-vars-set.mdx
env-vars.mdx
events.mdx
files-delete.mdx
files-download.mdx
files-list.mdx
files-mkdir.mdx
files-read.mdx
files-rename.mdx
files-search.mdx
files-upload.mdx
files-write.mdx
get.mdx
git-clone.mdx
git-operation.mdx
git-sync.mdx
heartbeat.mdx
history.mdx
instructions-get.mdx
instructions-set.mdx
instructions.mdx
launch.mdx
lifecycle.mdx
list.mdx
load-mcps.mdx
load-skills.mdx
load-tools.mdx
manage.mdx
metadata.mdx
pause.mdx
prompt-cancel.mdx
prompt-rewind.mdx
prompt.mdx
rename.mdx
resume.mdx
run-server.mdx
search.mdx
start.mdx
tools-list.mdx
v0-create.mdx
v0-delete.mdx
v0-get.mdx
v0-git.mdx
v0-list.mdx
v0-prompt.mdx
v2-connect.mdx
v2-patch.mdx
v2-refresh.mdx
v2-start.mdx
visibility.mdx
workspace-state.mdx
templates/
build-logs-history.mdx
build-logs.mdx
build.mdx
context-get.mdx
context-resolve.mdx
context-set.mdx
create.mdx
delete.mdx
fix-session.mdx
get.mdx
guardrails-create.mdx
guardrails-delete.mdx
guardrails-list.mdx
guardrails-resolve.mdx
guardrails-update.mdx
list.mdx
repos.mdx
save-snapshot.mdx
secret-delete.mdx
secrets-list.mdx
secrets-update.mdx
update-config.mdx
websockets/
collaboration.mdx
overview.mdx
prompt.mdx
terminal.mdx
token-exchange.mdx
concepts/
agents.mdx
coding-agents.mdx
context.mdx
deployments.mdx
guardrails.mdx
integrations.mdx
observability.mdx
organizations.mdx
real-time.mdx
sessions.mdx
skills.mdx
templates.mdx
guides/
authentication-walkthrough.mdx
best-practices.mdx
long-running-prompts.mdx
managing-sessions-at-scale.mdx
overview.mdx
pulling-activity-and-telemetry.mdx
streaming-prompts-over-websockets.mdx
teach-the-agent-your-codebase.mdx
webhooks-and-triggers.mdx
working-with-files.mdx
images/
favicon.svg
logo-dark.svg
logo-light.svg
introduction.mdx
mint.json
open-source/
api/
deployments/
create.mdx
delete.mdx
get.mdx
list.mdx
search.mdx
domains/
add.mdx
get.mdx
remove.mdx
logs.mdx
overview.mdx
user/
me.mdx
cli/
approve.mdx
auth.mdx
config.mdx
deploy.mdx
destroy.mdx
domain.mdx
fix.mdx
init.mdx
list.mdx
logs.mdx
overview.mdx
run.mdx
search.mdx
secrets.mdx
session.mdx
status.mdx
validate.mdx
features/
auth.mdx
custom-domains.mdx
database.mdx
machine-tiers.mdx
secrets.mdx
guides/
agent-workflow.mdx
discovery.mdx
logs-debugging.mdx
troubleshooting.mdx
overview.mdx
self-hosting/
admin-commands.mdx
configuration.mdx
docker-compose.mdx
overview.mdx
requirements.mdx
templates/
backend-service.mdx
docker.mdx
overview.mdx
static-site.mdx
web-app.mdx
quickstart.mdx
infra/
docker-compose.yml
Dockerfile.api
Dockerfile.worker
entrypoint-api.sh
local.env.example
LICENSE
packages/
agent/
.gitignore
.goreleaser.yml
cmd/
runtm-api/
main.go
... 474 moreFAQ
runtm is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes files. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is runtm?
- Open-source sandboxes where coding agents build and deploy. Spin up isolated environments where Claude Code, Cursor, Codex, and other agents code and ship software. With live URLs, logs, and previews.
- How do I install runtm?
- Run these in Claude Code: npx -y skills add runtm-ai/runtm --agent claude-code. Then prompt normally.
- Does runtm auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is runtm free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.