Runmount

Run agents anywhere with the context and services they need.

Install

npm install --global @runmount/cli

Usage

runmount login
runmount create engineering
runmount add engineering ./AGENTS.md
runmount create project-foo --from engineering
runmount exec project-foo -- codex

exec keeps the child process in your current repository and exposes the resolved context in RUNMOUNT_CONTEXT_DIR. It creates a recorded Runmount run and removes the temporary context directory when the child exits.

Current MVP

Profiles are versioned, private by default, and can contain files or safe directories. Runmount excludes secrets and generated directories such as .env, .git, node_modules, and dist from directory uploads.

# Inspect and materialize context.
runmount list
runmount show project-foo
runmount delete project-foo --yes
runmount mount project-foo

# Inspect and resume recorded runs.
runmount runs project-foo
runmount resume run_abc123 -- codex

# Create a shared workspace and a workspace-owned profile.
runmount org create acme
runmount whoami
runmount create acme/design
runmount personal create "My design tools"

Invite teammates by email. They join automatically the next time they sign in:

runmount org invite acme [email protected] member
runmount org invite acme [email protected] admin
runmount org members acme
runmount org invites acme

Owners and admins can change roles, revoke pending invitations, or remove a member. Firebase UID membership commands remain available for migrations and automation, but teams do not need them for ordinary onboarding.

runmount org member role acme <firebase-user-id> admin
runmount org member remove acme <firebase-user-id>
runmount org invite revoke acme <invite-id>

Service credentials are stored separately from profile files. Connect an API-key service without putting its value in shell history, then bind it to a shared profile or add it privately as an overlay:

export LINEAR_API_KEY=lin_api_...
runmount service connect linear --api-key-env LINEAR_API_KEY --workspace acme
runmount profile service add acme/design linear workspace <connection-id>

export FIGMA_TOKEN=figd_...
runmount service connect figma --api-key-env FIGMA_TOKEN
runmount profile overlay add acme/design figma specific <connection-id>
runmount exec acme/design -- codex

Remove a service from a shared profile or your personal overlay without deleting the underlying connection:

runmount profile service remove acme/design linear
runmount profile overlay remove acme/design figma

Personal service connections are private by default. Use --with to compose a personal profile into the same agent run:

runmount exec acme/design --with my-design-tools -- codex

Do not add tokens, credentials, or .env files to a profile.

Run runmount without arguments to see all available commands.

Development

Requires Node.js 22 or newer.

npm install
npm run build
npm test

The Runmount service and website are maintained separately. Learn more at runmount.com.