Update documentation for v0.2.0 release

- Update CHANGELOG.md with comprehensive v0.2.0 release notes
  - Document new agent upgrade command
  - Document automated version detection for all agents
  - Document parallel version checking improvements
  - Document bug fixes (npm 404s, Ollama version detection)
  - Document UI/UX improvements

- Update README.md with v0.2.0 information
  - Update "What's New" section with v0.2.0 highlights
  - Add new "agentpipe agents" command documentation
  - Document "agentpipe agents list" with --installed and --outdated flags
  - Document "agentpipe agents upgrade" with examples
  - Include example output and usage patterns

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: kevinelliott

CHANGELOG.md

@@ -7,6 +7,61 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [v0.2.0] - 2025-10-20
+
+### Added
+- **Agent Upgrade Command**: New `agentpipe agents upgrade` subcommand for easy updates
+  - Upgrade individual agents: `agentpipe agents upgrade claude`
+  - Upgrade multiple agents: `agentpipe agents upgrade claude ollama gemini`
+  - Upgrade all installed agents: `agentpipe agents upgrade --all`
+  - Automatic detection of installed agents for selective upgrades
+  - User confirmation prompts before performing upgrades
+  - Cross-platform support (darwin, linux, windows)
+- **Automated Version Detection**: Complete version checking for all 10 supported agents
+  - npm registry integration (Claude, Codex, Gemini, Copilot, Amp, Qwen)
+  - Homebrew Formulae API integration (Ollama)
+  - GitHub Releases API integration (Qwen fallback)
+  - Shell script parsing for version extraction (Factory, Cursor)
+  - JSON manifest parsing (Qoder)
+  - Replaces all "manual install" placeholders with actual version numbers
+- **Multiple Package Manager Support**: Extensible version checking architecture
+  - `npm`: Query npm registry API for latest versions
+  - `homebrew`: Query Homebrew Formulae API for latest versions
+  - `github`: Query GitHub Releases API for latest releases
+  - `script`: Parse shell install scripts for VER= or DOWNLOAD_URL= version patterns
+  - `manifest`: Fetch and parse JSON manifests with "latest" field
+- **Parallel Version Checking**: Dramatically improved performance with concurrent API calls
+  - Goroutine-based concurrent version fetching
+  - Buffered channels for result collection
+  - Performance improvement: ~10+ seconds → ~3.7 seconds for 10 agents
+  - Thread-safe result aggregation
+
+### Fixed
+- **npm 404 Errors**: Corrected package names for npm-based agents
+  - Claude: `@anthropic-ai/claude-cli` → `@anthropic-ai/claude-code`
+  - Codex: `@openai/codex-cli` → `@openai/codex`
+  - Gemini: `@google/generative-ai-cli` → `@google/gemini-cli`
+- **Ollama Version Detection**: Enhanced to work without running Ollama instance
+  - Now parses version from warning messages (e.g., "Warning: client version is 0.12.5")
+  - Improved `containsVersion()` and `extractVersionNumber()` logic
+  - No longer requires Ollama server to be running
+
+### Improved
+- **UI/UX Enhancements**: Better table display for agent version information
+  - Removed redundant "Status" column from outdated agents table
+  - Rebalanced column widths for better readability
+    - Agent: 15 → 12 characters
+    - Installed Version: 20 → 24 characters
+    - Latest Version: 20 → 24 characters
+    - Total width: 80 → 85 characters
+  - Changed upgrade instructions from "install" to "upgrade" for clarity
+- **Agent Registry Metadata**: Complete package manager information for all agents
+  - Factory: Uses script-based version detection from https://app.factory.ai/cli
+  - Amp: Uses npm registry @sourcegraph/amp
+  - Cursor: Uses script-based version detection from https://cursor.com/install
+  - Qoder: Uses manifest from qoder-ide.oss-ap-southeast-1.aliyuncs.com
+  - All agents now have upgrade commands defined for current OS
+
 ## [v0.1.5] - 2025-10-19
 
 ### Fixed
@@ -346,7 +401,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Clean Message Display**: Smart consolidation of headers and proper paragraph formatting
 - **Cost Transparency**: See exactly how much each conversation costs
 
-[Unreleased]: https://github.com/kevinelliott/agentpipe/compare/v0.1.5...HEAD
+[Unreleased]: https://github.com/kevinelliott/agentpipe/compare/v0.2.0...HEAD
+[v0.2.0]: https://github.com/kevinelliott/agentpipe/compare/v0.1.5...v0.2.0
 [v0.1.5]: https://github.com/kevinelliott/agentpipe/compare/v0.1.4...v0.1.5
 [v0.1.4]: https://github.com/kevinelliott/agentpipe/compare/v0.1.3...v0.1.4
 [v0.1.3]: https://github.com/kevinelliott/agentpipe/compare/v0.1.1...v0.1.3

CLAUDE.md

@@ -135,4 +135,5 @@ goimports -local github.com/kevinelliott/agentpipe -w .
 - Fixed Homebrew formula path: Formulae → Formula
 - Added badges to README
 - Fixed all linting issues for CI
-- Before releasing, be sure that lints, tests, and build pass.
+- Before releasing, be sure that lints, tests, and build pass.
+- Before releasing, be sure to update and commit the README.md and CHANGELOG.md with the recent changes if they haven't been yet.

README.md

@@ -91,19 +91,31 @@ All agents now use a **standardized interaction pattern** with structured three-
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
 
-**Latest Release**: v0.1.5 - Linting fixes for clean CI/CD builds.
+**Latest Release**: v0.2.0 - Enhanced agent version management with automated upgrades.
 
-**What's New in v0.1.5**:
+**What's New in v0.2.0**:
+
+✨ **New Features:**
+- **Agent Upgrade Command**: Easily update AI agent CLIs
+  - `agentpipe agents upgrade <agent>` - Upgrade specific agents
+  - `agentpipe agents upgrade --all` - Upgrade all installed agents
+  - Cross-platform support with automatic OS detection
+- **Automated Version Detection**: Real-time version checking for all agents
+  - Parallel version checks with ~70% performance improvement (10s → 3.7s)
+  - Support for multiple package managers (npm, homebrew, GitHub, scripts, manifests)
+  - No more "manual install" placeholders - all agents show actual versions
 
 🐛 **Bug Fixes:**
-- **Linting Errors**: Fixed golangci-lint errors in doctor.go
-  - Fixed gofmt formatting (struct field alignment)
-  - Fixed prealloc warning (pre-allocated slices with known capacity)
-  - CI/CD pipeline now passes all quality checks
+- **npm 404 Errors**: Corrected package names for Claude, Codex, and Gemini
+- **Ollama Version Detection**: Now works without running Ollama instance
+  - Parses version from warning messages
+
+🎨 **UI/UX Improvements:**
+- **Better Table Display**: Rebalanced column widths for clearer output
+- **Clearer Instructions**: Changed from "install" to "upgrade" in messages
 
+**Previous Release - v0.1.5**: Linting fixes for clean CI/CD builds
 **Previous Release - v0.1.4**: JSON output for programmatic agent detection
-- `agentpipe doctor --json` for structured, machine-readable output
-- Perfect for dynamic UI generation (e.g., agentpipe-web)
 
 ## Installation
 
@@ -462,6 +474,87 @@ Use this command to:
 - Troubleshoot missing dependencies
 - Validate authentication status before starting conversations
 
+### `agentpipe agents`
+
+Manage AI agent CLI installations with version checking and upgrade capabilities.
+
+#### `agentpipe agents list`
+
+List all supported AI agent CLIs with their availability status.
+
+```bash
+# List all agents
+agentpipe agents list
+
+# List only installed agents
+agentpipe agents list --installed
+
+# List agents with available updates
+agentpipe agents list --outdated
+```
+
+**Output includes:**
+- Agent name and command
+- Installation status (✅ installed, ❌ not installed)
+- Current installed version
+- Latest available version
+- Update availability indicator
+
+**Example Output:**
+```
+AI Agent CLIs
+=============================================================
+
+Agent         Installed Version        Latest Version           Update
+---------------------------------------------------------------------------------
+Amp           not installed            2.1.0                    Install with: npm install -g @sourcegraph/amp
+Claude        2.0.19                   2.0.19                   ✅ Up to date
+Cursor        2025.10.17-e060db4       2025.10.17-e060db4       ✅ Up to date
+Factory       1.3.220                  1.3.220                  ✅ Up to date
+Gemini        0.9.0                    0.9.1                    ⚠️  Update available
+Ollama        0.12.5                   0.12.5                   ✅ Up to date
+Qoder         1.2.3                    1.2.3                    ✅ Up to date
+
+To upgrade an agent, use: agentpipe agents upgrade <agent>
+```
+
+#### `agentpipe agents upgrade`
+
+Upgrade one or more AI agent CLIs to the latest version.
+
+```bash
+# Upgrade a specific agent
+agentpipe agents upgrade claude
+
+# Upgrade multiple agents
+agentpipe agents upgrade claude ollama gemini
+
+# Upgrade all installed agents
+agentpipe agents upgrade --all
+```
+
+**Features:**
+- Automatic detection of current OS (darwin, linux, windows)
+- Uses appropriate package manager (npm, homebrew, etc.)
+- Confirmation prompt before upgrading
+- Parallel version checking for performance
+- Cross-platform support
+
+**Flags:**
+- `--all`: Upgrade all installed agents instead of specific ones
+
+**Example:**
+```bash
+$ agentpipe agents upgrade gemini
+
+Upgrading: gemini (0.9.0 → 0.9.1)
+Command: npm update -g @google/generative-ai-cli
+
+Proceed with upgrade? (y/N): y
+Running: npm update -g @google/generative-ai-cli
+✅ gemini upgraded successfully!
+```
+
 ### `agentpipe export`
 
 Export conversation from a state file to different formats.