@overcut/cli

Command-line interface for Overcut, the Enterprise Software Factory: agentic workflows across GitHub, GitLab, Bitbucket, Azure DevOps, Jira, Linear and Slack that clear your backlog and PRs at enterprise scale. Sign in from the terminal, connect your coding agent (Claude Code, Cursor, Codex, ...) to Overcut's MCP server, and manage API tokens without opening the web app.

Quick start

npx @overcut/cli init

(npx overcut init works too; overcut is a short alias for this package.)

One command: it signs you in (or up) in the browser when there is no session, then installs the Overcut MCP server into the coding agents it finds on your machine.

Then open your coding agent inside a repository and ask it to "set up Overcut for this repo". The agent reads the repository, connects the Git provider, registers the repository, proposes a first workflow, dry-runs it and activates it. Everything after init happens in the conversation with your agent.

For repeated use:

npm install -g @overcut/cli
overcut login
overcut mcp

Requires Node 20 or newer.

Supported coding agents

overcut mcp detects the hosts installed on your machine and writes the MCP server into each one's user-level config: Claude Code, Cursor, Codex, Windsurf, VS Code, Zed, Gemini CLI and every other host add-mcp knows. Pick with --host <name>, take all with --all, or --print the config block to paste it yourself.

Commands

| Command | What it does | | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | overcut login [--idp <alias>] [--no-browser] | Sign in or sign up through the browser and store a session. Opens the Overcut login page (GitHub, email, SSO) with an authorization-code + PKCE loopback redirect; a live Keycloak session passes through on the first click. --idp github or --idp <sso-alias> skips the page and goes straight to that provider. --no-browser falls back to the device-code flow for SSH and headless sessions, which can only offer the methods shown on the login page. | | overcut init [--host <name...>] [--all] [--print] [--launch] | Get started: sign in when there is no session, then install the Overcut MCP server. Same options as overcut mcp. | | overcut mcp [--host <name...>] [--all] [--print] [--launch] | Install the Overcut MCP server into your coding agent's user-level config. Detects installed hosts (Claude Code, Cursor, Codex, Windsurf, VS Code, Zed, Gemini CLI, and the rest add-mcp knows) and asks which to configure; --host picks by name, --all takes every detected host. Mints one API token per host, named " on ", and rotates it on re-run. --print shows the config block instead of writing it. --launch starts Claude Code or Codex with a setup prompt. | | overcut logout | Forget the stored session, revoke it at the identity provider, revoke the MCP tokens minted on this machine and remove the overcut entry from the host configs. | | overcut whoami | Show the signed-in user and current workspace. | | overcut token create <name> | Create an API token for CI and scripts. Printed once. | | overcut token list | List your API tokens. | | overcut token revoke <id> | Delete an API token. |

Every command accepts --json for machine-readable output on stdout, and --url <graphqlUrl> to target a specific server.

Configuration

| Variable | Purpose | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | OVERCUT_API_URL | GraphQL endpoint. Defaults to https://server.overcut.ai/graphql. Use https://server.stg.overcut.ai/graphql for staging or your own host on-prem. | | OVERCUT_API_TOKEN | An API token. When set, login is not needed and the stored session is ignored. Intended for CI. | | OVERCUT_CONFIG_DIR | Where the session file lives. Defaults to ~/.overcut. | | NO_COLOR | Disable colour in human output. |

Sessions are stored in ~/.overcut/credentials.json with mode 0600, one entry per server. They hold a short-lived Overcut session token and a refresh token; run overcut logout to revoke both.

overcut mcp writes the MCP server with a literal Authorization: Bearer <token> header into the host's user-level config only (for example ~/.cursor/mcp.json, ~/.claude.json, ~/.codex/config.toml). It never writes project-level files such as .mcp.json or .cursor/mcp.json, because those get committed and the token carries the user's full permissions. Tokens appear on the API Tokens page of the web app and can be revoked there or with overcut logout.

Exit codes

| Code | Meaning | | ---- | ------------------------------------------------------------------------------ | | 0 | Success | | 64 | Usage error | | 69 | The server or identity provider is unreachable or does not support the request | | 70 | Unexpected error | | 77 | Not logged in, session expired, or permission denied |

Links

• Web app: app.overcut.ai
• Documentation: docs.overcut.ai
• Source and issues: github.com/overcut-ai/overcut (packages/cli)

License

MIT