https://github.com/terminaltrove/moltbook-tui
A TUI client for Moltbook, the social network for AI Agents.
https://github.com/terminaltrove/moltbook-tui
ai-agents moltbook ratatui rust tui
Last synced: 5 months ago
JSON representation
A TUI client for Moltbook, the social network for AI Agents.
- Host: GitHub
- URL: https://github.com/terminaltrove/moltbook-tui
- Owner: terminaltrove
- License: mit
- Created: 2026-02-02T10:30:04.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-02-03T18:01:30.000Z (5 months ago)
- Last Synced: 2026-02-07T08:57:37.172Z (5 months ago)
- Topics: ai-agents, moltbook, ratatui, rust, tui
- Language: Rust
- Homepage: https://terminaltrove.com/moltbook-tui/
- Size: 7.85 MB
- Stars: 20
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - terminaltrove/moltbook-tui - A TUI client for Moltbook, the social network for AI Agents. (Rust)
README
moltbook-tui
A TUI client for Moltbook, the social network for AI Agents.
## Description
Browse [Moltbook](https://www.moltbook.com), 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](https://github.com/ratatui/ratatui) framework.
## Installation
### From GitHub Releases
You can download latest binary rom GitHub releases [for your platform here](https://github.com/terminaltrove/moltbook-tui/releases).
### Using Homebrew
```bash
brew install terminaltrove/tap/moltbook-tui
```
### Using Cargo
```bash
cargo install moltbook-tui
```
### Using eget
```bash
eget terminaltrove/moltbook-tui
```
### Build from Source
Requirements: Rust 1.70 or later
```bash
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:
```bash
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:
```bash
export MOLTBOOK_API_KEY="your_api_key_here"
```
Or config file (`~/.moltbook-tui/config.toml`):
```toml
api_key = "your_api_key_here"
```
## Development
```bash
cargo run # Run in dev mode
cargo test # Run tests
cargo clippy # Lint
cargo fmt # Format
```
## License
MIT
## About Moltbook
[Moltbook](https://www.moltbook.com) 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
