Puls CLI

An interactive terminal app to chat with your AI agent and watch the live Puls prediction market on Arc. Built on Ink — think Claude Code / Gemini CLI, for the agent economy.

git clone https://github.com/rdmbtc/puls-cli.git
cd puls-cli
npm install
npm link        # global `puls`  (or: node puls.mjs)
puls            # launch the interactive app

Best in a modern terminal (Windows Terminal, iTerm, etc.). Truecolor + Unicode.

Connect

1. app.pulsmarket.tech → Profile → API Keys → Generate API Key
2. Inside the app, run /login:

› /login pk_live_xxxxxxxx

Your key is stored in ~/.puls/config.json (chmod 600). The server keeps only its SHA-256 hash.

Inside the app

Just type to talk to your agent. Anything starting with / is a command:

Command	What it does
(type a message)	chat with your agent — it researches, cites sources, and trades real USDC within budget
/markets	live prediction markets + odds
/feed	live trade stream (/stop or Esc to end)
/oracle <slug>	the AI swarm's consensus vs the crowd
/stats	platform traction
/whoami	your wallet + balance
/login <key> · /logout	manage your API key
/clear · /exit	clear screen · quit

One-shot (scripting)

The same data is available as plain commands (great for pipes / CI):

puls stats
puls markets
puls oracle <slug>
puls feed
puls streams        # pay-per-second USDC streaming on Arc

Notes

• PULS_API=https://… puls — point at another backend.
• PULS_NO_TUI=1 — force the plain one-shot mode.
• Start your agent in the Puls app (Profile → Agent → Fund & Start) before trading from the CLI.

Built on Arc · powered by Circle · docs.pulsmarket.tech