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, call tools from a terminal, and move files in and out of your organization's Drive.
Install
# One-off, no install (ideal for agents / CI)
npx @corespeed/cs@latest --help
# Global install
npm install -g @corespeed/cs
cs --help
# Bun equivalents
bunx @corespeed/cs --help
bun install -g @corespeed/cs
npm installs a native cs for macOS (Apple silicon and Intel), Linux (x64 and
arm64) and Windows (x64); its launcher needs Node.js >= 20 (or Bun). Other
systems, such as Windows on Arm, are not supported yet. Do not install with
--omit=optional.
In Windows PowerShell, type npx.cmd and cs.cmd: a plain npx or cs runs
npm's .ps1 script, which Windows refuses by default ("running scripts is
disabled on this system").
npx.cmd @corespeed/cs@latest --help
cs.cmd --help
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 drive put ./q3.pdf reports/q3.pdf # a local file into your Drive; get / ls / mv / rm / share too
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, drive, 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.