Parium CLI Preview

This directory contains the isolated chaos-mode terminal client.

Scope

• browser-to-terminal handoff only
• chaos room / collaborative sessions only
• no scored browser assessments
• preview packaging only

Install for internal preview

npm install -g ./cli/parium

Install from npm

After publishing:

npm install -g @parium.ai/cli@latest

Primary commands:

parium open
parium status
parium doctor
parium version

open resolves a handoff token and attaches to the live terminal session. status resolves a handoff token without attaching. doctor checks the local terminal and server reachability. version prints CLI/runtime metadata.

While parium open is waiting in the lobby:

• both engineers can see join state directly in the terminal
• Engineer A can press S to start the shared room once Engineer B has joined
• live attach also surfaces partner connect/disconnect notices inline

Handoff token flow

Token sources are checked in this order:

1. positional argument
2. PARIUM_HANDOFF
3. clipboard (interactive terminals only, with confirmation)
4. stdin or interactive prompt

Accepted formats:

raw-token-string
parium://open?token=...
https://parium.ai/...?...token=...

Examples:

parium open parium://open?token=abc123
PARIUM_HANDOFF=parium://open?token=abc123 parium open
printf '%s\n' 'parium://open?token=abc123' | parium status --json

Run without installing

node cli/parium/bin/parium.js open

Server requirements

• The server must have CLI_HANDOFF_SECRET configured.
• https://parium.ai is the default base URL.
• Use --base-url only when targeting staging, local, or a custom deployment. The base URL is the source of truth for both:
  • POST /api/cli/handoff/resolve
  • websocket attach at /ws?session=...

That is intentional. It keeps the CLI aligned with the exact host/path the operator chose, which matters for staging, local reverse proxies, and future multi-host deployments.

Folder layout

• bin/ entrypoints
• package.json package metadata and parium bin declaration
• lib/api.js handoff resolution and connectivity checks
• lib/ui/ terminal presentation layer
• lib/terminalAttach.js websocket-to-stdin/stdout bridge
• lib/commands/ CLI command orchestration
• lib/util/ token, clipboard, JSON, and terminal helpers

The prototype intentionally lives outside the main app runtime so terminal-client concerns stay isolated.

Themes

• dark - Default dark theme with green accents (recommended)
• light - Light background theme for bright environments
• mono - Monochrome fallback for basic terminals

Switch themes via CLI flag or environment variable:

parium open --theme light

PARIUM_CLI_THEME=mono parium open

Note: parium and midnight are aliases for dark for backwards compatibility. The CLI will automatically fall back to mono when the local terminal looks too weak for the richer UI.

Environment

PARIUM_CLI_THEME=dark
PARIUM_CLI_FORCE_MONO=1
NO_COLOR=1
CLICOLOR_FORCE=1

PARIUM_HANDOFF is also supported, but for normal use the recommended flow is still:

parium open

then accept the clipboard token prompt.