# @introspection-ai/cli

The [Introspection](https://introspection.dev) command-line interface for
operating agents across local development and the Introspection platform.

```bash
npm install -g @introspection-ai/cli

introspection login
introspection --help
```

`introspection setup` adds a small native skill for detected Codex and Claude
Code hosts. The skill tells future agent sessions to run `introspection skills`
and read the workflow that matches the request. The complete workflows remain
in the docs bundle and are loaded through the CLI when needed.

Give the coding agent the complete machine onboarding entrypoint:

```text
First read https://docs.introspection.dev/agents.md and follow it.
```

The agent prepares the CLI, reads the current docs-owned workflow through
`introspection skills`, and runs setup for Pi and Recipes when the workflow
needs them. The user does not run setup manually.

Or run without installing:

```bash
npx @introspection-ai/cli --help
```

The platform-specific CLI, its Rust judge engine, and its matching Harbor
adapter wheel are delivered via an optional dependency
(`@introspection-ai/cli-<os>-<cpu>`) selected automatically by npm. The CLI
requires Node.js 24 or newer. On Node 18–23 the npm launcher installs but every
command exits with upgrade instructions.

Full documentation: https://github.com/introspection-org/introspection-cli