@adityaprotocol/cli

Command-line interface for Aditya Protocol — manage commands, approvals, and runs from your terminal.

Installation

npm install -g @adityaprotocol/cli

Or run without installing:

npx @adityaprotocol/cli health

Setup

Set your operator token as an environment variable:

export ADITYA_TOKEN="apt_user_your_token_here"

Optionally set a default workspace:

export ADITYA_WORKSPACE="your-workspace-id"

Commands

| Command | Description | |---|---| | aditya health | Check API status | | aditya workspaces | List your workspaces | | aditya nodes <ws-id> | List nodes in a workspace | | aditya commands <ws-id> [status] | List commands (optional status filter) | | aditya pending <ws-id> | List commands awaiting approval | | aditya approve <cmd-id> [reason] | Approve a pending command | | aditya reject <cmd-id> [reason] | Reject a pending command | | aditya runs <ws-id> | List runs | | aditya audit <ws-id> | Show recent audit trail | | aditya create <ws-id> <node-id> <type> | Create a new command | | aditya export <ws-id> | Export all workspace data (JSON) |

Usage Examples

Check API health

$ aditya health
API: healthy (2026-04-05T12:00:00.000Z)

List pending approvals

$ aditya pending bd6e32d0-ab21-428e-9e0b-a78cd8dce23c

Pending approval:
  ID          Type      Node        Created
  --------    ------    --------    -------
  a1b2c3d4    deploy    e5f6g7h8    2m ago

Approve a command

$ aditya approve a1b2c3d4-full-uuid "Verified deployment is safe"
Command a1b2c3d4... approved. Status: approved

Create a command and wait for approval

$ aditya create $ADITYA_WORKSPACE $NODE_ID deploy
Command created: a1b2c3d4-...
Status: pending_approval (awaiting approval)

Export workspace data

$ aditya export $ADITYA_WORKSPACE > workspace-backup.json

Environment Variables

| Variable | Required | Description | |---|---|---| | ADITYA_TOKEN | Yes (except health) | Operator token starting with apt_user_ | | ADITYA_API | No | API base URL (default: https://api.adityaprotocol.com) | | ADITYA_WORKSPACE | No | Default workspace ID for commands that need one |

CI/CD Integration

Use the CLI in GitHub Actions:

- name: Check Aditya Protocol health
  run: npx @adityaprotocol/cli health

- name: Create deployment command
  env:
    ADITYA_TOKEN: ${{ secrets.ADITYA_TOKEN }}
  run: npx @adityaprotocol/cli create $WORKSPACE_ID $NODE_ID deploy

For a full approval gate workflow, see the Aditya Protocol GitHub Action.

License

MIT