Skip to content
BranchesTags

Repository files navigation

OpenClawd Dark Ralph TUI

Dark Ralph is the OpenClawd Bun + Ink terminal app for Solana market surveillance, wallet context, autonomous AI analysis, and holder operations. Product page: cheshireterminal.ai/dark-ralph.

Run it

# One-shot (no install)
npx -y @openclawdsolana/dark-ralph run

# Global install
npm i -g @openclawdsolana/dark-ralph
dark-ralph run
# also: ralph run | ralph-tui run

# Curl installer
curl -fsSL https://install.cheshireterminal.ai | bash
ralph

# Local development
bun install && bun run run

Requires Node.js 18+ for npm/npx. The TUI boots without every API key; missing providers show as disconnected and fail closed.

The default experience is the CLAWD Market View: a Bloomberg-style terminal surface with live tickers, a candlestick chart, order book, heatmap, top movers, network stats, activity, and agent controls.

┌──────────────────────────────────────────────────────────────────────────────┐
└─🦞 CLAWD │ MARKET VIEW────────────────────────────Uptime: 00:04:35 │ 8:36 AM─┘
┌──────────────────────────────────────────────────────────────────────────────┐
└─SOL $150.25 +2.34% │ BONK $0.00002345 +5.67% │ WIF $2.85 -1.20% │ JUP +3.80%┘

 ┌──────────────────────────────────────────────┐  ┌──────────────────────────┐
 │ SOL/USDC │ 1H              $132.97 (-11.36%)│  │ ORDER BOOK       SOL/USDC │
 │ 152.42 ▒██▒▒││││                           │  │ DEPTH    PRICE      SIZE  │
 │        ▒█▒█▒▒││ │   ·                      │  │ ██████  150.288   260.26 │
 │          │▒│ ▒█▒▒▒││ ││██▒▒·│              │  │ ██████  150.278   960.39 │
 │ VOL▁▃▄▄▃▂▂▃▃▃▁▃▃▄▃▂▃▂▄▂▃▃▃▂▂▃▂▂▄▃▁▂▂▃▁   │  │ ─── SPREAD: 0.0405 ───    │
 │ O: 134.42     H: 135.72     L: 131.50      │  │ ███     150.188   422.84 │
 └──────────────────────────────────────────────┘  └──────────────────────────┘

 ┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────────┐
 │ MARKET HEATMAP       │ │ TOP MOVERS           │ │ LIVE FEED          ● LIVE│
 │ ╭────╮ ╭────╮ ╭────╮ │ │ ▲ BONK +15.3%        │ │ 🐋 5,000 SOL to exchange│
 │ ╰+3.5╯ ╰+12╯ ╰+8.3╯ │ │ ▲ WIF  +12.5%        │ │ 📈 SOL crossed $150     │
 │ ╰-4.8╯ ╰-1.5╯ ╰-8.2╯│ │ ▼ MNGO -12.5%        │ │ ⚡ BONK divergence       │
 └──────────────────────┘ └──────────────────────┘ └──────────────────────────┘

┌──────────────────────────────────────────────────────────────────────────────┐
└─[1] MARKET │ [2] TRADING │ [3] PORTFOLIO │ [4] ANALYTICS │ [5] AGENT───────┘

Features

  • CLAWD market dashboard with ticker tape, SOL/USDC chart, order book, spread, volume bars, heatmap, top movers, live feed, network stats, and activity stream.
  • Five terminal views: Market, Trading, Portfolio, Analytics, and Agent.
  • Autonomous agent loop through RalphAgent, with configurable auto/interactive mode and recursive market thoughts.
  • Provider integrations for Helius, Birdeye, Phoenix perps through the Rise SDK, xAI Grok, Perplexity, OpenRouter, News API, SERP API, and Financial Datasets.
  • Solana wallet tools for local wallet creation, address display, balance lookup, and portfolio context.
  • Terminal-native controls with number-key navigation, refresh/help shortcuts, and an agent command surface.
  • OpenClawd / Cheshire backend links for cheshireterminal.ai, /vault, voice, vim-style command flow, trading routes, staking, mining, and agent API surfaces.

OpenClawd Mapping

Surface Route / API
Product page https://cheshireterminal.ai/dark-ralph
Site https://cheshireterminal.ai
Holder vault https://cheshireterminal.ai/vault
Chat, voice, and vim command surfaces https://cheshireterminal.ai/chat
Trading console https://cheshireterminal.ai/trading
Agent API https://agents.openclawd.biz
Local config module src/openclawd.ts

Quick Start

See Run it above for the four launch paths.

Optional local env setup:

cp .env.example .env
# edit keys, then:
bun run run
# or: npx -y @openclawdsolana/dark-ralph run

The curl installer detects macOS/Linux architecture, installs the command set into ~/.local/bin, and exposes Dark Ralph through the ralph launcher. Ensure ~/.local/bin is on your PATH if needed.

Commands

npx -y @openclawdsolana/dark-ralph run   # Start CLAWD TUI
ralph                                    # curl installer launcher
dark-ralph run                           # global npm bin
ralph run
ralph-tui run

Local development and package commands:

bun run run                         # Start CLAWD TUI
bun run src/cli.tsx run --auto      # Autonomous mode
bun run src/cli.tsx run --interactive
bun run src/cli.tsx run --wallet <address>
bun run src/cli.tsx run --headless  # Daemon mode

bun run status                      # API configuration status
bun run setup                       # Setup instructions
bun run wallet -- --create          # Create local wallet
bun run wallet -- --balance         # Show wallet balance
bun run wallet -- --address         # Show wallet address

Keyboard Shortcuts

Key Action
1 Market view
2 Trading view
3 Portfolio view
4 Analytics view
5 Agent view
Tab Cycle display mode
H Help
R Refresh
Q / Esc Quit

Agent Commands

Command Description
/help Show available commands
/analyze Run market analysis
/trending Show trending Solana tokens
/wallet Display wallet context
/news Fetch crypto news
/search <query> Search through Grok
/research <topic> Research through Perplexity
/perps List Phoenix perpetual futures markets
/perp <symbol> Inspect one Phoenix perpetual futures market
/prophecy Generate Dark Ralph predictions
/clear Clear agent messages

Configuration

Create .env from .env.example and add the keys you want to enable:

HELIUS_API_KEY=
HELIUS_RPC_URL=
BIRDEYE_API_KEY=
XAI_API_KEY=
PERPLEXITY_API_KEY=
OPENROUTER_API_KEY=
OPENROUTER_MODEL=minimax/minimax-m2.7
OPENCLAWD_SITE_URL=https://cheshireterminal.ai
OPENCLAWD_BACKEND_URL=https://cheshireterminal.ai
OPENCLAWD_AGENT_API_URL=https://agents.openclawd.biz
OPENCLAWD_VAULT_URL=https://cheshireterminal.ai/vault
OPENCLAWD_VOICE_URL=https://cheshireterminal.ai/chat
OPENCLAWD_VIM_URL=https://cheshireterminal.ai/chat
PHOENIX_API_URL=https://perp-api.phoenix.trade
PHOENIX_RPC_URL=https://api.mainnet-beta.solana.com
PHOENIX_WS_ENABLED=false
NEWS_API_KEY=
SERP_API_KEY=
FINANCIAL_DATASET_API_KEY=
Service Enables
Helius Solana RPC, DAS, balances, transactions
Birdeye Token prices, OHLCV, trending tokens, market data
Phoenix Perps Rise SDK exchange metadata, market stats, and perps commands
xAI Grok Search and market reasoning
Perplexity Research workflows
OpenRouter Model-backed reasoning
News API Crypto news feed
SERP API Search result enrichment
Financial Datasets Additional market and sentiment data

Project Layout

dark-ralph/
├── docs/
│   └── BIRDEYE_INTEGRATION.md
├── src/
│   ├── cli.tsx
│   ├── App.tsx
│   ├── components/
│   │   ├── BloombergDashboard.tsx
│   │   ├── PriceChart.tsx
│   │   ├── OrderBook.tsx
│   │   ├── Heatmap.tsx
│   │   ├── ActivityFeed.tsx
│   │   └── TradingPanel.tsx
│   ├── engine/
│   │   └── ralph-agent.ts
│   ├── services/
│   │   ├── birdeye.ts
│   │   ├── birdeye-api.ts
│   │   ├── birdeye-websocket.ts
│   │   ├── helius.ts
│   │   ├── phoenix-perps.ts
│   │   ├── ai-providers.ts
│   │   └── market-data-provider.ts
│   └── skills/
│       └── solana-wallet.ts
├── package.json
├── tsconfig.json
└── .env.example

Built With

  • Bun
  • Ink
  • React
  • @solana/web3.js
  • @ellipsis-labs/rise
  • Zod
  • Commander

License

MIT

About

Dark Ralph is the OpenClawd Bun + Ink terminal app for Solana market surveillance, wallet context, autonomous AI analysis, and holder operations. The default experience is the CLAWD Market View: a Bloomberg-style terminal surface with live tickers, a candlestick chart, order book, heatmap, top movers, network stats, activity, and agent controls.

cheshireterminal.ai/dark-ralph

Resources

Readme
MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages