OpenBlue CLI

Typed terminal CLI for managing iMessage / RCS / SMS lines for your AI agents.

npm install -g @openblue/cli
openblue login
openblue lines add

Install

npm install -g @openblue/cli
# or
bun add -g @openblue/cli
# or
pnpm add -g @openblue/cli

This installs two binaries: openblue and the shorter alias ob.

Commands

openblue login                 # device-flow auth, browser-approved
openblue whoami                # show the authenticated user
openblue logout

openblue projects ls           # list your projects
openblue projects create

openblue lines ls              # list lines for the active project
openblue lines add             # provision a new iMessage line
openblue lines rm <line-id>

openblue users ls              # registered users that can reach your lines
openblue users add

openblue platforms ls          # which platforms are enabled
openblue billing show
openblue env                   # which backend the CLI is talking to

Pass --debug on any command for full request/response logs. Pass --json to most list commands for scriptable output.

Quickstart

openblue login
openblue projects create --name "My Agent"
openblue lines add
openblue lines ls

Backend

Override the API host with --api-host <url> on any command, or with the PHOTON_API_HOST environment variable (legacy name, retained for backend compatibility).

Development

bun install
bun run dev           # bun --watch src/index.ts
bun test
bun run build         # bundles to dist/openblue.js
bun run check         # typecheck + test + build

License

MIT