ndl 0.1.0

A minimal TUI client for Threads
ndl-0.1.0 is not a library.

ndl - needle

A minimal TUI client for Threads - stay aware of notifications without the distractions of a full social media interface.

ndl screenshot

Why needle?

Social media notifications can pull you out of flow state. needle lets you:

  • Monitor your feed in a lightweight terminal interface
  • Quickly check and respond without opening a browser
  • Keep your focus while staying connected

Features

  • Vim-style navigation - h, j, k, l for intuitive movement
  • Two-panel layout - Threads list on left, detail view on right (swappable)
  • Thread feed - View your threads with auto-refresh every 15 seconds
  • Nested replies - See replies to threads, including replies-to-replies (2 levels deep)
  • Quick replies - Respond to threads without leaving the terminal
  • Media type indicators - Reposts, images, videos, and carousels clearly labeled
  • Minimal footprint - Runs in a terminal, no Electron bloat

Installation

From source

git clone https://github.com/pgray/ndl
cd ndl
cargo build --release

Configuration

needle requires a Threads API access token. See OAUTH.md for detailed setup instructions.

# Login interactively (opens browser for OAuth)
ndl login

# Logout
ndl logout

Config is stored at ~/.config/ndl/config.toml.

Usage

ndl

Keybindings

Key Action
j/Down Move down
k/Up Move up
h/Left Focus threads panel
l/Right Focus detail panel
t Swap panel positions
r Reply to selected thread
R Refresh feed
Enter Select / focus detail
Esc Back / cancel
? Toggle help
q Quit

Roadmap

  • OAuth login with auto-generated localhost certs
  • View threads feed
  • View thread details with nested replies
  • Reply to threads
  • Auto-refresh (15s)
  • Post new threads
  • Like/repost actions
  • Media preview (images)

License

MIT

References