copilot-agent 0.9.0 → 0.11.0

package/README.md

@@ -12,8 +12,15 @@ 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 |
+| **`hooks`** | Event-driven automation (on_task_complete, on_error, etc.) |
+| **`pr`** | Auto-create GitHub Pull Request from session changes |
 
 All commands support `--agent copilot` or `--agent claude` (auto-detects if omitted).
 
@@ -43,7 +50,6 @@ copilot-agent status --active
 
 # Filter by agent
 copilot-agent status --agent claude
-copilot-agent status --agent copilot
 ```
 
 ### Watch & auto-resume
@@ -83,46 +89,119 @@ 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
+
+# Simple ANSI fallback (no dependencies)
+copilot-agent dashboard --simple
+
+# Web UI (Hono + htmx, opens browser)
+copilot-agent web
+```
+
+### Configuration
+
+```bash
+# Set persistent defaults
+copilot-agent config set agent claude
+copilot-agent config set steps 50
+copilot-agent config set worktree true
 
-# Multiple recent sessions as JSON
-copilot-agent report -l 5 --json
+# View all config (defaults + global + project)
+copilot-agent config list
 
-# Filter by project directory
-copilot-agent report --project ~/my-project
+# Per-project config: create .copilot-agent.yaml in project root
 ```
 
-### Research
+### Proxy management (Claude Code via Copilot)
 
 ```bash
-# Analyze current project
-copilot-agent research
+# Start copilot-api proxy (auto-detects Copilot OAuth token)
+copilot-agent proxy start
 
-# With Claude Code
-copilot-agent research --agent claude
+# Check status (PID, port, token, model count)
+copilot-agent proxy status
 ```
 
-### Dashboards
+### Usage tracking
 
 ```bash
-# Terminal UI (pure ANSI, no deps)
-copilot-agent dashboard
+# Show last 7 days of premium/token usage
+copilot-agent quota
 
-# Web UI (Hono + htmx, opens browser)
-copilot-agent web
-copilot-agent web --port 8080
+# 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
+```
+
+### Hooks (event-driven automation)
+
+```bash
+# Show configured hooks
+copilot-agent hooks list
+
+# Test-run hooks for an event
+copilot-agent hooks test on_task_complete
+```
+
+Create `~/.copilot-agent/hooks.yaml` or `.copilot-agent/hooks.yaml`:
+
+```yaml
+on_task_complete:
+  - command: "npm test"
+    name: "Run tests"
+on_session_end:
+  - command: "git push origin HEAD"
+    name: "Auto-push"
+on_error:
+  - command: "curl -X POST $SLACK_WEBHOOK -d '{\"text\":\"Agent error!\"}'"
+    name: "Notify Slack"
+```
+
+### Auto-create Pull Request
+
+```bash
+# Create PR from latest session
+copilot-agent pr
+
+# Dry-run (preview without creating)
+copilot-agent pr --dry-run
+
+# Create ready (non-draft) PR
+copilot-agent pr --no-draft
 ```
 
 ## How it works
@@ -133,6 +212,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