Loomplane / CLI & agents

Same platform, from a terminal or an agent.

Install it with brew install xraph/tap/loomctl. loomctl does what the dashboard does, for terminals and CI. It runs on API keys that act as you, with your role, and can be read-only. loomctl mcp turns the same commands into tools an AI agent can use.

MCP server

Let an agent plan. Decide whether it can deploy.

Make an API key under Settings, add loomctl mcp to your agent's configuration, and it can analyze, write a manifest and plan. Approving and retrying need --allow-deploy. A manifest that doesn't parse comes back with each problem and its line, so the agent can fix it and save again.

  • The manifest schema is a resource the agent can read
  • Secrets are set but never shown back
  • Works with Claude Code: claude mcp add loomplane -- loomctl mcp
.mcp.jsonJSON
{  "mcpServers": {    "loomplane": {      "command": "loomctl",      "args": ["mcp"],      "env": {        "LOOMPLANE_URL": "https://loom.acme.dev",        "LOOMPLANE_API_KEY": "lp_live_…"      }    }  }}
MCP server config2 env vars
Tools

What an agent can do.

ToolWhat it does
whoamiWho the key acts as, and its permissions
list_projectsThe organization's projects
analyzeReads a project's repositories, or the ones named, and waits until each is done
get_manifest, draft_manifest, save_manifestReads, drafts and saves loomplane.yaml
create_plan, list_plans, get_plan, reject_planPlans an environment and reads the result, optionally scoped to some repositories
list_deployments, get_deploymentFollows deployments step by step
statusWhat runs where, with addresses and drift
list_variables, set_variableVariables, with secret values never shown
approve_plan, retry_deploymentOnly with --allow-deploy
CI

Plan on every merge. Approve where you review.

Run loomctl plan in CI so every merge produces a plan, and approve it from the dashboard or the terminal. Use a read-only key for status checks and a separate key for the people who approve.

plan.ymlYAML
on:  push: { branches: [main] }jobs:  plan:    runs-on: ubuntu-latest    steps:      - run: echo "$LOOM_KEY" | loomctl login --url $LOOM_URL --key -      - run: loomctl analyze mono      - run: loomctl plan mono --env production
.github/workflowson push to main
Get started

Deploy your monorepo to your own clouds this afternoon.

Open source and self-hosted. Your applications don't need Forge, or Go.

$docker pull ghcr.io/xraph/loomplane:latestServer
$brew install xraph/tap/loomctlCLI
Read the install guide