An unofficial terminal user interface (TUI) client for Hardcover.app — Social discovery for serious book lovers. Browse your library, track your reading and manage your books without leaving the terminal.
Download pre-built binaries for Linux, macOS, and Windows from the Releases page.
paru -S hardcover-tui-bin
# or
yay -S hardcover-tui-bingo install github.com/NotMugil/hardcover-tui/cmd/hardcover-tui@latestgit clone https://github.com/NotMugil/hardcover-tui.git
cd hardcover-tui
go build -o hardcover-tui ./cmd/hardcover-tuiOn first launch, hardcover-tui will prompt you to enter your Hardcover API key.
- Obtain your API key from hardcover.app/account/api.
- Launch the app or manage authentication via CLI:
# Save API key to system keyring
hardcover-tui auth login -t <your_bearer_token>
# or
hardcover-tui auth login
# Check current authentication status
hardcover-tui auth status
# Remove API key from keyring
hardcover-tui auth logoutRun the TUI:
hardcover-tui| Key | Action |
|---|---|
1 |
Switch to Home (Library & Shelves) |
2 |
Switch to Search |
3 |
Switch to Lists |
4 |
Switch to Stats & Goals |
Tab / Shift+Tab |
Cycle through tabs |
j / k or ↓ / ↑ |
Move selection down / up |
Enter |
Open book details / confirm selection |
Esc |
Go back / close screen |
s |
Change reading status |
r |
Rate or review book |
p |
Log reading progress |
? |
Toggle help overlay |
Ctrl+Q |
Logout |
q / Ctrl+C |
Quit |
Contributions are welcome! Whether it is bug fixes, new features, UI improvements, or documentation — all help is appreciated.
Please read the Contributing Guide before getting started.
This is an independent, community-developed client and is not officially affiliated with, sponsored by, or endorsed by Hardcover. It connects to the Hardcover GraphQL API using your personal API key and acts on your behalf.
This project is licensed under the GNU Affero General Public License v3.0.