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:
npx @scalekit-inc/cli setup
# Or install globally for repeated usenpm install -g @scalekit-inc/cliscalekit setupRun the setup wizard
Section titled “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
Section titled “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:
npx -y @scalekit-inc/cli setup -y # every detected agentnpx -y @scalekit-inc/cli setup claude -y # one agentThe 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/skillsunless 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 runnpx -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
Section titled “Target a specific tool”Pass the tool name to skip the wizard and install directly:
scalekit setup cursorscalekit setup claude # aliases: claude-code, ccscalekit setup codex # alias: opencodescalekit setup copilot # aliases: github-copilot, ghcpCommand reference
Section titled “Command reference”Run any command with npx @scalekit-inc/cli <command>, or with scalekit <command> (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 <name> | Shortcut for extension install <name>. |
extension install <name> | Installs the authstack plugin for one agent. |
extension update <name> | Updates the authstack plugin for one agent. |
extension uninstall <name> | 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.
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
Section titled “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
Section titled “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
Section titled “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:
export DO_NOT_TRACK=1# orexport SCALEKIT_TELEMETRY=0The CLI’s README lists each event and field.
Start building
Section titled “Start building”After setup, tell your coding agent what you’re building. The authstack plugin routes you to the right skill.
I want to add agent auth to my project. Help me get started with AgentKit.Add enterprise SSO to my Next.js app using SaaSKit.I want to add agent auth to my project. Help me get started with AgentKit.Add enterprise SSO to my Next.js app using SaaSKit.I want to add agent auth to my project. Help me get started with AgentKit.Add enterprise SSO to my Next.js app using SaaSKit.I want to add agent auth to my project. Help me get started with AgentKit.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.