supercli Knowledge Base

supercli runs in two modes: Local-only (default, no server required) or Server mode (optional, shared backend). Run npx supercli help for instant usage or npx supercli --help for all options.

Local-only: npx supercli help, supercli beads issue list, supercli skills list — everything works out of the box, no installation needed.

Server mode: Install dependencies (npm install), copy .env.example to .env, then start via npm start or supercli --server. The web UI is reachable at http://localhost:3000.

Refer to the repository README for detailed setup instructions.

Every executable unit becomes a capability, whether it originates from CLI commands, OpenAPI endpoints, MCP tools, workflows, or HTTP requests. supercli indexes capabilities as namespace.resource.action, exposes schemas, and lets agents discover, inspect, and execute consistently.

supercli skills list
supercli skills search "database"
supercli skills get beads.issue.create

Agents route requests through the capability discovery layer, which maps namespaces to harnesses/adapters. Execution envelopes guarantee deterministic JSON responses and exit codes.

Agents/Humans → supercli runtime → Capability Router → Harness / Adapter → Tool

supercli help                     # list harnesses
supercli <namespace>              # list capabilities in harness
supercli beads issue list --json
supercli skills list
supercli skills teach
supercli discover --intent "deploy app"
supercli inspect beads issue create
supercli plugins explore
supercli plugins show <name>

--json, --human, and --compact control output, while exit codes communicate validation, resource, or integration errors.

supercli extends via 999 bundled plugin harnesses and supports custom plugin authoring. Each plugin lives in its own directory with isolated metadata — no shared file edits needed.

Need more? Check docs/plugins-how-to.md for authoring details, or supercli plugins explore to browse available plugins.

The platform is evolving toward a mesh that handles discovery, routing, execution, composition, and governance. Key areas under exploration include a unified capability registry, graph-native discovery, mesh-wide policy, DAG orchestration, agent endpoints, composition tooling, telemetry, and richer plugin UX.