GitHub - falcga/tb: tb - bare minimum terminal browser with jina.ai api in mind · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
falcga
tb
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>9 Commits<br>9 Commits
README.md
README.md
install.ps1
install.ps1
install.sh
install.sh
tb.bat
tb.bat
tb.sh
tb.sh
View all files
Repository files navigation
Terminal Browser (tb) – Super‑fast terminal web browser
tb lets you view web pages and perform searches directly from your terminal using the Jina Reader API.
Works on Linux , macOS , Windows (CMD, PowerShell, WSL, Git Bash).
🚀 Instant text‑only version of any page
🔍 Search using s.jina.ai
🎨 Automatic pager (less / more)
🔐 Optional token authentication & context token
📦 One‑command installation
Installation
Linux / macOS / WSL / Git Bash
curl -sSL https://raw.githubusercontent.com/falcga/tb/main/install.sh | bash
Then restart your terminal or run source ~/.bashrc / source ~/.zshrc.
Windows (PowerShell as Administrator)
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/falcga/tb/main/install.ps1' -OutFile install.ps1; ./install.ps1"
Or manually: download tb.bat and place it in a folder that is in your %PATH%.
Usage
1. (Optional) Get an API token
You can use tb without a token – requests will be sent anonymously.
For higher rate limits or special features, get a free token from Jina AI Reader.
2. Set environment variables (optional)
export JINA_TOKEN="jina_your_token_here" # Linux/macOS<br>set JINA_TOKEN=jina_your_token_here # Windows CMD<br>$env:JINA_TOKEN="jina_your_token_here" # Windows PowerShell
For a context token (sent as X-Context header):
export JINA_CONTEXT_TOKEN="your_context"
3. Browse the web
Open a webpage:
tb https://example.com
Search the web:
tb "how to install python"
Options
Flag<br>Description
--token TOKEN<br>Jina API token (overrides JINA_TOKEN)
--context TOKEN<br>Context token (sent as X-Context header)
--raw<br>Output without pager (useful for piping to files)
--help, -h<br>Show help message
Examples
page.txt
# Anonymous usage (no token)<br>tb "latest tech news""># Open a page with a temporary token (overrides environment)<br>tb --token jina_xyz https://news.ycombinator.com
# Search with a context token<br>tb --context session_123 "bash best practices"
# Save output to a file (no pager)<br>tb --raw https://example.com > page.txt
# Anonymous usage (no token)<br>tb "latest tech news"
Environment Variables
Variable<br>Description<br>Required
JINA_TOKEN<br>API token for Jina Reader<br>No
JINA_CONTEXT_TOKEN<br>Context token (sent as X-Context)<br>No
If JINA_TOKEN is not set and no --token is provided, the Authorization header is omitted entirely.
Requirements
curl (pre‑installed on most systems, required)
less or more (for paging, optional – use --raw to bypass)
No other dependencies
Uninstallation
Linux/macOS : sudo rm /usr/local/bin/tb
Windows : Delete tb.bat from your %USERPROFILE%\bin (or wherever you placed it) and remove that folder from your PATH if desired.
Troubleshooting
Problem<br>Solution
curl: command not found<br>Install curl (e.g., apt install curl / brew install curl)
Error: Request failed<br>Check your internet connection. If you provided a token, ensure it is valid.
No output or strange characters<br>Try --raw mode or check if the URL/search query is correct.
License
MIT © 2025 falcga
Acknowledgements
This tool is an unofficial third‑party client for the public Jina Reader API.
It respects the API’s intended usage:
No web scraping or automated extraction from jina.ai
No reverse engineering or creation of competing services
API tokens are optional and passed exactly as documented (Authorization: Bearer header)
The required X-Engine: browser header is always sent
For heavy or automated usage, please obtain your own free token from Jina AI Reader and respect their rate limits.
See Jina AI Terms and Privacy Policy for details.
About
tb - bare minimum terminal browser with jina.ai api...