Economist TUI
Terminal app to browse and read The Economist.
Commands
bash
# Interactive browse (TUI, type to search, ←/→ page, b back, c columns) economist browse [section] # Run background daemon for faster reads economist serve economist serve --status economist serve --stop # Headlines (default section: leaders) economist headlines [section] [-n count] [-s search] [--json|--plain] # Read full article economist read [url|-] [--raw] [--wrap N] [--columns 1|2] # Login (one-time, opens browser) economist login # List sections economist sections
Available Sections
leaders, briefing, finance, us, britain, europe, middle-east, asia, china, americas, business, tech, science, culture, graphic, world-this-week
Global Flags
--version, --debug, --no-color
Examples
bash
# Get 5 finance headlines economist headlines finance -n 5 # Search for China coverage (fuzzy tokens) economist headlines finance -s "china" # JSON output economist headlines finance --json # Read article (markdown output) economist read "https://www.economist.com/..." --raw # Pretty terminal rendering economist read "https://www.economist.com/..." --wrap 100 # Two-column article body economist read "https://www.economist.com/..." --columns 2 # Debug HTML dump economist --debug read "https://www.economist.com/..." # Read URL from stdin echo "https://www.economist.com/..." | economist read -
Auth Flow
- •Run
economist login(opens browser) - •Log in to Economist account
- •Browser closes automatically when login detected
- •Cookies saved to
~/.config/economist-tui/
Agent Usage
bash
# Get headlines as JSON (for parsing) economist headlines finance --json # Get first headline URL economist headlines finance --json | jq -r '.[0].url' # Read first headline economist headlines finance --json | jq -r '.[0].url' | xargs economist read --raw # Plain output (title<TAB>url) economist headlines finance --plain
Note: browse requires a TTY and won't work in agent context. Use headlines --json instead.
Notes
- •Headlines via RSS: title, one-line description, date, URL (~300 items per section, ~10 months history)
- •Full articles require login (headless browser with saved session cookies)
- •Articles cached for 1 hour under
~/.config/economist-tui/cache - •Articles render as markdown with glamour formatting