tui-image

Alpstein TUI — Trading insights in your terminal

Not everyone wants to leave their terminal. For developers and traders who live in the command line, Alpstein offers a fully-featured terminal user interface (TUI) that brings the same AI-powered insights directly to your shell.

Why a terminal interface?

Context switching kills productivity. If you're coding, debugging, or managing infrastructure, opening a browser tab breaks your flow. The TUI keeps you in your zone—same terminal, same keyboard shortcuts, zero friction.

It's also fast. No browser overhead, no rendering delays. Just raw data streaming to your screen in milliseconds.

Installation

Installing the TUI is as simple as any command-line tool. If you're on macOS or Linux with Homebrew:

brew install whiplashvin/whiplashvin/alpstein-tui

Once installed, launch it with a single command. You'll be prompted to enter your authentication key, which connects the TUI to your Alpstein account securely.

tui-image

What you get in the terminal

The TUI isn't a stripped-down version—it's the full Alpstein experience, optimized for keyboard-driven workflows:

  • Live market data — Real-time prices for BTC, ETH, XRP, and other major cryptocurrencies. Prices update instantly, with percentage changes color-coded (green for gains, red for losses).
  • News feed — Scraped articles from CoinTelegraph, The Block, and NewsBTC appear as soon as they're published. Each headline shows the source, timestamp, and a brief preview. Scroll through them with arrow keys.
  • Agent's opinion — The AI's current market analysis is front and center. You see the position recommendation (long, short, or unclear), entry price, take-profit and stop-loss levels, risk/reward ratio, and when the opinion was generated.
  • Live stats — If there's an active position, you see creation price, current status (triggered or pending), and live profit/loss percentage updating in real time.

Navigation & keyboard shortcuts

Everything is keyboard-driven. No mouse needed, no clicking around. The TUI supports intuitive shortcuts displayed at the bottom of the screen:

  • [n] — Jump to the next page
  • [p] — Jump to the prev page
  • [d] — Open documentation (in upcoming update)
  • [t] — View trades and position history (in upcoming update)
  • [↑] [↓] — Scroll through news items
  • [x] — Visit news source

The interface is responsive and clean. Built with Bubble Tea (Go's TUI framework) and styled with Lipgloss, it feels native to the terminal—smooth scrolling, clean layouts, and no visual clutter.

Authentication & security

On first launch, the TUI prompts you for an authentication key. This connects your terminal session to your Alpstein account using the same secure JWT-based authentication as the web interface.

Real-time updates, no polling

Just like the web dashboard, the TUI uses WebSocket connections to stream updates. When a new article is scraped, when prices change, or when the AI generates a fresh opinion, it appears instantly in your terminal—no refresh needed, no manual updates.

This makes it ideal for keeping Alpstein running in a tmux pane or a split terminal window while you work. Glance over, catch the latest market move, and get back to coding.

Built for traders who code

The TUI is designed for people who think in terminals—developers, sysadmins, quants, anyone who prefers keyboards over mice. It respects your workflow, stays out of your way, and delivers the same insights as the web interface without forcing you to leave the command line.

Whether you're deploying to production, debugging a trading bot, or just prefer the aesthetic of green text on black backgrounds, the TUI gives you Alpstein exactly where you need it.

Try it yourself

 brew install whiplashvin/whiplashvin/alpstein-tui
alpstein-tui

That's it. Two commands, and you're tracking crypto markets from your terminal.