copilot-agent 0.8.2 → 0.10.0

package/README.md

@@ -12,8 +12,13 @@ Autonomous AI agent manager — auto-resume sessions, discover tasks, run overni
 | **`overnight`** | Run tasks continuously until a deadline (e.g. 07:00) |
 | **`research`** | Architecture, security, and performance analysis |
 | **`report`** | Session activity report — tools, commits, files, tokens |
-| **`dashboard`** | Real-time TUI dashboard (pure terminal) |
+| **`dashboard`** | htop-style TUI dashboard with blessed (scrollable, keyboard nav) |
 | **`web`** | Web dashboard with live updates (Hono + htmx + SSE) |
+| **`config`** | Persistent configuration defaults (global + per-project) |
+| **`proxy`** | Manage copilot-api proxy for Claude Code via Copilot |
+| **`diff`** | Show git changes made by an agent session |
+| **`quota`** | Track premium requests, tokens, and usage over time |
+| **`compact`** | Generate context summary for session handoff/resume |
 
 All commands support `--agent copilot` or `--agent claude` (auto-detects if omitted).
 
@@ -43,7 +48,6 @@ copilot-agent status --active
 
 # Filter by agent
 copilot-agent status --agent claude
-copilot-agent status --agent copilot
 ```
 
 ### Watch & auto-resume
@@ -83,46 +87,82 @@ copilot-agent overnight ~/my-project
 
 # Run with Claude Code
 copilot-agent overnight --agent claude --until 07 --max-premium 200
-
-# Use worktree for parallel tasks
-copilot-agent overnight --worktree
 ```
 
-### Session report
+### Session report & diff
 
 ```bash
-# Latest session
+# Latest session report
 copilot-agent report
 
-# Specific session
-copilot-agent report abc12345-...
+# Show git changes from latest session
+copilot-agent diff
+
+# Show changes from specific session with diffstat
+copilot-agent diff abc12345-... --stat
+```
+
+### Dashboards
+
+```bash
+# htop-style TUI (blessed — scrollable, keyboard nav)
+copilot-agent dashboard
 
-# Multiple recent sessions as JSON
-copilot-agent report -l 5 --json
+# Simple ANSI fallback (no dependencies)
+copilot-agent dashboard --simple
 
-# Filter by project directory
-copilot-agent report --project ~/my-project
+# Web UI (Hono + htmx, opens browser)
+copilot-agent web
 ```
 
-### Research
+### Configuration
 
 ```bash
-# Analyze current project
-copilot-agent research
+# Set persistent defaults
+copilot-agent config set agent claude
+copilot-agent config set steps 50
+copilot-agent config set worktree true
+
+# View all config (defaults + global + project)
+copilot-agent config list
 
-# With Claude Code
-copilot-agent research --agent claude
+# Per-project config: create .copilot-agent.yaml in project root
 ```
 
-### Dashboards
+### Proxy management (Claude Code via Copilot)
 
 ```bash
-# Terminal UI (pure ANSI, no deps)
-copilot-agent dashboard
+# Start copilot-api proxy (auto-detects Copilot OAuth token)
+copilot-agent proxy start
 
-# Web UI (Hono + htmx, opens browser)
-copilot-agent web
-copilot-agent web --port 8080
+# Check status (PID, port, token, model count)
+copilot-agent proxy status
+```
+
+### Usage tracking
+
+```bash
+# Show last 7 days of premium/token usage
+copilot-agent quota
+
+# All-time usage
+copilot-agent quota --all
+
+# Last 30 days
+copilot-agent quota --days 30
+```
+
+### Context handoff (compact)
+
+```bash
+# Generate context summary from latest session
+copilot-agent compact
+
+# Save compact to file
+copilot-agent compact --save
+
+# Get a resume prompt to continue the work
+copilot-agent compact --resume-prompt
 ```
 
 ## How it works
@@ -133,6 +173,7 @@ copilot-agent web --port 8080
 4. **Task discovery** — Detects project type and generates relevant maintenance tasks
 5. **Race prevention** — File locking + process tracking prevents concurrent agents in the same directory
 6. **Worktree isolation** — Optional `--worktree` flag for parallel task execution via `git worktree`
+7. **Config layering** — Defaults → `~/.copilot-agent/config.yaml` → `.copilot-agent.yaml` → CLI flags
 
 ## Supported project types