@beyondidentity/ai-cli

Beyond Identity AI CLI - unified command-line interface for AI agent operations.

Features

- Proxy Management (byid proxy): Start, stop, and manage the local proxy service
- Auth Flow (byid auth): Beyond Identity authentication helper
- Launch (byid launch): Launch programs with auth configured

Installation

``bash


Install from rolling channel (Cloudsmith)

npm install @beyondidentity/ai-cli@rolling

Or use directly with npx

npx @beyondidentity/ai-cli@rolling --help
`

Usage

`bash


Show all commands

byid --help

Proxy commands

byid proxy start # Start local proxy
byid proxy info # Show proxy status
byid proxy stop # Stop local proxy

Auth flow

byid auth --help

Launch programs

byid launch --help
`

Private Registry Configuration

Configure ~/.npmrc for Cloudsmith access:

`
@beyondidentity:registry=https://npm.cloudsmith.io/beyond-identity/ai-agents-npm/
//npm.cloudsmith.io/beyond-identity/ai-agents-npm/:_authToken=YOUR_TOKEN
`

Platform Support

Supports macOS (Intel/ARM), Linux (x64/ARM64), and Windows (x64).

Architecture

This shim package automatically installs the correct platform binary via npm's optionalDependencies mechanism. Platform-specific binaries are published as separate packages:

- @beyondidentity/ai-cli-darwin-arm64
- @beyondidentity/ai-cli-darwin-x64
- @beyondidentity/ai-cli-linux-x64
- @beyondidentity/ai-cli-linux-arm64
- @beyondidentity/ai-cli-win32-x64

If optionalDependencies` installation fails, a postinstall script will attempt to download the binary as a fallback.

License

UNLICENSED - For internal use only.