autoplans-agent

The Autoplans coding agent, on your machine — in the terminal or in your browser.

Install

npm install -g autoplans-agent

Use

autoplans           # terminal
autoplans ui        # browser
autoplans --help

The agent requires an autoplans.dev account:

autoplans login     # opens your browser, saves the credential (0600)
autoplans logout    # forgets it

Signed out, the agent refuses to run. AUTOPLANS_API_KEY in the environment still wins over the saved credential, for CI and scripts.

Every session carries the Autoplans engineering method (SOLID, testing, honest reporting) and a secure-coding skill the agent loads for security-sensitive work. The default model is a free one (opencode/big-pickle), so the agent works with zero further setup; pick any other model in the interface or via AUTOPLANS_MODEL.

Configuration

| Variable | Purpose | | --- | --- | | AUTOPLANS_API_KEY | Bypasses the saved login (CI, scripts) | | AUTOPLANS_MODEL | Default model, as provider/model | | AUTOPLANS_MCP_URL | Override the Autoplans API endpoint (self-hosted) |

Anything else goes in ~/.config/autoplans/agent.json, which is merged over the defaults — models, providers, agents, keybinds, themes:

{
  "model": "openrouter/anthropic/claude-sonnet-4.5",
  "provider": {
    "openrouter": { "options": { "apiKey": "sk-or-..." } }
  }
}

Config is assembled at launch and passed to the agent in memory. Nothing is written to your machine, and any existing agent configuration you have is left untouched.

Related

• Agent Console — the same agent in the Autoplans dashboard, no install required
• Code Agent — long-running work against a GitHub repository, in the cloud
• opencode-autoplans — Autoplans tools for an existing opencode install

Built on

The agent runtime is opencode, MIT licensed, installed as a dependency and launched with Autoplans' configuration. This package does not modify or redistribute it. Not affiliated with the opencode project.

Command output — help, usage, server logs — is rebranded on the way to your terminal. Two things are deliberately left alone:

• The full-screen terminal UI, which draws its own header. It is a live-redrawn ANSI surface, and substituting a longer word would shift every column after it. Rebranding it means forking the runtime, which costs the free upgrades this wrapper is built for.
• Redirected output. autoplans run … | jq gets the runtime's bytes untouched, because the runtime has a provider literally named opencode and rewriting a piped JSON stream would corrupt it. OPENCODE_* variable names stay as they are for the same reason — they are real names you may have to type.