signaldeck-cli

Modern command-line toolkit for launching, monitoring, and trading autonomous agents on SignalDeck.

Install

Install globally with npm:

npm install -g signaldeck-cli

Install globally with pnpm:

pnpm add -g signaldeck-cli

Install globally with yarn:

yarn global add signaldeck-cli

Run without a global install:

npx signaldeck-cli --help

Confirm the CLI is ready:

signaldeck --version
signaldeck --help

What You Can Do

• create launch configs from the terminal
• validate configs before going live
• generate starter config templates
• launch brand-new agents
• inspect platform-wide market stats
• search and sort live agents
• read recent trades for any agent
• follow the live tape in watch mode
• buy and sell directly from the command line
• run diagnostics against your API target

Quick Start

Create a fresh config:

signaldeck init

Or generate a ready-made sample:

signaldeck config sample
signaldeck config sample --stdout

Validate before launch:

signaldeck config show
signaldeck config validate

Preview a launch without sending anything:

signaldeck launch --dry-run

Launch for real:

signaldeck launch

Command Guide

Platform overview:

signaldeck status
signaldeck status --json

Agent deep dive:

signaldeck status <agent-id>
signaldeck show <agent-id>

Market discovery:

signaldeck agents
signaldeck agents --sort volume
signaldeck agents --sort automation --limit 12
signaldeck agents --status graduated
signaldeck agents --query orbit
signaldeck list --query support

Recent fills:

signaldeck trades <agent-id>
signaldeck trades <agent-id> --limit 20
signaldeck fills <agent-id>

Market tape:

signaldeck feed
signaldeck feed --limit 20
signaldeck feed --agent <agent-id>
signaldeck tape --limit 6

Watch mode:

signaldeck watch
signaldeck watch <agent-id>
signaldeck watch --interval 3
signaldeck tail <agent-id>

Trading:

signaldeck buy <agent-id> 250
signaldeck sell <agent-id> 120
signaldeck buy <agent-id> 500 --trader "Alpha Desk"

Diagnostics:

signaldeck doctor
signaldeck doctor --json
signaldeck diag

Config File

Default config filename:

signaldeck.config.json

Example config:

{
  "name": "Atlas Relay",
  "symbol": "ATLAS",
  "description": "Runbook and incident routing agent for distributed teams.",
  "category": "operations",
  "website": "https://atlas-relay.example",
  "xUrl": "https://x.com/atlasrelay",
  "operator": "North Relay",
  "accent": "#118ab2",
  "tags": ["ops", "routing", "incidents"]
}

Use a custom config path:

signaldeck config validate --config ./configs/atlas.json
signaldeck launch --config ./configs/atlas.json

Target API

By default the CLI talks to:

http://localhost:4100

Point the CLI at another SignalDeck environment with an environment variable:

set SIGNALDECK_API=https://your-domain.example
signaldeck status

Or override the API per command:

signaldeck --api https://your-domain.example status
signaldeck --api https://your-domain.example doctor

Common Flows

Launch flow:

signaldeck init
signaldeck config validate
signaldeck launch

Market research flow:

signaldeck status
signaldeck agents --sort trending --limit 12
signaldeck status <agent-id>
signaldeck trades <agent-id>

Live operator flow:

signaldeck feed --limit 10
signaldeck watch
signaldeck buy <agent-id> 100
signaldeck sell <agent-id> 40

Help

Every command includes built-in help:

signaldeck help
signaldeck agents --help
signaldeck trades --help
signaldeck launch --help

Upgrade

Upgrade to the latest CLI version:

npm install -g signaldeck-cli@latest

With pnpm:

pnpm add -g signaldeck-cli@latest

Package

npm package page:

https://www.npmjs.com/package/signaldeck-cli