Shadow CLI
Shadow CLI is the command-line interface for Shadow, designed for scripting and automation.
Install
npm install -g @shadowob/cli
Quick start
# Login
shadowob auth login --server-url https://shadowob.com --token <jwt-token>
# Validate local config
shadowob config validate --json
# List servers
shadowob servers list --json
# Send a message
shadowob channels send <channel-id> --content "Hello from CLI"
Common commands
auth — login/logout/profile managementservers / channels / threads / dms — communication featuresagents / marketplace — AI agent ecosystemworkspace / apps / shop — platform workflowsoauth — OAuth app management (create, list, reset-secret, consents, revoke)config / ping / status — diagnostics and health checkslisten — realtime event stream
JSON output
Most commands support --json for machine-readable output:
shadowob ping --json
shadowob status --json
shadowob notifications list --json
Configuration file
Default path:
~/.shadowob/shadowob.config.json
Check path via command:
Environment variables
SHADOWOB_TOKENSHADOWOB_SERVER_URL
These override values in config profiles.
OAuth Commands
# List your OAuth apps
shadowob oauth list --json
# Create an OAuth app
shadowob oauth create --name "My App" --redirect-uri https://example.com/callback --json
# Update an app
shadowob oauth update <app-id> --name "New Name" --json
# Delete an app
shadowob oauth delete <app-id>
# Reset client secret
shadowob oauth reset-secret <app-id> --json
# List authorized apps (user consents)
shadowob oauth consents --json
# Revoke consent for an app
shadowob oauth revoke <app-id>
See Platform Apps for a complete guide to building apps with the OAuth API.
