Terminal Dashboard

mucch features a beautiful terminal-based dashboard for monitoring your trading bot in real-time. This guide covers all dashboard components and how to use them effectively.

Overview

The dashboard is built using blessed and blessed-contrib, providing a full-featured terminal UI with live charts, real-time data, and AI signals.

Dashboard Layout

┌─────────────────────────────────────────────────────────────────────────┐
│                          mucch TRADING DASHBOARD                        │
│                      AI-Powered Perpetuals & Futures                    │
└─────────────────────────────────────────────────────────────────────────┘

┌─────────── BTC/USD Chart ───────────┐ ┌──── Account Info ────┐
│                                      │ │ Balance:  $10,000.00 │
│       📊 Live Price Chart            │ │ Equity:   $10,250.00 │
│          (Last 50 Candles)           │ │ PNL:      +$250.00   │
│                                      │ │ Margin:   $2,500.00  │
│                                      │ │ Free:     $7,750.00  │
└──────────────────────────────────────┘ └──────────────────────┘

┌─────────── ETH/USD Chart ───────────┐ ┌──── AI Signal ───────┐
│                                      │ │ Action:   BUY        │
│       📊 Live Price Chart            │ │ Asset:    BTC/USD    │
│          (Last 50 Candles)           │ │ Confidence: 85%      │
│                                      │ │ Entry:    $42,150    │
│                                      │ │ Stop:     $41,500    │
│                                      │ │ Target:   $43,800    │
│                                      │ │ Size:     $1,000     │
└──────────────────────────────────────┘ └──────────────────────┘

┌────────────────────── Log Console ──────────────────────────┐
│ [12:30:45] Bot started                                      │
│ [12:30:46] Connected to Hyperliquid                         │
│ [12:30:47] AI analysis in progress...                       │
│ [12:30:50] Signal: BUY BTC/USD @ $42,150 (85% confidence)   │
└─────────────────────────────────────────────────────────────┘

Press 'q' to quit | 'r' to refresh | 'a' to request new analysis

Dashboard Components

Price Charts

Two live price charts display BTC/USD and ETH/USD movements:

Real-time updates: Prices refresh every 30 seconds
Historical data: Shows last 50 data points
Color coding: Green for up, red for down
OHLC display: Current open, high, low, close values

Account Information

Your Hyperliquid account stats displayed in real-time:

Balance: Total account value
Equity: Balance + unrealized PNL
PNL: Profit/loss (green if positive, red if negative)
Margin Used: Currently allocated margin
Free Margin: Available for new positions

AI Signal Panel

The most recent AI trading signal with actionable details:

Action: BUY, SELL, or HOLD with color coding
Asset: Trading pair being analyzed
Confidence: AI's confidence level (0-100%)
Entry Price: Suggested entry point
Stop Loss: Risk management level
Take Profit: Target exit price
Position Size: Recommended position size

Log Console

Scrollable log output showing all bot activity:

Timestamped entries: All events marked with precise time
Color-coded: Errors in red, success in green, info in white
Auto-scroll: New logs appear at the bottom
Searchable: Use Ctrl+F to find specific events

Keyboard Controls

Navigate and control the dashboard using these keyboard shortcuts:

Key	Action
q	Quit the dashboard
r	Refresh all data
a	Request new AI analysis
↑ / ↓	Scroll log console up/down
Tab	Switch focus between components
Ctrl+C	Emergency stop (closes bot gracefully)

Chart Components

Each price chart includes multiple data visualization elements:

Line Chart

Displays the price movement over time:

X-axis: Time (last 50 data points)
Y-axis: Price in USD
Green line: Upward price movement
Red line: Downward price movement
Auto-scaling based on price range

Data Labels

Key metrics displayed above each chart:

Current: Latest price
24h Change: Percentage change (green/red)
High: 24-hour high
Low: 24-hour low
Volume: 24-hour trading volume

Running the Dashboard

Start the dashboard with a simple command:

$ npx mucch

Or if installed globally:

$ mucch

Background Operation

For production use, run mucch in the background using PM2:

$ npm install -g pm2

$ pm2 start "npx mucch" --name mucch-bot

$ pm2 logs mucch-bot

Note: When running in background mode, the dashboard UI won't be visible. Use pm2 logs to monitor bot activity.

Terminal Requirements

For the best dashboard experience, use a terminal that supports:

UTF-8 encoding

Required for special characters and box-drawing

256 colors

Needed for proper color rendering

Minimum 120x30 characters

For optimal layout rendering

Recommended terminals:

Windows: Windows Terminal, ConEmu, Cmder
macOS: iTerm2, Terminal.app, Warp
Linux: GNOME Terminal, Konsole, Alacritty

Customization

The dashboard appearance can be customized by modifying the source code:

# Edit dashboard configuration

$ nano node_modules/mucch/dist/dashboard.js

Common customizations:

Change chart colors and styles
Adjust refresh intervals
Modify layout dimensions
Add custom indicators or data points
Configure log verbosity levels

Performance Tips

Use a dedicated terminal window

Don't share the terminal with other processes

Maximize terminal window

Ensures all components are visible without clipping

Monitor resource usage

Dashboard uses ~50MB RAM, minimal CPU

Stable network connection

Required for real-time Hyperliquid data

Warning: Resizing the terminal window while the dashboard is running may cause display issues. If this happens, press 'r' to refresh or restart the dashboard.

AI Strategy API Reference