athena-tui

Terminal UI for Athena Search — dump your browser bookmarks into your Athena brain from the command line.

Zero dependencies (Node >= 22 built-ins only). The wordmark, box menus, ❯ cursor, and spinner take after nxfu/binthere; bookmark extraction covers Chromium-family browsers and Firefox.

                                    ✦
                   █▀█ ▀█▀ █ █ █▀▀ █▄ █ █▀█  ▄▀▀ █▀▀ █▀█ █▀▄ ▄▀▀ █ █
                   █▄█  █  █▀█ █▀  █ ▀█ █▄█  █▄▄ █▀  █▄█ █▀▄ █   █▀█
                   ▀ ▀  ▀  ▀ ▀ ▀▀▀ ▀  ▀ ▀ ▀  ▀▀▀ ▀▀▀ ▀ ▀ ▀▀  ▀▀▀ ▀ ▀
              search your second brain · dump your bookmarks · ai answers
                                 server  not connected

                   ╭─ actions ─────────────────────────────────────╮
                   │ ❯ 1 Login with Telegram         not logged in │
                   │   2 Connect instance            not connected │
                   │   3 Join community              not joined    │
                   │   4 Scan bookmarks              not scanned   │
                   │   5 Dump bookmarks                            │
                   │   6 Status                                    │
                   │   7 Quit                                      │
                   ╰───────────────────────────────────────────────╯
                       ╭────────────────────────────────────────╮
                       │ ↑↓ move · ↵ select · 1-9 jump · q quit │
                       ╰────────────────────────────────────────╯

Requirements

• Node.js >= 22.5 (uses node:sqlite for Firefox bookmarks; anything

  = 22 works otherwise)

• An Athena Search instance URL (ask your GOD)
• A Telegram account linked to the instance

Install

The package is on npm, so you can grab it on any machine without cloning the repo — handy when the website and database live on a VPS but you run the TUI locally to collect your bookmarks:

npm install -g athena-tui
athena-tui

Prefer a longer name? athenasearch-tui is an alias package that installs the same CLI (athenasearch-tui and athena-tui commands both work):

npm install -g athenasearch-tui

Setup

First-time? Just press 1–5 in order — the menu is the whole app. Every step can be re-run anytime; q quits.

1. 1 Connect instance — paste your instance URL (https://athena.example.org) — or skip the prompt with ATHENA_INSTANCE env.
2. 2 Login with Telegram — your browser opens the site's login page; log in, then paste the address-bar URL (or the session= token) back into the terminal.
3. 3 Join community — paste the community id from your GOD (skip this if you only use your personal brain as GOD).
4. 4 Scan bookmarks — scans every browser profile found locally at once (Chrome/Chromium/Edge/Brave/Opera/Vivaldi/Arc/Firefox); if none are found it asks for an HTML/JSON export file.
5. 5 Dump bookmarks — GODs pick personal or community brain; others dump to their community. Server-side dedupe is handled (skips reported), folder paths become tags.

From the repo checkout (instead of npm):

cd tui
npm install       # no-op — zero deps, just links the `athena-tui` bin
npm start

Or run it directly: node tui/src/index.js

Features

• Athena purple theme, truecolor → 16-color → plain fallback (NO_COLOR, TERM=dumb)
• Wordmark intro animation and braille spinner (disable with ATHENA_TUI_NO_ANIMATION=1)
• Session + instance persisted at ~/.config/athena-tui/config.json
• Bookmarks detected from Chrome, Chromium, Edge, Brave, Opera, Vivaldi, Arc, and Firefox (places.sqlite via node:sqlite), including Flatpak/Snap sandboxes and the XDG profile dir (~/.config/mozilla/firefox)
• Portable/custom browser data dirs: ATHENA_BOOKMARK_ROOTS=/path/to/User\ Data (colon-separated) — scanned one level deep for Bookmarks/places.sqlite; athena-tui --diagnose shows every root it checks
• Non-HTTP(S) bookmarks are skipped; local duplicates collapse before upload

Env

| Variable | Purpose | | --- | --- | | ATHENA_INSTANCE | Skip the instance prompt | | ATHENA_TOKEN | Skip Telegram login (scripted use) | | ATHENA_TUI_NO_ANIMATION | Disable intro/spinner |

Test

npm test   # smoke tests (mock API + fixture bookmarks) then full TTY e2e

The e2e runs the real TUI in a pseudo-TTY (script) against a mock Athena API with a fake Chrome profile and asserts the full join → scan → dump → quit journey.