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

1.2.0

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

No 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

Building an agent or automation that should use AgentaOS on your behalf? Install the skill for guided setup instead of hand-rolling the integration:

npx skills add AgentaOS/skills@agenta

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

​No Node.js?

​AI agent setup

​Next steps