Working CLI-first copytrade terminal for Robinhood Chain.
Profit hunters → fresh RH markets → COPY decision → wallet mirrors → paper positions → native queue.

Install · Terminal · COPY Wallets · Flow Walls · Commands

COPY is a working local-first copytrade terminal built around Robinhood Chain market flow.

It continuously grows a Robinhood token universe, follows profitable-wallet context, evaluates every setup through COPY-native flow walls, explains every FIRE / SKIP, rotates COPY wallet mirrors, marks paper positions, and keeps the native execution queue visible from the same terminal.

The CLI is the main product. The browser layer is only an optional wrapper around the same data and queue stack.

npm start opens the terminal. npm run hunt runs the raw scrolling feed. npm run paper runs the local paper engine.

Node 20 or newer.

git clone https://github.com/YOUR_HANDLE/copy.git
cd copy
npm install
cp .env.example .env
npm run doctor

Or install it as a local command:

npm install -g .
copy doctor --probe

npm run doctor      # provider + Robinhood Chain health
npm start           # full-screen interactive terminal
npm run hunt        # raw scrolling decision feed
npm run paper       # local paper-copy loop
npm run showcase    # high-cadence terminal mode for demos / recording
npm run web         # optional browser wrapper + native queue UI

With the binary installed:

copy terminal
copy hunt --fire-only
copy trader ether_monk
copy scan CASHCAT
copy positions
copy rules
copy doctor --probe

copy terminal

The full-screen terminal keeps three things on screen at the same time:

1. the newest token / wallet / decision events,
2. the selected decision breakdown on the right,
3. the COPY wallet desk underneath.

Main event types:

Keys:

↑ / ↓    move through events
f        ALL → FIRE → SKIP
space    open selected FIRE as a PAPER copy
c        track / untrack selected source
p        pause / resume scanner
r        refresh providers now
q        quit

The top line carries the COPY wordmark with the running pixel COPYBARA. The right pane explains the selected token: source, score, walls, reason, market box, radar, native queue state, and recent desk activity.

More: docs/TERMINAL.md.

copy hunt
copy hunt --fire-only
copy hunt --for 300
copy hunt --json

hunt runs the same engine without the full-screen renderer. It is useful for a raw terminal wall, logging, piping JSON, or showing a Bodkin-style scrolling feed.

copy paper
copy paper --for 300

Paper mode watches fresh candidates, opens passing setups while slots and budget remain, re-marks positions, and closes them on the configured exits.

FIRE → PAPER OPEN → MARK → TP / SL / TRAIL / CLOCK → CLOSED

copy positions prints the current open and recently closed paper positions.

The lower desk keeps the profitable-wallet side of the product alive.

Each row shows the trader, current token pair, current PnL, delta since the last tick, and a tiny sparkline. The desk keeps rotating and re-marking so the screen stays active while the upper feed keeps discovering tokens.

SHADOW @ether_monk      → $CASHCAT   +4.18%  Δ+0.22  ▁▂▃▄▆█
SHADOW @threem          → $AI        -0.41%  Δ-0.13  ▆▅▄▃▂▁
PAPER  @DumbCrayonEater → $CASHCAT   +0.73%  Δ+0.09  ▁▁▂▄▅█

COPY WALLETS in the current build:

• rotates through a larger trader pool instead of a static list,
• changes token pairs continuously,
• updates PnL and delta frequently,
• keeps adding fresh markets into the desk as the session grows,
• mirrors the same symbols you see higher in the main event flow.

COPY score is context, not the permission switch. The default decision box is intentionally copytrade-native:

A token is either accepted or refused by the first wall that fails.

profit source
    ↓
wallet activity / market discovery
    ↓
EDGE → DEPTH → TURN → MOMO → PRICE
    ↓
FIRE / SKIP + reason
    ↓
SHADOW mirror / PAPER copy / native queue
    ↓
marks → PnL delta → exit rule

More: docs/STRATEGY.md.

These are the defaults the paper engine starts with. You can inspect them with copy rules and keep tuning the box from there.

The terminal starts fast, keeps the event stream moving, and does not collapse when a source responds with a smaller batch than usual.

Public mode can run with no secret:

• Fomo public leaderboard mirror,
• DEX market discovery / price / liquidity / volume,
• Robinhood Chain RPC health,
• last-known-good bootstrap.

Optional read credentials add richer wallet-level activity:

REPLYNODES_API_KEY=
# or
FOMO_BEARER_TOKEN=

There is no browser wallet connect in the product UX. The optional web wrapper exposes a native queue interface instead.

Every command and environment variable: docs/COMMANDS.md.

flowchart LR
    F["Fomo leaderboard / wallet activity"] --> N[normalize]
    D["DEX / RH market discovery"] --> N
    N --> H[profit hunters + market universe]
    H --> C[candidate]
    C --> E["EDGE · DEPTH · TURN · MOMO · PRICE"]
    E -->|fail| S["SKIP + exact reason"]
    E -->|pass| R[FIRE]
    R --> M[SHADOW mirror]
    R --> P[PAPER position]
    R --> Q[NATIVE queue]
    P --> K[market marks]
    K --> X["TP · SL · trailing · max hold"]
    X --> Z[closed paper position]
    S --> T[terminal / hunt]
    M --> T
    P --> T
    Q --> T

The runtime is one Node process. data/seed.json provides the bootstrap set, data/runtime.json stores local rules and positions, and the in-memory universe keeps growing as new tokens are found.

More: docs/ARCHITECTURE.md.

bin/copy.mjs                CLI entrypoint
src/cli/runtime.mjs         provider merge + endless event stream + marks
src/cli/render.mjs          full-screen terminal renderer
src/cli/terminal.mjs        keyboard input + timers
src/cli/rules.mjs           COPY flow walls + paper exposure checks
src/providers/              Fomo / DEX / Robinhood readers
src/services/               shared state + native queue services
public/                     optional browser wrapper
data/seed.json              bootstrap state
data/runtime.json           local CLI state (created at runtime)
contracts/CopyRegistry.sol  optional rules registry
assets/copy-banner.png      GitHub README banner
assets/copybara-avatar.png  GitHub avatar / profile image
assets/terminal.png         terminal capture

npm test

The test suite checks the bootstrap, COPY-native decision flow, growing market universe, rotating wallet pairs, moving mirror PnL, event stream, web queue plumbing, and terminal project files.

Does COPY already work?
Yes. terminal, hunt, paper, doctor, rules, positions, and the optional web wrapper all run in the current repository.

Why can a high-score token still be refused?
Because the score is context. Permission still depends on EDGE, DEPTH, TURN, MOMO, PRICE, exposure, and budget.

Can I keep it open on a stream or call?
Yes. The terminal is built to keep moving, adding tokens, updating markets, rotating COPY wallets, and keeping the right pane useful over time.

Can I wire execution later?
Yes. The native queue boundary is already in the project. See docs/SAFETY.md and docs/ARCHITECTURE.md.

Read docs/SAFETY.md before wiring an external executor. Keep signing material outside the browser and outside the repository.

MIT. See LICENSE.