{"id":46550950,"url":"https://github.com/backmeupplz/farcaster-tui","last_synced_at":"2026-03-07T03:14:14.089Z","repository":{"id":339674257,"uuid":"1162934195","full_name":"backmeupplz/farcaster-tui","owner":"backmeupplz","description":"A terminal-based Farcaster client","archived":false,"fork":false,"pushed_at":"2026-02-21T01:04:30.000Z","size":50,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-21T04:06:28.592Z","etag":null,"topics":["bun","cli","farcaster","terminal","tui","typescript"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/backmeupplz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-20T21:53:15.000Z","updated_at":"2026-02-21T01:04:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/backmeupplz/farcaster-tui","commit_stats":null,"previous_names":["backmeupplz/farcaster-tui"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/backmeupplz/farcaster-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backmeupplz%2Ffarcaster-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backmeupplz%2Ffarcaster-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backmeupplz%2Ffarcaster-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backmeupplz%2Ffarcaster-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/backmeupplz","download_url":"https://codeload.github.com/backmeupplz/farcaster-tui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/backmeupplz%2Ffarcaster-tui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30206356,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"online","status_checked_at":"2026-03-07T02:00:06.765Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bun","cli","farcaster","terminal","tui","typescript"],"created_at":"2026-03-07T03:14:13.635Z","updated_at":"2026-03-07T03:14:14.077Z","avatar_url":"https://github.com/backmeupplz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# farcaster-tui\n\nA terminal-based Farcaster client. Read and write to the Farcaster network directly from your terminal using Hub HTTP APIs.\n\n## Features\n\n- Browse your home feed (casts from accounts you follow)\n- View user profiles and cast history\n- Read threads and replies\n- Search users by username or FID\n- View notifications (mentions)\n- Compose and publish casts\n- Like, recast, reply, follow/unfollow\n- Multiple signer support with encrypted key storage\n- Configurable hub URL (default: hub.merv.fun)\n- Vim-style navigation\n- No data caching — always fresh from the hub\n\n## Install\n\n### npm (requires [Bun](https://bun.sh))\n\n```bash\nbun install -g farcaster-tui\nfarcaster-tui\n```\n\nOr run without installing:\n\n```bash\nbunx farcaster-tui\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S farcaster-tui\n```\n\n### From source\n\n```bash\ngit clone https://github.com/backmeupplz/farcaster-tui.git\ncd farcaster-tui\nbun install\nbun src/index.tsx\n```\n\n## Keybindings\n\n| Key | Action |\n|-----|--------|\n| `j` / `k` / arrows | Navigate up/down |\n| `Enter` | Open thread / select |\n| `q` / `Esc` | Go back / quit |\n| `1` | Feed |\n| `2` | Notifications |\n| `3` | Search |\n| `4` | Your profile |\n| `n` | New cast |\n| `r` | Reply to selected cast |\n| `o` | Open author's profile |\n| `R` | Refresh |\n| `g` / `G` | Jump to top/bottom |\n| `s` | Signer manager |\n| `?` | Settings |\n\n## Setup\n\n### Reading (no signer needed)\n\nSet your FID in settings (`?` key) to see your home feed. Without a FID, you'll see sample casts.\n\n### Writing (signer required)\n\nTo publish casts, like, recast, or follow, you need an Ed25519 signer key registered to your Farcaster account.\n\n1. Press `s` to open the signer manager\n2. Press `i` to import a signer\n3. Paste your Ed25519 private key (hex)\n4. Enter your FID\n5. Set an encryption password\n\nYour signer key is encrypted with AES-256-GCM and stored in `~/.config/farcaster-tui/signers.json`.\n\n### How to get a signer key\n\nCreate a signer using [Warpcast](https://warpcast.com) or any Farcaster client that supports signer management. The private key is a 64-character hex string (32 bytes Ed25519).\n\n## Configuration\n\nConfig is stored in `~/.config/farcaster-tui/config.json`:\n\n```json\n{\n  \"hubUrl\": \"https://hub.merv.fun\",\n  \"fid\": 12345\n}\n```\n\n### Hub URL\n\nThe default hub is `https://hub.merv.fun`. You can change it in settings or by editing the config file. Some public hubs:\n\n- `https://hub.merv.fun`\n- `https://hub.pinata.cloud`\n- `https://nemes.farcaster.xyz:2281`\n\n## Development\n\n```bash\ngit clone https://github.com/backmeupplz/farcaster-tui.git\ncd farcaster-tui\nbun install\n```\n\nRun in dev mode with hot reload (restarts on any file change):\n\n```bash\nbun dev\n```\n\nRun once without watch:\n\n```bash\nbun start\n```\n\nType check:\n\n```bash\nbun run typecheck\n```\n\nBuild a standalone binary:\n\n```bash\nbun run build\n./farcaster-tui\n```\n\n## Tech Stack\n\n- [Bun](https://bun.sh) — runtime\n- [Ink](https://github.com/vadimdemedes/ink) — React for CLIs\n- [@farcaster/hub-nodejs](https://github.com/farcasterxyz/hub-monorepo) — Farcaster message builders and signers\n- [Snapchain Hub HTTP API](https://snapchain.farcaster.xyz/) — data layer\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackmeupplz%2Ffarcaster-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbackmeupplz%2Ffarcaster-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbackmeupplz%2Ffarcaster-tui/lists"}