Panorama Gateway

Gateway service for connecting a team to CLI capabilities on this machine.

Usage

Pair the gateway with a team using a pairing code:

PANORAMA_ENV=dev pnpm --filter @panorama-ai/gateway dev -- pair <PAIRING_CODE>

Or pass Supabase credentials directly:

SUPABASE_URL="https://your-project.supabase.co" \
SUPABASE_ANON_KEY="your-anon-key" \
pnpm --filter @panorama-ai/gateway dev -- pair <PAIRING_CODE>

Start the gateway and begin listening for jobs (foreground in dev, background for built CLI):

pnpm --filter @panorama-ai/gateway dev -- start

Force the gateway into the background (built binary only):

pnpm --filter @panorama-ai/gateway build
pnpm --filter @panorama-ai/gateway start -- --daemon

Run in the foreground (built binary):

pnpm --filter @panorama-ai/gateway start -- --foreground

Stop the gateway:

pnpm --filter @panorama-ai/gateway dev -- stop

Check gateway status:

pnpm --filter @panorama-ai/gateway dev -- status

Tail logs:

pnpm --filter @panorama-ai/gateway dev -- logs --lines 200

Optional flags:

• --device-name "My MacBook"
• --verbose, -v (show technical details like paths, IDs, and PIDs)
• --supabase-url "https://..."
• --anon-key "..."
• --env local|dev|test|stage|prod
• --env-file /path/to/.env
• --foreground (run in the foreground)
• --daemon (force background for built CLI)
• --config-dir /path/to/dir
• --config-path /path/to/gateway.json
• --log-path /path/to/gateway.log
• --pid-path /path/to/gateway.pid
• --claude-cli /path/to/claude
• --codex-cli /path/to/codex
• --gemini-cli /path/to/gemini
• --claude-home /path/to/claude-home
• --no-follow (show logs without follow)

The gateway stores credentials in ~/.panorama/gateway/gateway.json by default. Override with --config-path or PANORAMA_GATEWAY_CONFIG_PATH.

Environment

The gateway expects these values (CLI flags override environment variables):

• SUPABASE_URL (or PANORAMA_SUPABASE_URL)
• SUPABASE_ANON_KEY (or PANORAMA_SUPABASE_ANON_KEY / SUPABASE_PUBLISHABLE_KEY)

When --env or PANORAMA_ENV is provided, the gateway loads .env.<env> from the repo root (falls back to .env for local). You can always point to a specific env file with --env-file.

Job Handling

The initial implementation processes diagnostic jobs by running claude --version on this machine and storing the output in the job result.

CLI Provider Notes

See packages/gateway/CLI_PROVIDERS.md for current findings on Claude Code, Codex CLI, and Gemini CLI usage patterns.