farcaster-tui

A terminal-based Farcaster client. Read and write to the Farcaster network directly from your terminal using Hub HTTP APIs.

Features

• Browse your home feed (casts from accounts you follow)
• View user profiles and cast history
• Read threads and replies
• Search users by username or FID
• View notifications (mentions)
• Compose and publish casts
• Like, recast, reply, follow/unfollow
• Multiple signer support with encrypted key storage
• Configurable hub URL (default: hub.merv.fun)
• Vim-style navigation
• No data caching — always fresh from the hub

Install

npm (requires Bun)

bun install -g farcaster-tui
farcaster-tui

Or run without installing:

bunx farcaster-tui

AUR (Arch Linux)

yay -S farcaster-tui

From source

git clone https://github.com/backmeupplz/farcaster-tui.git
cd farcaster-tui
bun install
bun src/index.tsx

Keybindings

| Key | Action | |-----|--------| | j / k / arrows | Navigate up/down | | Enter | Open thread / select | | q / Esc | Go back / quit | | 1 | Feed | | 2 | Notifications | | 3 | Search | | 4 | Your profile | | n | New cast | | r | Reply to selected cast | | o | Open author's profile | | R | Refresh | | g / G | Jump to top/bottom | | s | Signer manager | | ? | Settings |

Setup

Reading (no signer needed)

Set your FID in settings (? key) to see your home feed. Without a FID, you'll see sample casts.

Writing (signer required)

To publish casts, like, recast, or follow, you need an Ed25519 signer key registered to your Farcaster account.

1. Press s to open the signer manager
2. Press i to import a signer
3. Paste your Ed25519 private key (hex)
4. Enter your FID
5. Set an encryption password

Your signer key is encrypted with AES-256-GCM and stored in ~/.config/farcaster-tui/signers.json.

How to get a signer key

Create a signer using Warpcast or any Farcaster client that supports signer management. The private key is a 64-character hex string (32 bytes Ed25519).

Configuration

Config is stored in ~/.config/farcaster-tui/config.json:

{
  "hubUrl": "https://hub.merv.fun",
  "fid": 12345
}

Hub URL

The default hub is https://hub.merv.fun. You can change it in settings or by editing the config file. Some public hubs:

• https://hub.merv.fun
• https://hub.pinata.cloud
• https://nemes.farcaster.xyz:2281

Development

git clone https://github.com/backmeupplz/farcaster-tui.git
cd farcaster-tui
bun install

Run in dev mode with hot reload (restarts on any file change):

bun dev

Run once without watch:

bun start

Type check:

bun run typecheck

Build a standalone binary:

bun run build
./farcaster-tui

Tech Stack

• Bun — runtime
• Ink — React for CLIs
• @farcaster/hub-nodejs — Farcaster message builders and signers
• Snapchain Hub HTTP API — data layer

License

MIT