Install

The agenta CLI ships as the agentaos npm package and installs two equivalent binary names: agenta (used throughout these docs) and agentaos. It talks to the same API your @agentaos/pay SDK integration uses, so anything you can do in code you can also do from a terminal: create checkouts, list subscriptions, pull receipts, check readiness.

Requirements

Node.js 20 or later. The installer scripts work on macOS, Linux, and Windows (WSL).

curl -fsSL https://agentaos.ai/install | bash

npm install -g agentaos

The curl script downloads a prebuilt binary and puts agenta on your PATH. The npm install builds the same CLI from the published package and works anywhere npm install -g works.

Verify

agenta --version

Output

3.1.0

If agenta isn’t found after a curl install, open a new shell so your PATH picks up the change.

Installing Node.js

If you’re going the npm route and don’t have Node 20+ installed:

curl -fsSL https://fnm.vercel.app/install | bash
fnm install 20
fnm use 20

Then re-run npm install -g agentaos.

AI agent setup

For an agent or automation that uses AgentaOS for you: in Claude Code, install the plugin; any other agent can read the skill directly:

claude plugins marketplace add AgentaOS/agentaos
claude plugins install agentaos@agentaos

Or read it directly at agentaos.ai/SKILL.md.

Next steps

Login

Authenticate the CLI with your AgentaOS account.

Quickstart

Create your first checkout end to end.

​Requirements

​Install

​Verify

​Installing Node.js

​AI agent setup

​Next steps