moltbook-tui

A TUI client for Moltbook, the social network for AI Agents.

moltbook.mp4

Description

Browse Moltbook, the social network for AI agents, from your terminal. View posts, comments, leaderboards, community stats, and real-time updates.

Features at a glance:

• Vim-style keyboard navigation (j/k, Enter, Esc)
• Auto-refreshing feed with background updates
• Threaded comment views
• Agent leaderboards and statistics
• Mouse support
• Works without authentication (API key optional)

This TUI application is built using the Ratatui framework.

Installation

From GitHub Releases

You can download latest binary rom GitHub releases for your platform here.

Using Homebrew

brew install terminaltrove/tap/moltbook-tui

Using Cargo

cargo install moltbook-tui

Using eget

eget terminaltrove/moltbook-tui

Build from Source

Requirements: Rust 1.70 or later

git clone https://github.com/terminaltrove/moltbook-tui.git
cd moltbook-tui
cargo build --release
# binary: target/release/moltbook

Features

• Real-time Feed: Browse the latest new posts from AI agents with auto-refresh.
• Post Details: View full posts with threaded comments
• Agent Leaderboard: See the most active and top-scoring agents
• Submolts: Browse different communities (subreddits for AI)
• Statistics: View network-wide stats and metrics
• Settings: Configure API key and preferences
• Mouse Support: Click to navigate and scroll
• Theming: Moltbook-themed interface with teal and red accents

Demo Screenshots

Main Feed	Post Comments	Leaderboard
Submolts	Statistics	About

Usage

Launch the TUI:

moltbook

TUI Controls

Global

• q or Ctrl+C - Quit
• Esc - Go back / Cancel
• ? - Help

Feed View

• j / k or ↓ / ↑ - Navigate posts
• Enter - View post details
• l - View leaderboard
• s - View submolts
• t - View statistics
• r - Refresh feed
• , - Settings

Post Detail

• j / k or ↓ / ↑ - Scroll content
• Esc or Backspace - Back to feed

Leaderboard / Lists

• j / k or ↓ / ↑ - Navigate items
• Tab - Switch between tabs/views
• Esc or Backspace - Back to feed

Configuration

moltbook-tui works without configuration. Optionally, provide an API key for authenticated features.

API Key

Set via environment variable:

export MOLTBOOK_API_KEY="your_api_key_here"

Or config file (~/.moltbook-tui/config.toml):

api_key = "your_api_key_here"

Development

cargo run                    # Run in dev mode
cargo test                   # Run tests
cargo clippy                 # Lint
cargo fmt                    # Format

License

MIT

About Moltbook

Moltbook is a Reddit-like social network for AI agents. Agents can create posts, comment, vote, and participate in communities called "submolts". This TUI provides a terminal interface for browsing the network.

Disclaimer

This project is not affiliated with, endorsed by, or connected to Moltbook.

EOF