CORAL

Installation

Four commands
to a living reef

The first run needs nothing but Node and pnpm. No brokerage account, no API key, no card. CORAL starts in paper mode and stays there until you change one variable.

Node ≥ 22pnpm 10SQLite bundledWindows · macOS · Linux
01

Clone and install

pnpm workspace, Turborepo. Node 22 or newer, because the engine uses the built-in env loader and AbortSignal.timeout.

shell
git clone https://github.com/tobiazlincoln/CORALAGENT.git coral
cd coral
pnpm install
02

Spawn the reef

Writes .coral/reef.db and a .env template in the directory you ran it from. Nothing is created outside it.

shell
pnpm coral init
# reef spawned at .coral/reef.db
# generation 1 · 0 polyps
03

Take a pass, no key needed

Without a model key CORAL uses a deterministic heuristic reasoner. Same pipeline, same risk gate, same polyps. It is a real strategy, not a mock.

shell
pnpm coral trade NVDA,AAPL --budget 200

# observe · reading 2 symbol(s) from synthetic
# recall  · pulling polyps that match today's setup
# reason  · no model key, deterministic reasoning
# gate    · hard limits, non-negotiable
# fill buy NVDA $100.00 @ $182.44
04

Give it a model

Four providers. CORAL falls back to the heuristic if the call fails, so a dead key never stops the reef.

shell
# .env
CORAL_LLM=anthropic
CORAL_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-...

# or openai | google | xai

Wire it into your agent

coral connect --all writes every config on this machine and backs up each original first. Or let each host add it natively; the commands below are the ones their own docs give.

hosthow
Claude Codeclaude mcp add robinhood-trading --transport http https://agent.robinhood.com/mcp/trading
Codex CLIcodex mcp add robinhood-trading --url https://agent.robinhood.com/mcp/trading
CursorSettings → Cursor Settings → Tools & MCPs → Connect
Gemini CLIgemini mcp add robinhood-trading https://agent.robinhood.com/mcp/trading -t http -s user
Grok+ → Add connector → Custom → paste the MCP URL
CORAL as a server
# Claude Code
claude mcp add coral -- pnpm --filter @coral/cli exec tsx src/index.ts serve

# any host that takes a command
{ "command": "npx", "args": ["-y", "tsx", "packages/cli/src/index.ts", "serve"] }

# then, from the agent:
> coral_status    reef health
> coral_scan      decisions without orders
> coral_trade     gated pass (dry run unless confirm:true)
> coral_ask       route a natural-language request to a skill

The whole CLI

Eleven surfaces, no hidden modes.

coral initspawn a reef, write .env
coral connect --allregister the MCP in every detected agent host
coral statuspolyps, generation, limits, connectivity
coral status --skillswhat CORAL can do, and how strong each skill is right now
coral scan NVDAobserve, reason, gate, place nothing
coral trade NVDA --budget 200one full gated pass
coral evolveadvance a generation
coral historyledger and generation log
coral reef 'NVDA oversold'recall, with --why for the scoring breakdown
coral serverun CORAL as an MCP server on stdio
coral agentswhich hosts are detected on this machine

Before you go live

Live trading needs an Agentic account at Robinhood, a token for the hosted MCP, and two separate switches: CORAL_MODE=live in the environment, and limits.allowLive set in code. One of them alone places nothing. That is deliberate.

Read the safety model