CLI Usage¶
The polymarket-agent CLI loads agent specifications and executes trading workflows.
Basic Usage¶
Flags¶
| Flag | Type | Default | Description |
|---|---|---|---|
--demo |
bool | false | Run demo fetching live Polymarket data |
--demo-limit |
int | 5 | Number of markets to fetch in demo mode |
Examples¶
Run Without Demo¶
Load and display agent specs without fetching live data:
Output:
level=INFO msg="loading agents" dir=agents/specs/agents
level=INFO msg="loaded agents" count=3
level=INFO msg=agent name=market-analyst model=sonnet tools="[WebSearch WebFetch Read Write]"
level=INFO msg=agent name=superforecaster model=sonnet tools="[WebSearch WebFetch Read]"
level=INFO msg=agent name=trader model=haiku tools="[Read Write]"
level=INFO msg="loading team" file=agents/specs/team.json
level=INFO msg="loaded team" name=polymarket-trading-team version=0.1.0 workflow_type=graph steps=3
level=INFO msg="loading deployment" file=agents/specs/deployment-go-server.json
level=INFO msg="loaded deployment" platform=go-server team=polymarket-trading-team
level=INFO msg="workflow steps"
level=INFO msg="step 1" name=discover agent=market-analyst depends_on=none
level=INFO msg="step 2" name=forecast agent=superforecaster depends_on=[discover]
level=INFO msg="step 3" name=execute agent=trader depends_on=[forecast]
level=INFO msg="ready to execute" note="omnillm integration pending"
Run Demo Mode¶
Fetch live market data from Polymarket:
Fetch More Markets¶
Build Binary¶
Exit Codes¶
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Error (check stderr for details) |
Configuration Files¶
The CLI loads configuration from these paths:
| File | Purpose |
|---|---|
agents/specs/agents/*.md |
Agent definitions |
agents/specs/team.json |
Team workflow |
agents/specs/deployment-go-server.json |
Deployment config |