Update README.md

Author: willwashburn

README.md

@@ -2,63 +2,88 @@
 
 Terminal dashboard to monitor Claude Code and Codex usage limits.
 
-## Install
-
-### Via npm (requires Bun)
+## Quickstart
 
 ```bash
 npm install -g agent-limit
+agent-limit usage
 ```
 
-### Standalone Binary (no dependencies)
-
-Download from [GitHub Releases](https://github.com/AgentWorkforce/limit/releases):
-
-```bash
-# Apple Silicon
-curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-arm64 -o /usr/local/bin/agent-limit
-chmod +x /usr/local/bin/agent-limit
+## Example
 
-# Intel Mac
-curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-x64 -o /usr/local/bin/agent-limit
-chmod +x /usr/local/bin/agent-limit
+```
+[███████░░░░|░░░░░░░░░] 30% ↓12%
+            ^ you should be at 42%, but you're at 30% (12% under pace)
 ```
 
-## Quick Start
+- `↓X%` (green) = under pace, you have headroom
+- `↑X%` (red) = over pace, might hit limits early
 
-```bash
-agent-limit usage
-```
+## Features
+
+- Real-time usage tracking for Claude Code and Codex
+- Trajectory markers showing if you're ahead or behind your usage pace
+- Auto-refresh every 60 seconds
+- Color-coded usage indicators
 
-## CLI
+## CLI Reference
 
 | Command | Description |
 |---------|-------------|
 | `agent-limit usage` | Show usage dashboard |
 | `agent-limit version` | Show version |
 | `agent-limit help` | Show help message |
 
-## Dashboard Controls
+### Dashboard Controls
 
 | Key | Action |
 |-----|--------|
 | `q` | Quit |
 | `r` | Refresh |
 
-## Features
-
-- Real-time usage tracking for Claude Code and Codex
-- Trajectory markers showing if you're ahead or behind your usage pace
-- Auto-refresh every 60 seconds
-- Color-coded usage indicators
-
 ## Supported Providers
 
 | Provider | Status | Data Source |
 |----------|--------|-------------|
 | Claude Code | Full support | macOS Keychain + Anthropic API |
 | Codex | Full support | `~/.codex/auth.json` + OpenAI API |
 
+## How It Works
+
+agent-limit reads credentials from standard locations:
+
+- **Claude Code**: macOS Keychain (`Claude Code-credentials`)
+- **Codex**: `~/.codex/auth.json`
+
+It then fetches usage data from each provider's API and displays it in a unified dashboard.
+
+## Installation Options
+
+### Via npm
+
+```bash
+npm install -g agent-limit
+```
+
+### Standalone Binary (no dependencies)
+
+Download from [GitHub Releases](https://github.com/AgentWorkforce/limit/releases):
+
+```bash
+# Apple Silicon
+curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-arm64 -o /usr/local/bin/agent-limit
+chmod +x /usr/local/bin/agent-limit
+
+# Intel Mac
+curl -L https://github.com/AgentWorkforce/limit/releases/latest/download/agent-limit-darwin-x64 -o /usr/local/bin/agent-limit
+chmod +x /usr/local/bin/agent-limit
+```
+
+## Requirements
+
+- macOS (uses Keychain for credential storage)
+- Active CLI authentication for providers you want to monitor
+
 ## Development
 
 ```bash
@@ -96,32 +121,6 @@ bun run build:x64     # Intel
 
 Binaries are output to `dist/`.
 
-## How It Works
-
-agent-limit reads credentials from standard locations:
-
-- **Claude Code**: macOS Keychain (`Claude Code-credentials`)
-- **Codex**: `~/.codex/auth.json`
-
-It then fetches usage data from each provider's API and displays it in a unified dashboard.
-
-### Trajectory Indicator
-
-Each progress bar shows a `|` marker indicating where your usage "should be" based on time elapsed in the reset period:
-
-```
-[███████░░░░|░░░░░░░░░] 30% ↓12%
-            ^ you should be at 42%, but you're at 30% (12% under pace)
-```
-
-- `↓X%` (green) = under pace, you have headroom
-- `↑X%` (red) = over pace, might hit limits early
-
-## Requirements
-
-- macOS (uses Keychain for credential storage)
-- Active CLI authentication for providers you want to monitor
-
 ## License
 
 MIT