glance-cli 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -5,9 +5,29 @@ All notable changes to glance-cli will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.15.0] - 2026-01-06
+## [0.16.0] - 2026-01-06
+
+### 🌐 Added: Enhanced Browse Mode
+- **Interactive Link Navigation**: Browse websites interactively with automatic summarization
+- **Enhanced Commands**: Navigate with options like `3 --tldr`, `5 --read -l fr`, `1 --eli5 -m gemini`
+- **Automatic Summaries**: Every navigation shows a TLDR summary by default (like normal glance)
+- **File Output Support**: Save summaries with `3 --output file.md --format markdown` or `3 --output data.json --format json`
+- **Smart UX Design**: 
+  - Last command and results show at bottom before prompt (no scrolling needed)
+  - Clear screen refresh on each iteration for clean interface
+  - Simple separator design with consistent formatting
+- **Seamless Navigation**: Browse mode continues after enhanced commands without exit bugs
+- **Command Categories**:
+  - Navigation: `1-24` (navigate to link), `n` (nav links), `e` (external), `a` (all)
+  - Utility: `b` (back), `h` (history), `q` (quit)
+  - Enhanced: All glance options work with link numbers
 
-### 🚀 Added: Comprehensive Local Model Support
+### 🐛 Fixed
+- **Browse Mode Exit Bug**: Fixed spinners interfering with readline interface using `discardStdin: false`
+- **File Output Confirmation**: Now shows `✅ Content saved to filename` instead of generic "completed"
+- **Regular Navigation Summary**: Fixed missing summaries when just typing link numbers
+
+### 🚀 Enhanced from v0.15.0: Comprehensive Local Model Support
 - **Fixed gpt-oss model compatibility**: Added special handling for gpt-oss models that use "thinking" field in responses
 - **Tested and verified 7 Ollama models**:
   - ✅ llama3:latest - Fast, reliable general-purpose model
@@ -19,15 +39,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **100% test success rate**: All models work with --tldr, --key-points, and --eli5 modes
 - **Improved response parsing**: Better extraction of meaningful content from various model response formats
 
-### 🐛 Fixed
-- **gpt-oss models now properly route to Ollama**: Previously failing gpt-oss models now correctly use local Ollama endpoint
-- **Response extraction for thinking-based models**: Models that output reasoning in "thinking" field now have their responses properly extracted
-- **Consistent model detection**: Enhanced provider detection to correctly identify local vs cloud models
-
 ### 📝 Documentation
-- Added comprehensive list of tested and supported local models in README
-- Included model-specific notes for optimal usage
-- Updated examples with various model options
+- Added comprehensive browse mode usage examples
+- Updated README with interactive navigation features
+- Included enhanced command syntax and options
 
 ## [0.14.0] - 2026-01-06
 

package/README.md

@@ -2,205 +2,156 @@
 
 **AI-powered web reader for your terminal** – Fetch any webpage, extract clean content, get instant AI summaries, and listen with natural voice synthesis.
 
-- **100% FREE by default** – Uses local Ollama (no API keys needed!)
-- **Auto language detection** – Detects English, French, Spanish, Haitian Creole
-- **No tracking** – Your browsing history stays private
-- **Voice-enabled** – Read articles aloud with multilingual support
-- **File output** – Save summaries as markdown, JSON, or plain text
-- **Lightning fast** – Built with Bun and TypeScript
-
-Turn any webpage into terminal-friendly insights with AI summaries or full content, read it, listen to it, or export it.
-
 [![npm version](https://badge.fury.io/js/glance-cli.svg)](https://www.npmjs.com/package/glance-cli)
 [![Downloads](https://img.shields.io/npm/dm/glance-cli.svg)](https://www.npmjs.com/package/glance-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
-## ⚡ Quick Start
+## Why glance-cli?
+
+- ✅ **100% FREE** – Uses local Ollama (no API keys needed)
+- 🌍 **Auto language detection** – English, French, Spanish, Haitian Creole
+- 🔒 **Privacy first** – Your browsing history stays local
+- 🎤 **Voice-enabled** – Read articles aloud with multilingual support
+- 💾 **Multiple formats** – Save as markdown, JSON, or plain text
+- ⚡ **Lightning fast** – Built with Bun and TypeScript
 
+---
+
+## Quick Start
 ```bash
 # Install
-bun install -g glance-cli  # Or: npm install -g glance-cli
+npm install -g glance-cli
 
 # Use immediately
-glance https://www.ayiti.ai                     # AI summary
-glance https://www.ayiti.ai/fr --read           # Auto-detects French + voice  
-glance https://news.com --output summary.md     # Save as markdown
-glance https://news.com --copy                  # Copy to clipboard
+glance https://news.com                    # Get AI summary
+glance https://news.com --read             # Read aloud
+glance https://news.com --browse           # Interactive navigation
 ```
 
 **For 100% free local AI:**
 ```bash
-# One-time setup (~4GB)
 curl -fsSL https://ollama.com/install.sh | sh
 ollama pull llama3
-
-# Now completely free forever
 glance https://techcrunch.com --tldr --read
 ```
 
 ---
 
-## 🎯 Core Features
+## Core Features
 
-### 📝 **Content Modes**
+### 🌐 Interactive Browse Mode
+Navigate websites interactively with AI summaries on demand.
 ```bash
-glance <url>                  # AI summary (default)
-glance <url> --tldr           # One sentence
-glance <url> --key-points     # Bullet points
-glance <url> --eli5           # Simple explanation
-glance <url> --full           # Full content (no summary)
-glance <url> --ask "..."      # Ask specific question
-glance <url> --copy           # Copy summary to clipboard
+glance https://news.ycombinator.com --browse
+
+# Inside browse mode:
+1                    # Navigate to link 1
+3 --tldr            # Navigate + get summary
+5 --read            # Navigate + read aloud
+1 --output file.md  # Navigate + save to file
+n                   # Show navigation links
+e                   # Show external links
+b                   # Go back
+q                   # Quit
 ```
 
-### 🎤 **Voice & Audio**
+### 📝 Read & Summarize
+Extract content with AI summaries in multiple styles.
 ```bash
-glance <url> --read                           # Read aloud
-glance <url> --audio-output article.mp3       # Save as MP3
-glance <url> --voice nova --read              # Choose voice
-glance <url> -l fr --voice antoine --read     # French voice
-
-glance --list-voices                          # See all voices
+glance <url>              # AI summary (default)
+glance <url> --tldr       # One sentence
+glance <url> --key-points # Bullet points
+glance <url> --eli5       # Simple explanation
+glance <url> --full       # Full content (no summary)
+glance <url> --copy       # Copy to clipboard
 ```
 
-**Voice Options:**
-- **Free**: System TTS (macOS Say, Windows SAPI, Linux espeak)
-- **Premium**: ElevenLabs (natural voices, requires `ELEVENLABS_API_KEY`)
-
-### 🌍 **Multi-Language Support**
+### 🎤 Voice & Audio
+Listen to articles with natural voice synthesis.
 ```bash
-glance https://lemonde.fr --tldr              # Auto-detects French from URL
-glance https://www.ayiti.ai/fr --read         # Auto-detects French + voice
-glance <url> --full -l es --voice isabella --read   # Override to Spanish + voice
+glance <url> --read                    # Read aloud (auto-detects language)
+glance <url> --audio-output audio.mp3  # Save as MP3
+glance <url> --voice nova --read       # Choose specific voice
+glance <url> -l fr --read              # French voice
 
-# Auto-detection: Detects language from URL patterns and content
-# Supported: en, fr, es, ht (Haitian Creole)
-# Override: Use --language flag to force specific language
+glance --list-voices                   # See available voices
 ```
 
-### 🤖 **AI Models**
+**Voice Options:**
+- **Free**: System TTS (macOS/Windows/Linux)
+- **Premium**: ElevenLabs (natural voices, requires API key)
 
-#### Tested & Supported Local Models (via Ollama)
-- ✅ **llama3:latest** - Fast, reliable, great for general use
-- ✅ **gemma3:4b** - Lightweight, efficient for quick summaries  
-- ✅ **mistral:7b** / **mistral:latest** - Excellent quality responses
-- ✅ **gpt-oss:20b** - Advanced local model with reasoning capabilities
-- ✅ **gpt-oss:120b-cloud** - Largest model for complex tasks
-- ✅ **deepseek-r1:latest** - Strong reasoning and analysis
+### 💾 Save & Export
+Save content in multiple formats.
+```bash
+glance <url> --output summary.md       # Save as markdown
+glance <url> --output data.json        # Save as JSON
+glance <url> --format plain -o file    # Save as plain text
+```
 
+### 🌍 Auto Language Detection
+Automatically detects and adapts to content language.
 ```bash
-# Free local AI (recommended)
-glance <url> --model llama3:latest
-glance <url> --model gemma3:4b
-glance <url> --model mistral:7b
-glance <url> --model gpt-oss:20b
-
-# Premium cloud AI (optional, requires API keys)
-glance <url> --model gpt-4o-mini              # OpenAI
-glance <url> --model gemini-2.0-flash-exp     # Google Gemini
-
-# Model management
-glance --list-models          # Show available local models
-glance --check-services       # Show AI/voice service status
-glance <url> --free-only      # Never use paid APIs
+glance https://lemonde.fr --tldr       # Auto-detects French
+glance https://news.es --read          # Auto-detects Spanish + voice
+glance <url> -l es --read              # Override to Spanish
 ```
 
----
+Supported: English, French, Spanish, Haitian Creole
 
-## 📖 Common Use Cases
+---
 
+## Common Use Cases
 ```bash
 # Morning news with audio
 glance https://news.ycombinator.com --tldr --read
 
 # Quick copy for sharing
-glance https://techcrunch.com/article --tldr --copy
+glance https://article.com --tldr --copy
 
-# Documentation lookup
-glance https://nextjs.org/docs --ask "What's the App Router?"
+# Interactive research
+glance https://en.wikipedia.org/wiki/AI --browse
 
 # Study while coding
 glance https://tutorial.com --full --read
 
-# Auto language detection  
-glance https://www.ayiti.ai/fr --tldr              # Automatically detects French
+# Save documentation
+glance https://docs.python.org --output guide.md
 
-# Multilingual learning
-glance https://lemonde.fr --full -l en --read      # French → English + voice
-
-# Save in different formats
-glance https://news.com --output summary.md        # Markdown format
-glance https://api-docs.com --output data.json     # JSON format
-glance https://article.com --format plain --output content.txt  # Plain text
-
-# Batch processing
-for url in $(cat urls.txt); do
-  glance "$url" --tldr --output "$(basename $url).md"
-done
+# Multilingual content
+glance https://lemonde.fr --read        # Auto-detects French voice
 ```
 
 ---
 
-## 📚 All Options
+## AI Models
 
-### **Content**
-```bash
---tldr                        # One sentence summary
---key-points, -k              # Bullet points
---eli5                        # Simple explanation
---full                        # Full content (no summary)
---ask "question"              # Custom Q&A
-```
+**Local (Free)** – via Ollama:
+- `llama3:latest` – Fast, reliable (recommended)
+- `gemma3:4b` – Lightweight, efficient
+- `mistral:7b` – Excellent quality
+- `deepseek-r1:latest` – Strong reasoning
 
-### **Voice & Audio**
+**Cloud (Optional)** – requires API keys:
+- `gpt-4o-mini` – OpenAI
+- `gemini-2.0-flash-exp` – Google Gemini
 ```bash
---read, -r                    # Read aloud
---audio-output <file>         # Save as MP3
---voice <name>                # Choose voice (nova, onyx, antoine, isabella)
---list-voices                 # Show available voices
--l, --language <code>         # Output language (en, fr, es, ht)
-```
-
-### **AI Models**
-```bash
---model <name>                # AI model (llama3, gpt-4o-mini, gemini-2.0-flash-exp)
---list-models                 # Show local models
---check-services              # Show service status
---free-only                   # Never use paid APIs
---prefer-quality              # Use premium if available
-```
-
-### **Output & File Saving**
-```bash
---format <type>               # Output format: md, json, plain (default: terminal)
---output, -o <file>           # Save to file (auto-detects format from extension)
---copy, -c                    # Copy summary to clipboard
---stream                      # Live streaming output
-```
-
-### **Advanced**
-```bash
---screenshot <file>           # Capture screenshot
---full-render                 # Render JavaScript (for SPAs)
---metadata                    # Show page metadata
---links                       # Extract all links
--v, --verbose                 # Detailed logs
--h, --help                    # Show help
--V, --version                 # Show version
+glance <url> --model llama3            # Use specific model
+glance --list-models                   # Show available models
+glance <url> --free-only               # Never use paid APIs
 ```
 
 ---
 
-## 🔧 Configuration
-
+## Configuration
 ```bash
 # AI Providers (optional)
 export OPENAI_API_KEY=...
 export GEMINI_API_KEY=...
 
-# Voice (optional, for premium)
+# Voice (optional, for premium voices)
 export ELEVENLABS_API_KEY=...
 
 # Ollama (optional, auto-detected)
@@ -209,66 +160,65 @@ export OLLAMA_ENDPOINT=http://localhost:11434
 
 ---
 
-## 🎓 Pro Tips
-
+## All Options
 ```bash
-# 1. Auto language detection + file saving
-glance https://lemonde.fr --output french-article.md   # Auto-detects French format
-
-# 2. Quick sharing workflow
-glance https://article.com --tldr --copy              # Copy summary for instant sharing
-
-# 2. Format override for different use cases  
-glance https://news.com --format json --output backup.md  # JSON content in .md file
-
-# 3. Use local AI
-glance https://www.ayiti.ai --model llama3 --free-only
-
-# 4. Match voice to auto-detected language
-glance https://www.ayiti.ai/fr --voice antoine --read    # French detection + voice
-
-# 5. Streaming for long content
-glance https://long-article.com --stream
+# Content
+--browse                 # Interactive navigation
+--tldr                   # One sentence summary
+--key-points, -k         # Bullet points
+--eli5                   # Simple explanation
+--full                   # Full content
+--ask "question"         # Custom Q&A
+
+# Voice & Audio
+--read, -r               # Read aloud
+--audio-output <file>    # Save as MP3
+--voice <name>           # Choose voice
+--list-voices            # Show available voices
+-l, --language <code>    # Output language (en, fr, es, ht)
+
+# AI Models
+--model <name>           # Choose AI model
+--list-models            # Show local models
+--free-only              # Never use paid APIs
+
+# Output
+--format <type>          # Format: md, json, plain
+--output, -o <file>      # Save to file
+--copy, -c               # Copy to clipboard
+--stream                 # Live streaming output
+
+# Advanced
+--screenshot <file>      # Capture screenshot
+--full-render            # Render JavaScript
+--metadata               # Show page metadata
+--links                  # Extract all links
+-v, --verbose            # Detailed logs
 ```
 
 ---
 
-## 🚀 Performance
-
-- **Fast**: ~5 seconds with local AI (Ollama)
-- **Efficient**: Cheerio-based content extraction
-- **Lightweight**: ~8MB bundle size
-
----
-
-## 🤝 Contributing
+## Contributing
 
 Contributions welcome! Check out our [Contributing Guide](CONTRIBUTING.md).
-
 ```bash
 git clone https://github.com/jkenley/glance-cli.git
 cd glance-cli
 bun install
-bun dev https://www.ayiti.ai
+bun dev https://example.com
 ```
 
 ---
 
-## ☕ Support
+## Support
 
-I built this in my spare time because I wanted a better way to read web content from my terminal. If you find it useful and want to support continued development, you can [buy me a coffee](https://ko-fi.com/jkenley).
+If you find glance-cli useful, consider [buying me a coffee](https://ko-fi.com/jkenley) ☕
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/jkenley)
 
 ---
 
-## 📄 License
-
-MIT License - see [LICENSE](LICENSE) for details.
-
----
-
-## 🔗 Links
+## Links
 
 - **GitHub**: [github.com/jkenley/glance-cli](https://github.com/jkenley/glance-cli)
 - **NPM**: [npmjs.com/package/glance-cli](https://www.npmjs.com/package/glance-cli)
@@ -276,6 +226,6 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
-**Built with ❤️ by [Kenley Jean](https://github.com/jkenley)**
+**Built with ❤️ by [Kenley Jean](https://github.com/jkenley)** • MIT License
 
 *Star ⭐ the repo if you find it useful!*