@zurb/ray-cli

Connect your AI tools to Ray — and drive Ray from the terminal.

Ray exposes an MCP server. Wiring a client to it by hand means minting an API key, finding the right config file, pasting a JSON/TOML snippet, and restarting. This does it in one command.

npx @zurb/ray-cli connect

That detects your installed AI tools, opens your browser to authorize (which mints an API key for you — nothing to copy or paste), writes each client's config, and stores your credential locally. Restart the client and Ray's tools are available.

Supported clients: Claude Code, Claude Desktop, Codex CLI.

Commands

| Command | What it does | | --- | --- | | connect | Detect clients → authorize in browser → write configs | | status | Show what's connected, with a live health check | | doctor | Diagnose connection problems and suggest fixes | | disconnect [client] | Remove Ray from client configs (--revoke also revokes the key) | | logout | Clear the stored credential (leaves client configs alone) | | keys list / keys revoke <id> | Manage your API keys | | tools | List the MCP tools Ray exposes | | call <tool> --args '<json>' | Invoke a tool directly and print the result | | search <query> | Shorthand for call search_memory | | projects | Shorthand for call list_projects |

tools, call, search, and projects let agents and shell scripts use Ray with no MCP client at all:

npx @zurb/ray-cli projects
npx @zurb/ray-cli call search_memory --args '{"query":"checkout drop-off"}'

Flags

• --url <origin> — point at a different Ray deployment (defaults to https://ray.helio.app)
• --clients <list> — skip the picker: claude-code,claude-desktop,codex
• --key <glare_…> — use an existing key instead of the browser flow (CI / headless)
• --scope <user|local> — Claude Code scope (default user)
• --json — machine-readable output (status, tools, keys list)
• -y, --yes — non-interactive

Where things are stored

Your credential lives in ~/.config/ray-cli/config.json (%APPDATA%\ray-cli\ on Windows), created with 0600 permissions. Client configs are backed up before any change, and disconnect removes the backup so no key is left on disk.

Keys are per-user and revocable anytime — from keys revoke, or in Ray under Settings → Account.

Requirements

Node.js 20+.

License

MIT © ZURB, Inc.