cs — CoreSpeed CLI

The command-line tool for CoreSpeed: sign in through the browser, create API keys, write agent configuration, manage connectors and your organization's own MCP servers, and call tools from a terminal.

Install

# One-off, no install (ideal for agents / CI)
npx @corespeed/cs --help

# Global install
npm install -g @corespeed/cs
cs --help

# Bun equivalents
bunx @corespeed/cs --help
bun install -g @corespeed/cs

Requires Node.js >= 20 (or Bun). Zero runtime dependencies.

Quick start

cs login                 # browser PKCE login; pick an org; stores tokens under ~/.config/cs
cs whoami                # show the current user, org, permissions and key ceiling
cs switch                # change the active org without signing in again
cs keys create my-key    # mint an sk-cs-* API key (shown once); --permission <slug> to give it one you hold
cs mcp-config            # emit MCP client config JSON for the unified /mcp surface
cs tie                   # tie this machine: sign in, pick a folder to share, check it end to end

Run cs --help for the full command list (logout, keys, connectors, remote, mcp, tie, untie, usage, …).

Environment

| Variable | Default | Purpose | |---|---|---| | CS_CONFIG_DIR | ~/.config/cs | Where the session is stored, and tie.json with it | | CS_API_KEY | unset | An API key cs tie acts with instead of a session: its principal — an agent, or you — owns the machine, and nothing signs in | | CS_LOGIN_PORT | random | Fixed loopback port for the sign-in callback (signing in over SSH) | | DO_NOT_TRACK | unset | Set to 1 to send a bare cs user agent instead of the product/version string |

Learn more

Every command, flag and exit code: corespeed.io/docs/cli.

For Claude Code and Codex, the CoreSpeed plugin wires up the MCP server with a browser sign-in and bundles skills for this CLI: github.com/corespeed-io/cs.

License

Apache-2.0 © CoreSpeed, Inc.