hermes-git 0.2.5 → 0.3.0

package/README.md

@@ -4,716 +4,362 @@
 
 **Intent-driven Git, guided by AI**
 
+[![npm version](https://img.shields.io/npm/v/hermes-git.svg)](https://www.npmjs.com/package/hermes-git)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
-[![Powered by GitHub Copilot](https://img.shields.io/badge/Powered%20by-GitHub%20Copilot-purple)](https://github.com/github/copilot-cli)
 
 *Turn natural language intent into safe, explainable Git operations*
 
-[Installation](#installation) • [Commands](#commands) • [Examples](#examples) • [Documentation](#documentation)
+[Installation](#installation) • [Quick Start](#quick-start) • [Commands](#commands) • [Configuration](#configuration)
 
 </div>
 
 ---
 
-## Overview
+## What it does
 
-Hermes is an AI-powered CLI that helps developers navigate Git safely and confidently. Instead of memorizing commands or untangling conflicts blindly, you tell Hermes what you want to do—and it guides you through the safest path.
+Hermes is a CLI that translates what you want to do in Git into the correct, safe sequence of commands — and explains every step.
 
-Built with [GitHub Copilot CLI](https://github.com/github/copilot-cli), Hermes transforms natural language intent into explainable, guard-railed Git operations directly in your terminal.
-
-### 🚀 What Makes Hermes Stand Out
-
-- **⏱️ Quantified Efficiency:** Track exactly how much time you save with built-in analytics
-- **🧠 Context-Aware:** Learns your project patterns and enforces team conventions
-- **📊 Built-in Analytics:** See your productivity gains, command usage, and Git efficiency improvements
-- **🔄 Workflow Shortcuts:** Turn 50+ commands into 5 with intelligent macros
-- **🛡️ Safety First:** Auto-backup, pre-flight checks, and explainable operations
-- **👥 Team-Ready:** Share config and workflows across your entire team
-
-### Why Hermes?
-
-Git is powerful, but unforgiving. Even experienced developers regularly:
-
-- 🔀 Rebase the wrong branch
-- ⚠️ Panic during merge conflicts
-- 🤔 Forget what state their repository is in
-- 🌳 Avoid worktrees because they feel dangerous
-
-**Hermes doesn't replace Git.** It stands beside you, explaining where you are, what's risky, and what your safest next move is.
-
-> Think of Hermes as your guide at every crossing—the messenger between you and Git's complexity.
-
----
-
-## Core Principles
+```bash
+hermes start "add oauth login"
+# → Picks the right base branch
+# → Creates feature/add-oauth-login
+# → Switches and sets upstream
 
-### 🧠 Intent First
-Tell Hermes what you want to achieve, not which flags to remember.
+hermes sync
+# → Evaluates rebase vs merge based on your branch state
+# → Explains the tradeoff before doing anything
 
-### 🛡️ Safety by Default
-Hermes prefers the least destructive option and explains tradeoffs before acting.
+hermes conflict explain
+# → Reads the conflict markers
+# → Explains what each side was trying to do
+# → Suggests a resolution strategy
 
-### 🔍 Explainable Actions
-Every command shows what happened and why. No magic, no surprises.
+hermes wip
+# → Decides commit vs stash based on your repo state
+# → Saves your work safely
+```
 
-### 🧑‍💻 Terminal-Native
-No UI, no context switching. Just clarity where you already work.
+No magic. Every command shows exactly what git operations it runs.
 
 ---
 
 ## Installation
 
-### Prerequisites
-
-- **Node.js** 18.0 or higher
-- **Git** (obviously!)
-- **[GitHub Copilot CLI](https://github.com/github/copilot-cli)** (with active subscription)
-
-### Install Hermes
-
 ```bash
 npm install -g hermes-git
 ```
 
-### Setup GitHub Copilot CLI
+**Requires:** Node.js 18+, Git
 
-If you haven't already:
+### Set up your AI provider
 
-```bash
-# Install Copilot CLI from GitHub releases
-# https://github.com/github/copilot-cli
-
-# Authenticate
-copilot login
-```
-
-### Verify Installation
+Hermes works with Anthropic, OpenAI, or Google Gemini — bring your own API key.
 
 ```bash
-hermes --version
-hermes --help
+hermes config setup
 ```
 
----
-
-## Quick Start
+This walks you through selecting a provider and saving your key to `~/.config/hermes/config.json` (chmod 600).
 
-### 1. Initialize Your Project
+Or set it manually:
 
 ```bash
-hermes init
-```
-
-Sets up project context, branch naming patterns, and preferences. Config is shareable across your team.
+# Anthropic (Claude)
+hermes config set provider anthropic
+hermes config set anthropic-key sk-ant-...
 
-### 2. Start Working
+# OpenAI (GPT-4o)
+hermes config set provider openai
+hermes config set openai-key sk-...
 
-```bash
-hermes start "user authentication"
-# Creates: feature/user-authentication
-# Switches from correct base branch
-# Tracks time saved
+# Google Gemini
+hermes config set provider gemini
+hermes config set gemini-key AIza...
 ```
 
-### 3. Check Your Efficiency
+Verify it worked:
 
 ```bash
-hermes stats
-
-╔══════════════════════════════════════════════════════╗
-║  Hermes Efficiency Report - Last 30 Days           ║
-╚══════════════════════════════════════════════════════╝
-
-⏱️  Time Saved:        12.4 hours
-🚀  Commands Run:      847 → 123 (85% reduction)
-📈  Efficiency Gain:   +34% compared to raw Git
+hermes config list
 ```
 
 ---
 
-## Commands
-
-### 🎯 Essential Commands
-
-### `hermes init [--quick]`
-
-**Initialize Hermes for your project.**
+## Quick Start
 
 ```bash
-hermes init          # Interactive setup
-hermes init --quick  # Use sensible defaults
-```
-
-**Creates:**
-- `.hermes/config.json` - Project configuration (commit this!)
-- Branch naming patterns
-- Workflow shortcuts
-- Team preferences
-
-**Why this matters:** Consistency across your entire team, automatic convention enforcement.
-
----
-
-### `hermes stats [-d <days>]`
+# 1. Install and configure
+npm install -g hermes-git
+hermes config setup
 
-**See your productivity gains and efficiency metrics.**
+# 2. Initialize your project (optional, enables team config sharing)
+cd your-project
+hermes init
 
-```bash
-hermes stats          # Last 30 days
-hermes stats -d 7     # Last week
-hermes stats --all-time
+# 3. Start working
+hermes start "user authentication"
 ```
 
-**Shows:**
-- Time saved vs raw Git
-- Command reduction percentage
-- Success rate
-- Most-used commands
-- Productivity streak
-
-**Why this matters:** Quantify your efficiency improvements, see where Hermes helps most.
-
 ---
 
-### `hermes workflow <command>`
+## Commands
+
+### `hermes config`
 
-**One-command workflows for common Git patterns.**
+Manage API keys and provider settings.
 
 ```bash
-hermes workflow pr-ready   # Sync, rebase, push (ready for PR)
-hermes workflow daily-sync # Morning routine: fetch, status, suggestions
-hermes workflow list       # Show all available shortcuts
+hermes config setup              # Interactive wizard
+hermes config list               # Show current config (keys masked)
+hermes config set provider openai
+hermes config set openai-key sk-...
+hermes config get provider
+hermes config unset gemini-key
 ```
 
-**Why this matters:** Turn 10+ commands into 1. Save 5-10 minutes per workflow.
+Config is stored in `~/.config/hermes/config.json`. You can also use environment variables or a `.env` file — see [Configuration](#configuration).
 
 ---
 
 ### `hermes plan "<intent>"`
 
-**Analyze your repository state and propose a safe Git plan.**
+Analyze repo state and propose a safe Git plan. **Makes no changes.**
 
 ```bash
-hermes plan "bring main into my branch without losing my changes"
+hermes plan "bring main into my branch without losing my work"
+hermes plan "clean up before submitting a PR"
 ```
 
-**Output includes:**
-- Current repository state (clean, conflicted, mid-rebase, etc.)
-- Recommended strategy (merge vs rebase) with reasoning
-- Potential risks and safety considerations
-- Step-by-step next actions
-
-**No changes are made.** This is analysis only.
-
 ---
 
 ### `hermes start "<task>"`
 
-**Start a new piece of work safely.**
+Start a new piece of work safely.
 
 ```bash
-hermes start "login refactor"
+hermes start "payment refactor"
+# → Picks correct base branch
+# → Creates and switches to feature/payment-refactor
 ```
 
-**Hermes will:**
-- Choose the correct base branch
-- Generate a conventional branch name
-- Create and switch to the new branch
-- Set upstream tracking if needed
-- Explain what it did and why
-
 ---
 
-### `hermes wip [--message "<msg>"]`
+### `hermes sync [--from <branch>]`
 
-**Save work-in-progress safely when things get messy.**
+Bring your branch up to date.
 
 ```bash
-hermes wip --message "checkpoint before rebase"
+hermes sync
+hermes sync --from develop
 ```
 
-**Hermes decides whether to:**
-- Create a WIP commit, or
-- Stash changes with a meaningful label
-
-Based on repository state and what's safest. **No lost work. Ever.**
+Hermes evaluates whether rebase or merge is safer given your branch state and explains before executing.
 
 ---
 
-### `hermes sync [--from <branch>]`
+### `hermes wip [-m "<message>"]`
 
-**Bring your branch up to date safely.**
+Save work in progress.
 
 ```bash
-hermes sync
-hermes sync --from develop
+hermes wip
+hermes wip -m "checkpoint before sync"
 ```
 
-**Hermes evaluates:**
-- Whether the branch is shared (has remote tracking)
-- Whether rebase is safe
-- Whether merge is preferable
-
-If a risky operation is detected, Hermes explains before proceeding.
+Decides commit vs stash based on what's safest in your current state.
 
 ---
 
 ### `hermes conflict explain`
 
-**Understand why a merge conflict exists.**
+Understand why a conflict exists.
 
 ```bash
 hermes conflict explain
 ```
 
-**Hermes will:**
-- List all conflicted files
-- Summarize each side's intent (ours vs theirs)
-- Identify common causes (refactor, rename, move)
-- Suggest a resolution strategy
-
-This is explanation, not guesswork. Make informed decisions.
+For each conflicted file: what each side was doing, why they conflict, and how to approach resolution.
 
 ---
 
 ### `hermes conflict apply`
 
-**Resolve conflicts with AI-powered guidance.**
+Resolve conflicts file by file with AI assistance.
 
 ```bash
 hermes conflict apply
 ```
 
-**For each conflicted file, Hermes:**
-- Proposes a merged version
-- Shows a diff preview
-- Lets you choose: accept, edit manually, or skip
-
-**Hermes never auto-commits without your consent.**
+For each file: shows a proposed resolution, lets you accept, edit manually, or skip. Never auto-commits.
 
 ---
 
-### `hermes worktree new "<task>"`
+### `hermes workflow <name>`
 
-**Create Git worktrees safely and predictably.**
+One-command workflows for common patterns.
 
 ```bash
-hermes worktree new "fix flaky tests"
+hermes workflow pr-ready      # fetch → rebase → push --force-with-lease
+hermes workflow daily-sync    # fetch all → show status → suggest next action
+hermes workflow quick-commit  # generate commit message from staged diff
+hermes workflow list          # show available workflows
 ```
 
-**Hermes will:**
-- Create a branch
-- Create a worktree in a predictable location
-- Track active worktrees
-- Help prevent committing in the wrong place
-
 ---
 
-## Examples
-
-### Example Workflows
+### `hermes worktree new "<task>"`
 
-#### First-Time Setup
+Create a Git worktree safely.
 
 ```bash
-# Initialize project
-cd your-project
-hermes init
-
-# Answer a few questions:
-# - Project name?
-# - Main branch? (main)
-# - Feature branch pattern? (feature/{description})
-# - Enable auto-backup? (yes)
-
-# Config saved and ready for your team!
+hermes worktree new "fix memory leak"
+# → Creates branch, worktree at ../repo-fix-memory-leak
 ```
 
-#### Daily Developer Workflow
-
-```bash
-# Morning: check status
-hermes workflow daily-sync
-
-# Start new feature
-hermes start "oauth2-login"
-# → Creates: feature/oauth2-login
-# → Tracks time: saved ~60s vs manual Git
-
-# Work on code...
-
-# Save progress
-hermes wip -m "checkpoint"
-# → Decides: commit vs stash based on state
-# → Auto-backup if configured
-
-# Sync with main
-hermes sync
-# → Evaluates: rebase vs merge
-# → Explains why before executing
-
-# Handle conflicts
-hermes conflict explain
-hermes conflict apply
-
-# Ready for PR
-hermes workflow pr-ready
-# → Fetch, rebase, push --force-with-lease
+---
 
-# Check efficiency gains
-hermes stats
-# 🎉 Time saved today: 24 minutes!
-```
+### `hermes init [--quick]`
 
-### Real-World Scenarios
+Initialize project-level config (`.hermes/config.json`). Commit this to share branch patterns and workflows with your team.
 
-**Scenario 1: Safe branch sync**
 ```bash
-$ hermes plan "update my feature branch with latest main"
-
-🔍 Analyzing repository state...
-
-📋 Recommended Plan:
-Your branch is 5 commits behind main. Rebase is safe because:
-- No remote tracking (local-only branch)
-- Working directory is clean
-- No ongoing operations
-
-Recommended: git fetch && git rebase origin/main
+hermes init         # Interactive
+hermes init --quick # Use defaults
 ```
 
-**Scenario 2: Conflict resolution**
-```bash
-$ hermes conflict explain
-
-🔍 Analyzing conflicts...
+---
 
-⚔️  Conflicts detected:
-  • src/auth/login.ts
+### `hermes stats [-d <days>]`
 
-🔍 Analysis:
-main refactored the authentication flow to use async/await,
-while your branch updated error handling with try-catch.
+Show command usage and success rate.
 
-Both changes are valid. Merge both approaches:
-1. Keep async/await structure from main
-2. Integrate your error handling improvements
+```bash
+hermes stats
+hermes stats -d 7
+hermes stats --all-time
 ```
 
 ---
 
-## How It Works
+## Configuration
 
-Hermes uses **GitHub Copilot CLI** as its reasoning engine to:
+Hermes resolves config in this priority order:
 
-- 🧠 Interpret natural language intent
-- 📊 Analyze repository state
-- 🔧 Generate safe Git command sequences
-- 💬 Explain decisions in human-readable terms
+| Source | Example |
+|--------|---------|
+| Environment variable | `export ANTHROPIC_API_KEY=sk-ant-...` |
+| `.env` file in current dir | `ANTHROPIC_API_KEY=sk-ant-...` |
+| `~/.config/hermes/config.json` | set via `hermes config set` |
 
-**Copilot CLI is not a wrapper here—it's the intelligence behind Hermes' decisions.**
+**Supported env vars:**
 
-The integration uses the standalone Copilot CLI (not the deprecated `gh copilot` extension) in non-interactive mode, ensuring fast, scriptable, and explainable Git operations.
+| Variable | Description |
+|----------|-------------|
+| `HERMES_PROVIDER` | Pin provider: `anthropic`, `openai`, or `gemini` |
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `OPENAI_API_KEY` | OpenAI API key |
+| `GEMINI_API_KEY` / `GOOGLE_API_KEY` | Google Gemini API key |
 
----
+If `HERMES_PROVIDER` is not set, Hermes auto-detects by using whichever key it finds first (Anthropic → OpenAI → Gemini).
 
-## Philosophy
+**Supported providers and models:**
 
-Hermes follows three rules:
-
-### 1. Never Hide Git
-You can always see the commands Hermes runs. No abstraction, no magic.
-
-### 2. Never Surprise the User
-Every action is explained before execution. You maintain control.
-
-### 3. Never Trade Safety for Speed
-Hermes prefers the safest path, even if it takes one more step.
-
-**You can always drop down to raw Git.** Hermes exists to guide, not to obscure.
+| Provider | Model | Get a key |
+|----------|-------|-----------|
+| Anthropic | claude-sonnet-4-6 | [console.anthropic.com](https://console.anthropic.com/) |
+| OpenAI | gpt-4o | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
+| Google | gemini-2.0-flash | [aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey) |
 
 ---
 
-## Documentation
+## How it works
 
-- **[Integration Guide](docs/INTEGRATION.md)** - How GitHub Copilot CLI powers Hermes
-- **[Development Guide](docs/DEVELOPMENT.md)** - Contributing and extending Hermes
-- **[Changelog](docs/CHANGELOG.md)** - Version history and releases
+1. **Reads your repo state** — branch, commits, dirty files, conflicts, remote tracking
+2. **Sends context + intent to an AI** — using your configured provider
+3. **Validates the response** — all returned commands must start with `git`, destructive flags are blocked
+4. **Executes with display** — shows every command before running it
+5. **You always stay in control** — interactive prompts for anything irreversible
 
 ---
 
-## Comparison
-
-### Hermes vs Raw Git
+## Philosophy
 
-| Task | Raw Git | Hermes |
-|------|---------|--------|
-| **Sync branch** | Remember rebase vs merge rules, check if shared | `hermes sync` - evaluates and explains |
-| **Start feature** | Think of branch name, remember base branch | `hermes start "feature name"` - handles conventions |
-| **Save WIP** | Decide commit vs stash, write message | `hermes wip` - chooses safest option |
-| **Resolve conflict** | Parse diff markers, guess intent | `hermes conflict explain` - AI explains both sides |
+**Never hide Git.** Every command Hermes runs is shown. You can drop to raw Git at any point.
 
-### Hermes vs Git GUIs
+**Never surprise.** Risky operations include an explanation before execution.
 
-Hermes is **terminal-native** and **explainable**:
-- No context switching from your terminal workflow
-- Every operation is a learning opportunity
-- Works over SSH, in Docker, anywhere Git works
-- Integrates with your existing Git knowledge
+**Bring your own AI.** No proprietary backend. Works with any provider you already pay for.
 
 ---
 
 ## Troubleshooting
 
-### Copilot CLI Not Found
-
-```bash
-❌ GitHub Copilot CLI is not installed
-```
-
-**Problem:** Hermes requires the standalone Copilot CLI (not the deprecated `gh copilot` extension).
-
-**Solution:**
+**No AI provider configured**
 
 ```bash
-# Install via npm (recommended)
-npm install -g @github/copilot
-
-# Or via Homebrew (macOS/Linux)
-brew install github/gh/copilot-cli
-
-# Verify installation
-copilot --version
+hermes config setup
 ```
 
-**Note:** The old `gh copilot` extension was deprecated on October 25, 2025. If you have it installed, you'll see a warning—install the new standalone CLI instead.
-
----
-
-### Authentication Required
+**Wrong provider selected**
 
 ```bash
-❌ GitHub Copilot CLI is not authenticated
+hermes config set provider anthropic
+hermes config list   # verify
 ```
 
-**Problem:** Copilot CLI needs GitHub authentication to work.
-
-**Solution (choose one):**
+**Key saved but not working**
 
-**Option 1: OAuth (Recommended)**
 ```bash
-# Start Copilot CLI interactively
-copilot
+# Check what Hermes sees
+hermes config list
 
-# In the Copilot prompt, type:
-/login
-
-# Follow the browser OAuth flow
+# Environment variables override saved config
+# Check for conflicting vars:
+echo $ANTHROPIC_API_KEY
 ```
 
-**Option 2: Personal Access Token**
-```bash
-# Create a token at: https://github.com/settings/tokens
-# Enable "Copilot Requests" permission under "Permissions"
-
-# Set the token in your environment
-export GH_TOKEN="your_token_here"
+**General debugging**
 
-# Add to your shell profile (~/.bashrc, ~/.zshrc) to persist:
-echo 'export GH_TOKEN="your_token_here"' >> ~/.bashrc
-```
-
-**Option 3: GitHub CLI Integration**
 ```bash
-# If you already have gh CLI installed and authenticated
-gh auth login
-
-# Copilot CLI will automatically use those credentials
-```
-
-**Requirements:**
-- Active GitHub Copilot subscription ([subscribe here](https://github.com/features/copilot/plans))
-- If using organization Copilot, "Copilot CLI" must be enabled in org settings
-
----
-
-### Subscription Issues
-
-```bash
-❌ GitHub Copilot subscription required
-```
-
-**Solution:**
-- Verify you have an active Copilot subscription at [github.com/settings/copilot](https://github.com/settings/copilot)
-- If using organization Copilot, check with your admin that "Copilot CLI" is enabled
-- Individual plans start at $10/month, or free for students/OSS maintainers
-
----
-
-### Slow Responses
-
-If AI responses are slow, try:
-- Use a faster model: `--model claude-sonnet-4.5` (default, fastest)
-- Check internet connection
-- Verify Copilot subscription is active
-- Try running `copilot` directly to test connection
-
----
-
-### Command Not Working
-
-```bash
-# Check Hermes version
 hermes --version
-
-# Verify Copilot CLI is installed and authenticated
-copilot --version
-copilot -p "test" --allow-all-tools -s
-
-# Check git is working
+hermes config list
 git status
-
-# Test in a clean repo
-cd /tmp && git init test && cd test
-git config user.name "Test" && git config user.email "test@example.com"
-hermes plan "test"
 ```
 
 ---
 
-### Getting Help
-
-If you're still having issues:
-1. Check the [GitHub Copilot CLI documentation](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli)
-2. Verify Copilot CLI works independently: `copilot -p "hello" -s`
-3. Open an issue at [github.com/simandebvu/hermes-cli/issues](https://github.com/simandebvu/hermes-cli/issues) with:
-   - Output of `hermes --version`
-   - Output of `copilot --version`
-   - The exact error message you're seeing
-
----
-
 ## Contributing
 
-Contributions are welcome! Please see [DEVELOPMENT.md](DEVELOPMENT.md) for:
-
-- Project structure
-- Development setup
-- Adding new commands
-- Testing guidelines
-- Code style
-
-### Quick Start for Contributors
-
 ```bash
-# Clone and install
-git clone https://github.com/yourusername/hermes.git
-cd hermes
+git clone https://github.com/simandebvu/hermes-cli.git
+cd hermes-cli
 bun install
-
-# Run in dev mode
 bun run dev --help
-
-# Build
 bun run build
-
-# Test
 bun run typecheck
 ```
 
----
-
-## FAQ
-
-**Q: Does Hermes send my code to AI services?**
-A: Only repository state metadata (branch names, file lists, status) is sent. File contents are not transmitted unless explicitly needed for conflict resolution. See [SECURITY.md](docs/SECURITY.md) for details.
-
-**Q: Does Hermes require a GitHub Copilot subscription?**
-A: Yes. Hermes uses the GitHub Copilot CLI, which requires an active Copilot subscription.
-
-**Q: Can I use Hermes without internet?**
-A: No. Hermes requires internet connectivity to communicate with GitHub Copilot's AI models.
-
-**Q: Will Hermes work with my existing Git workflow?**
-A: Yes! Hermes is designed to complement your workflow, not replace it. Use it when you need guidance, fall back to raw Git anytime.
-
-**Q: What if Hermes suggests something wrong?**
-A: Hermes never executes commands without showing them first. You always have the final say. If a suggestion seems wrong, don't proceed and use raw Git instead.
-
----
-
-## Efficiency Metrics
-
-Real-world time savings reported by users:
-
-| Task | Raw Git | With Hermes | Time Saved |
-|------|---------|-------------|------------|
-| **Start feature** | 2-3 min | 30 sec | ~2 min |
-| **Sync branch** | 3-5 min | 45 sec | ~3 min |
-| **Resolve conflict** | 10-15 min | 5 min | ~8 min |
-| **Daily workflows** | 15-20 min | 5 min | ~12 min |
-
-**Average:** **10-15 hours saved per developer per month**
-
----
-
-## Roadmap
-
-### Current (v0.2) ✨
-- ✅ 10 commands including efficiency features
-- ✅ GitHub Copilot CLI integration
-- ✅ Project context awareness (`hermes init`)
-- ✅ Analytics dashboard (`hermes stats`)
-- ✅ Workflow shortcuts (`hermes workflow`)
-- ✅ Team-shareable configuration
-- ✅ Time-saved tracking
-
-### Next (v0.3)
-- [ ] `hermes undo` - Revert last operation safely
-- [ ] Auto-backup system before risky operations
-- [ ] Ticket integration (Linear, Jira)
-- [ ] `--dry-run` flag for all commands
-
-See [PRODUCT_VISION.md](docs/PRODUCT_VISION.md) for full roadmap.
-
-### Future
-- [ ] `hermes review` - PR review assistance
-- [ ] `hermes explain "<git-command>"` - Explain any Git command
-- [ ] Configuration file support (`~/.hermesrc`)
-- [ ] Plugin system for custom commands
-- [ ] Interactive mode with `hermes shell`
+Issues and PRs welcome at [github.com/simandebvu/hermes-cli](https://github.com/simandebvu/hermes-cli).
 
 ---
 
 ## Why "Hermes"?
 
-In Greek mythology, **Hermes** is the guide of travelers and the messenger between worlds.
-
-- **Branches are worlds.**
-- **Merges are crossings.**
-- **Hermes ensures you cross safely.**
+In Greek mythology, Hermes guides travelers and carries messages between worlds. Branches are worlds. Merges are crossings. Hermes makes sure you get there safely.
 
 ---
 
 ## License
 
-[MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.
-
----
-
-## Acknowledgments
-
-- Powered by [GitHub Copilot CLI](https://github.com/github/copilot-cli)
-- Built with [Commander.js](https://github.com/tj/commander.js), [Chalk](https://github.com/chalk/chalk), and [Inquirer](https://github.com/SBoudrias/Inquirer.js)
-- Inspired by the need to make Git safer and more accessible
+[MIT](LICENSE)
 
 ---
 
 <div align="center">
 
-**Made with 🪽 by developers, for developers**
+**Built with [Commander.js](https://github.com/tj/commander.js), [Chalk](https://github.com/chalk/chalk), [Inquirer](https://github.com/SBoudrias/Inquirer.js)**
 
-[Report Bug](https://github.com/simandebvu/hermes-cli/issues) • [Request Feature](https://github.com/simandebvu/hermes-cli/issues) • [Documentation](docs/INTEGRATION.md)
+[Report a bug](https://github.com/simandebvu/hermes-cli/issues) • [Request a feature](https://github.com/simandebvu/hermes-cli/issues)
 
 </div>