> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns. > > **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal): > ```bash > npx -y @scalekit-inc/cli setup -y > ``` > > Global: > ```bash > npm install -g @scalekit-inc/cli > scalekit setup -y > ``` > > Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`. > Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim. > [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # Scalekit CLI Install and manage the authstack plugin and Scalekit skills for AI coding agents with the Scalekit CLI. The Scalekit CLI (`@scalekit-inc/cli`) installs the authstack plugin and Scalekit skills for your AI coding agents. It supports Cursor, Claude Code, GitHub Copilot and Codex, plus any agent that reads skills from `~/.agents/skills`, such as Cline, Amp and OpenCode. The CLI requires **Node.js 20 or later**. Run it with `npx`, or install it globally: ```bash npx @scalekit-inc/cli setup # Or install globally for repeated use npm install -g @scalekit-inc/cli scalekit setup ``` ## Run the setup wizard Running `setup` with no arguments starts an interactive wizard. The wizard marks the agents it detects on your machine, lets you choose which ones to set up, and then offers to install the Scalekit skills. **The wizard needs an interactive terminal.** Without one, for example when a coding agent or a CI job runs the command, `setup` exits with an error that tells you to add `-y`. ## Run setup from a coding agent or CI Coding agents and CI jobs have no terminal to answer prompts. Add `-y` to skip every prompt: ```bash npx -y @scalekit-inc/cli setup -y # every detected agent npx -y @scalekit-inc/cli setup claude -y # one agent ``` The first `-y` tells `npx` to install the package without asking. The second `-y` tells the CLI to skip its own prompts. `setup -y` sets up every agent it detects: - **Agents detected**: the CLI installs the authstack plugin for each detected agent. It then installs the Scalekit skills for detected agents that did not get a plugin, and to `~/.agents/skills` unless a plugin already provides the same skills. - **No agent detected** (CLI 0.3.24 or later): the CLI installs only the Scalekit skills, to `~/.agents/skills`, and exits with status 0. Earlier versions try to set up every agent instead, so run `npx -y @scalekit-inc/cli@latest`. Add `--dry-run` to print the commands without running them. A dry run of `setup` never prompts. ## Target a specific tool Pass the tool name to skip the wizard and install directly: ```bash scalekit setup cursor scalekit setup claude # aliases: claude-code, cc scalekit setup codex # alias: opencode scalekit setup copilot # aliases: github-copilot, ghcp ``` ## Command reference Run any command with `npx @scalekit-inc/cli `, or with `scalekit ` (short form: `sk`) after a global install. | Command | What it does | |---|---| | `setup [stack]` | Sets up the authstack plugin and Scalekit skills. Omit `[stack]` to run the wizard. | | `setup extension ` | Shortcut for `extension install `. | | `extension install ` | Installs the authstack plugin for one agent. | | `extension update ` | Updates the authstack plugin for one agent. | | `extension uninstall ` | Removes the authstack plugin from one agent. | | `extension list` | Lists the supported agents and whether each one is detected. | | `extension status [stack]` | Shows whether each agent is detected and whether its plugin is up to date. | | `open [stack]` | Opens Cursor, Claude Code or Codex with a first prompt filled in. With `-y`, name the stack. | | `skills install` | Installs the Scalekit skills to `~/.agents/skills` and to detected agents that lack the plugin. | | `update` | Updates the Scalekit CLI itself. | `extension` also has the short form `ext`. Stack and extension names accept the IDs and aliases in [Supported tools](#supported-tools). ### Flags These flags work on every command: | Flag | Description | |---|---| | `-y`, `--non-interactive` | Skip all prompts and use defaults. | | `--json` | Print machine-readable JSON instead of styled output. | | `--plain` | Turn off colors and styling. The CLI also respects `NO_COLOR`. | These flags apply to individual commands: | Flag | Commands | Description | |---|---|---| | `-y`, `--yes` | `setup`, `extension install`, `extension update`, `extension uninstall`, `open`, `skills install`, `update` | Skip confirmation prompts. Required for `setup`, `open` and `skills install` when no interactive terminal is available. | | `--dry-run` | Same as `-y` | Print the commands, or the destination for `open`, without running them. | | `--skip-skills` | `setup` | Install the plugins only and skip the Scalekit skills. | ### Supported tools | Tool | ID | Aliases | |---|---|---| | Cursor | `cursor` | | | Claude Code | `claude` | `claude-code`, `cc` | | GitHub Copilot | `copilot` | `github-copilot`, `ghcp` | | Codex / OpenCode | `codex` | `opencode` | ### What gets installed For each tool, the CLI installs two kits from the authstack plugin: - **AgentKit** - skills for building agents with delegated auth, scoped permissions, and tool calls - **SaaSKit** - skills for adding SSO, SCIM, MFA, sessions, and API auth to SaaS apps For Cursor and Codex, the CLI downloads the plugin and copies it to the tool's local plugin directory. For Claude Code and GitHub Copilot, it runs the tool's native plugin marketplace commands. ## Turn off telemetry The CLI sends anonymous usage events, such as whether a plugin or skill install succeeded. It stores a random ID in `~/.scalekit/anonymous_id` and never sends project paths, file contents or credentials. To turn telemetry off, set either environment variable: ```bash export DO_NOT_TRACK=1 # or export SCALEKIT_TELEMETRY=0 ``` [The CLI's README](https://github.com/scalekit-inc/cli#telemetry) lists each event and field. ## Start building After setup, tell your coding agent what you're building. The authstack plugin routes you to the right skill. **Claude Code** ```text I want to add agent auth to my project. Help me get started with AgentKit. ``` ```text Add enterprise SSO to my Next.js app using SaaSKit. ``` **Cursor** ```text I want to add agent auth to my project. Help me get started with AgentKit. ``` ```text Add enterprise SSO to my Next.js app using SaaSKit. ``` **GitHub Copilot** ```text I want to add agent auth to my project. Help me get started with AgentKit. ``` ```text Add enterprise SSO to my Next.js app using SaaSKit. ``` **Codex** ```text I want to add agent auth to my project. Help me get started with AgentKit. ``` ```text Add enterprise SSO to my Next.js app using SaaSKit. ``` The authstack plugin picks up the prompt and routes to the right skill: AgentKit for agent auth, SaaSKit for app auth. --- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |