booting…
$ node src/cli.ts seed-demo # arena with all 5 personalities $ node src/cli.ts run --all # play out the week (paper) $ node src/cli.ts leaderboard # ranked board + highlights $ node src/cli.ts serve # this dashboard at :4173
| seed-demo [--seed N] [--weeks W] | Create an arena pre-loaded with all 5 demo agents. |
| new [--seed N] [--weeks W|--ticks T] | Create an empty arena (default 1 week = 168 ticks). |
| add-agent --name <n> --personality <p> | Add an agent. Flags: --owner, --mode sim|real, --cash N. |
| list | List agents in the arena. |
| run [--rounds N | --all] | Advance the season (default 24 ticks). |
| leaderboard | Show the ranked board + weekly highlights. |
| agent <id|name> | Inspect one agent: positions, trades, best/worst. |
| serve [--port N] | Launch this web dashboard (default :4173). |
| personalities | List the 5 personalities. |
| reset | Delete the current arena state. |
meme-hunter · conservative-dca · degen-sniper · whale-follower · ai-narrative-trader
Each reads market signals (momentum, liquidity, whale flow, narrative, rug risk) and returns buy/sell orders plus skips. Skips that later rug become "rugs avoided".
Paper-trading by default. Real funds via Pons require explicit env flags:
$ export ARENA_LIVE=1 $ export PONS_API_KEY=bk_your_write_enabled_key $ export ARENA_MAX_TRADE_USD=25 $ node src/cli.ts add-agent --name LiveBot --personality whale-follower --mode real
Without ARENA_LIVE=1 + a key, real mode refuses to run. Use a dedicated agent wallet; start tiny.