CLI Overview

The skillett CLI is how agents interact with the platform. All commands output structured JSON (except status in interactive terminals), making them parseable by any AI agent.

Installation

npx skillett login

No global install needed. npx always runs the latest version.

Command Reference

Command	Description
`skillett login`	Authenticate via device flow or API key
`skillett status`	Show account info and connected integrations
`skillett skills`	Discover integrations and endpoints
`skillett run`	Execute a skill endpoint
`skillett connect`	Connect an integration via OAuth
`skillett disconnect`	Disconnect an integration
`skillett pull`	Download skill docs locally
`skillett setup`	Re-run platform detection and skill install
`skillett add`	Add a skill to your workspace
`skillett remove`	Remove a skill from your workspace
`skillett list`	List installed skills
`skillett whoami`	Show current authenticated user
`skillett feedback`	Submit feedback or bug reports

Output format

All commands return JSON to stdout. Agents parse this directly:

{
  "status": 200,
  "data": { ... }
}

Error responses follow the same pattern:

{
  "error": "integration_not_connected",
  "message": "The user needs to connect their github account first.",
  "action_url": "https://app.skillett.dev/dashboard/integrations"
}

Exit codes

Code	Meaning
`0`	Success
`1`	Client error (bad input, auth failure, 4xx)
`2`	Network or server error (5xx, timeout)

Environment variables

Variable	Description
`SKILLETT_API_KEY`	Your API key (set by `skillett login`)
`SKILLETT_PLATFORM`	Detected platform (`claude`, `cursor`, `windsurf`, `generic`)