@actera/cli

Command line tools for Actera onboarding and integration workflows.

Install

npm install -g @actera/cli

Or run it without a global install:

npx @actera/cli --help

Login

actera login
actera whoami

actera login opens the Actera dashboard authorization flow and stores credentials in ~/.config/actera/credentials.json.

For CI, skip login and set:

ACTERA_API_URL=https://api.actera.tech
ACTERA_API_KEY=<admin-api-key>

Import tools from OpenAPI

actera import -spec ./openapi.yaml

The CLI parses the spec through Actera, saves a pending review session for your workspace, and prints the dashboard URL where you can approve tools.

Use -base-url when you need to override the spec server URL:

actera import -spec ./openapi.yaml -base-url https://api.example.com

Propose SDK integration config

Generate a route manifest first:

actera routes next

Then propose a hosted SDK integration config:

actera integration propose \
  -spec ./openapi.yaml \
  -routes ./actera.routes.json \
  -out ./actera.integration.json

Apply a reviewed config:

actera integration apply -config ./actera.integration.json -activate

Route manifests

For Next.js apps, the CLI can discover routes from app/ and pages/:

actera routes next --output actera.routes.json

For Express and Hono apps, pass a JSON file containing either an array of routes or an object with a routes array:

[
  { "path": "/projects", "title": "Projects" },
  { "path": "/team", "title": "Team" }
]

actera routes express --routes routes.json
actera routes hono --routes routes.json

Environment

ACTERA_API_URL sets the API base URL. Defaults to http://localhost:3002.

ACTERA_API_KEY overrides the saved login credentials.

ACTERA_WEB_URL sets the dashboard URL printed after import. Defaults to http://localhost:3000.