oh-my-copilot 4.8.2-preview.1 → 4.11.3

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://github.com/copilot-cli/marketplace.schema.json",
-  "name": "omg",
-  "description": "Copilot CLI native multi-agent orchestration - intelligent model routing, 28 agents, 32 skills",
+  "name": "oh-my-copilot",
+  "description": "Copilot CLI native multi-agent orchestration - intelligent model routing, 18 agents, 32 skills",
   "owner": {
     "name": "Robin Norberg",
     "email": "robin@norberg.dev"
@@ -9,8 +9,8 @@
   "plugins": [
     {
       "name": "oh-my-copilot",
-      "description": "Copilot CLI native multi-agent orchestration with intelligent model routing, 28 agent variants, and 32 powerful skills. Zero learning curve. Maximum power.",
-      "version": "4.8.2-preview.1",
+      "description": "Copilot CLI native multi-agent orchestration with intelligent model routing, 18 agent variants, and 32 powerful skills. Zero learning curve. Maximum power.",
+      "version": "4.11.3",
       "author": {
         "name": "Robin Norberg",
         "email": "robin@norberg.dev"
@@ -27,5 +27,5 @@
       ]
     }
   ],
-  "version": "4.8.2-preview.1"
+  "version": "4.11.3"
 }

package/.claude-plugin/plugin.json

@@ -1,9 +1,9 @@
 {
   "name": "oh-my-copilot",
-  "version": "4.8.2-preview.1",
+  "version": "4.11.3",
   "description": "Multi-agent orchestration system for Copilot CLI",
   "author": {
-    "name": "oh-my-copilot contributors"
+    "name": "Robin Norberg and oh-my-copilot contributors"
   },
   "repository": "https://github.com/RobinNorberg/oh-my-copilot",
   "homepage": "https://github.com/RobinNorberg/oh-my-copilot",

package/.mcp.json

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "t": {
+    "oh-my-copilot": {
       "command": "node",
       "args": ["${PLUGIN_ROOT}/bridge/mcp-server.cjs"]
     }

package/README.md

@@ -1,180 +1,94 @@
-# oh-my-copilot
+```
+     ██████╗ ██╗  ██╗     ███╗   ███╗██╗   ██╗
+    ██╔═══██╗██║  ██║     ████╗ ████║╚██╗ ██╔╝
+    ██║   ██║███████║     ██╔████╔██║ ╚████╔╝
+    ██║   ██║██╔══██║     ██║╚██╔╝██║  ╚██╔╝
+    ╚██████╔╝██║  ██║     ██║ ╚═╝ ██║   ██║
+     ╚═════╝ ╚═╝  ╚═╝     ╚═╝     ╚═╝   ╚═╝
+               ██████╗ ██████╗ ██████╗ ██╗██╗      ██████╗ ████████╗
+              ██╔════╝██╔═══██╗██╔══██╗██║██║     ██╔═══██╗╚══██╔══╝
+              ██║     ██║   ██║██████╔╝██║██║     ██║   ██║   ██║
+              ██║     ██║   ██║██╔═══╝ ██║██║     ██║   ██║   ██║
+              ╚██████╗╚██████╔╝██║     ██║███████╗╚██████╔╝   ██║
+               ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚══════╝ ╚═════╝    ╚═╝
+       Turbocharge your Copilot CLI with multi-agent orchestration
+```
+<p align="left"  style="padding-left: 100px">
+  <img src="assets/omc-character.png" alt="oh-my-copilot" width="400" />
+  </br>
+  <strong><i>Your Copilot has been working out, learning new ways to improve your life.</i></strong>
+</p>
+
+---
 
 [![npm version](https://img.shields.io/npm/v/oh-my-copilot?color=cb3837)](https://www.npmjs.com/package/oh-my-copilot)
 [![npm downloads](https://img.shields.io/npm/dm/oh-my-copilot?color=blue)](https://www.npmjs.com/package/oh-my-copilot)
 [![GitHub stars](https://img.shields.io/github/stars/RobinNorberg/oh-my-copilot?style=flat&color=yellow)](https://github.com/RobinNorberg/oh-my-copilot/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-
-> oh-my-copilot is a fork of [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode) by Yeachan Heo, adapted for GitHub Copilot CLI.
-
-> **For Codex users:** Check out [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex) — the same orchestration experience for OpenAI Codex CLI.
-
-**Multi-agent orchestration for Copilot CLI. Zero learning curve.**
-
-_Don't learn Copilot CLI. Just use OMC._
-
-[Get Started](#quick-start) • [Documentation](https://docs/REFERENCE.md) • [CLI Reference](https://docs/REFERENCE.md/docs.html#cli-reference) • [Workflows](https://docs/REFERENCE.md/docs.html#workflows) • [Migration Guide](docs/MIGRATION.md)
-
----
+<br/>This work is based on [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode) by Yeachan Heo, but with copilot cli focus.
 
 ## Quick Start
 
-**Step 1: Install**
-
 ```bash
+# Step 1: Install
 /plugin marketplace add https://github.com/RobinNorberg/oh-my-copilot
 /plugin install oh-my-copilot
-```
+# or
+npm i -g oh-my-copilot@latest
 
-**Step 2: Setup**
 
-```bash
-/omg-setup
-```
+# Step 2: Setup
+/omc-setup
 
-**Step 3: Build something**
 
-```
-autopilot: build a REST API for managing tasks
+# Step 3: Build something
+/autopilot: build a todo-app
+# or
+autopilot: build a todo-app
 ```
 
-That's it. Everything else is automatic.
-
 ### Not Sure Where to Start?
 
 If you're uncertain about requirements, have a vague idea, or want to micromanage the design:
 
 ```
-/deep-interview "I want to build a task management app"
+/deep-interview "I want to build a todo-app"
 ```
 
-The deep interview uses Socratic questioning to clarify your thinking before any code is written. It exposes hidden assumptions and measures clarity across weighted dimensions, ensuring you know exactly what to build before execution begins.
+The deep interview uses Socratic questioning to clarify your thinking before any code is written.
 
-## Team Mode (Recommended)
+---
 
-Starting in **v4.1.7**, **Team** is the canonical orchestration surface in OMC. The legacy `swarm` keyword/skill has been removed; use `team` directly.
+## Key Features
 
-```bash
-/team 3:executor "fix all TypeScript errors"
-```
+- **Copilot CLI friendly** — Perfect for development in the terminal
+- **Natural language interface** — no commands to memorize, just describe what you want
+- **Team-first orchestration** — staged pipeline with plan, exec, verify, and fix loop
+- **Automatic parallelization** — complex tasks distributed across our specialized agents
+- **Smart model routing** — Haiku for simple tasks, Sonnet for average and Opus for complex reasoning
+- **Persistent execution** — won't give up until the job is verified complete
+- **Azure DevOps/GitHub native** — auto-detection, work item management, PR operations, triage workflows
+- **Stop your yolo abuse** — using a layered permission model to help your agents perform safe work without your interference
+---
 
-Team runs as a staged pipeline:
+## Team Mode
 
-`team-plan → team-prd → team-exec → team-verify → team-fix (loop)`
+**Team** is the canonical orchestration surface. It runs a staged pipeline:
 
-Enable Copilot CLI native teams in `~/.copilot/settings.json`:
+`team-plan → team-prd → team-exec → team-verify → team-fix (loop)`
 
-```json
-{
-  "env": {
-    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
-  }
-}
+```bash
+/team 3:executor "fix all TypeScript errors"
 ```
 
-> If teams are disabled, OMC will warn you and fall back to non-team execution where possible.
-
-### tmux CLI Workers — Codex & Gemini (v4.4.0+)
-
-**v4.4.0 removes the Codex/Gemini MCP servers** (`x`, `g` providers). Use the CLI-first Team runtime (`omc team ...`) to spawn real tmux worker panes:
+Spawn real tmux workers for cross-model tasks:
 
 ```bash
 omc team 2:codex "review auth module for security issues"
 omc team 2:gemini "redesign UI components for accessibility"
-omc team 1:copilot "implement the payment flow"
-omc team status auth-review
-omc team shutdown auth-review
 ```
 
-`/omg-teams` remains as a legacy compatibility skill and now routes to `omc team ...`.
-
-For mixed Codex + Gemini work in one command, use the **`/ccg`** skill (routes via `ask-codex` + `ask-gemini`, then Copilot synthesizes):
-
-```bash
-/ccg Review this PR — architecture (Codex) and UI components (Gemini)
-```
-
-| Surface                   | Workers            | Best For                                     |
-| ------------------------- | ------------------ | -------------------------------------------- |
-| `omc team N:codex "..."`  | N Codex CLI panes  | Code review, security analysis, architecture |
-| `omc team N:gemini "..."` | N Gemini CLI panes | UI/UX design, docs, large-context tasks      |
-| `omc team N:copilot "..."` | N Copilot CLI panes | General tasks via Copilot CLI in tmux         |
-| `/ccg`                    | ask-codex + ask-gemini | Tri-model advisor synthesis             |
-
-Workers spawn on-demand and die when their task completes — no idle resource usage. Requires `codex` / `gemini` CLIs installed and an active tmux session.
-
-> **Note: Package naming** — The project is branded as **oh-my-copilot** (repo, plugin, commands), but the npm package is published as [`oh-my-copilot`](https://www.npmjs.com/package/oh-my-copilot). If you install the CLI tools via npm/bun, use `npm install -g oh-my-copilot`.
-
-### Updating
-
-```bash
-# 1. Update the marketplace clone
-/plugin marketplace update omc
-
-# 2. Re-run setup to refresh configuration
-/omg-setup
-```
-
-> **Note:** If marketplace auto-update is not enabled, you must manually run `/plugin marketplace update omc` to sync the latest version before running setup.
-
-If you experience issues after updating, clear the old plugin cache:
-
-```bash
-/omg-doctor
-```
-
-<h1 align="center">Your Copilot In Overdrive.</h1>
-
-<p align="center">
-  <img src="assets/omg-character.png" alt="oh-my-copilot" width="400" />
-</p>
-
----
-
-## Why oh-my-copilot?
-
-- **Zero configuration required** - Works out of the box with intelligent defaults
-- **Team-first orchestration** - Team is the canonical multi-agent surface
-- **Natural language interface** - No commands to memorize, just describe what you want
-- **Automatic parallelization** - Complex tasks distributed across specialized agents
-- **Persistent execution** - Won't give up until the job is verified complete
-- **Cost optimization** - Smart model routing saves 30-50% on tokens
-- **Learn from experience** - Automatically extracts and reuses problem-solving patterns
-- **Real-time visibility** - HUD statusline shows what's happening under the hood
-
----
-
-## Features
-
-### Orchestration Modes
-
-Multiple strategies for different use cases — from Team-backed orchestration to token-efficient refactoring. [Learn more →](https://docs/REFERENCE.md/docs.html#execution-modes)
-
-| Mode                    | What it is                                                                              | Use For                                                |
-| ----------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------ |
-| **Team (recommended)**  | Canonical staged pipeline (`team-plan → team-prd → team-exec → team-verify → team-fix`) | Coordinated Copilot agents on a shared task list        |
-| **omc team (CLI)**      | tmux CLI workers — real `copilot`/`codex`/`gemini` processes in split-panes              | Codex/Gemini CLI tasks; on-demand spawn, die when done |
-| **ccg**                 | Tri-model advisors via ask-codex + ask-gemini, Copilot synthesizes                         | Mixed backend+UI work needing both Codex and Gemini    |
-| **Autopilot**           | Autonomous execution (single lead agent)                                                | End-to-end feature work with minimal ceremony          |
-| **Ultrawork**           | Maximum parallelism (non-team)                                                          | Burst parallel fixes/refactors where Team isn't needed |
-| **Ralph**               | Persistent mode with verify/fix loops                                                   | Tasks that must complete fully (no silent partials)    |
-| **Pipeline**            | Sequential, staged processing                                                           | Multi-step transformations with strict ordering        |
-| **Ultrapilot (legacy)** | Deprecated compatibility mode (autopilot pipeline alias)                                | Existing workflows and older docs                      |
-
-### Intelligent Orchestration
-
-- **32 specialized agents** for architecture, research, design, testing, data science
-- **Smart model routing** - Haiku for simple tasks, Opus for complex reasoning
-- **Automatic delegation** - Right agent for the job, every time
-
-### Developer Experience
-
-- **Magic keywords** - `ralph`, `ulw`, `team` for explicit control
-- **HUD statusline** - Real-time orchestration metrics in your status bar
-- **Skill learning** - Extract reusable patterns from your sessions
-- **Analytics & cost tracking** - Understand token usage across all sessions
-
-[Full feature list →](docs/REFERENCE.md)
+[Full Team Mode docs →](docs/guides/team-mode.md)
 
 ---
 
@@ -182,230 +96,133 @@ Multiple strategies for different use cases — from Team-backed orchestration t
 
 Optional shortcuts for power users. Natural language works fine without them.
 
-| Keyword                | Effect                                 | Example                                        |
-| ---------------------- | -------------------------------------- | ---------------------------------------------- |
-| `team`                 | Canonical Team orchestration           | `/team 3:executor "fix all TypeScript errors"` |
-| `omc team`             | tmux CLI workers (codex/gemini/copilot) | `omc team 2:codex "security review"`           |
-| `ccg`                  | ask-codex + ask-gemini synthesis       | `/ccg review this PR`                          |
-| `autopilot`            | Full autonomous execution              | `autopilot: build a todo app`                  |
-| `ralph`                | Persistence mode                       | `ralph: refactor auth`                         |
-| `ulw`                  | Maximum parallelism                    | `ulw fix all errors`                           |
-| `ralplan`              | Iterative planning consensus           | `ralplan this feature`                         |
-| `deep-interview`       | Socratic requirements clarification    | `deep-interview "vague idea"`                  |
-| `deepsearch`           | Codebase-focused search routing        | `deepsearch for auth middleware`               |
-| `ultrathink`           | Deep reasoning mode                    | `ultrathink about this architecture`           |
-| `ado triage`           | Azure DevOps work item triage          | `ado triage`                                   |
-| `ado setup`            | Configure Azure DevOps integration     | `ado setup`                                    |
-| `cancelomc`, `stopomc` | Stop active OMC modes                  | `stopomc`                                      |
+| Keyword | Category | Effect | Example |
+| ------- | -------- | ------ | ------- |
+| `team` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | Canonical Team orchestration | `team 3:executor "fix all TypeScript errors"` |
+| `ask claude` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | Delegate to Claude Code CLI | `ask claude "review auth architecture"` |
+| `ask codex` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | Delegate to Codex CLI | `ask codex "security analysis"` |
+| `ask gemini` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | Delegate to Gemini CLI | `ask gemini "suggest UX improvements"` |
+| `ccg` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | Quadri-model orchestration | `ccg review this PR` |
+| `omc team` | ![orchestration](https://img.shields.io/badge/orchestration-blue) | tmux CLI workers (codex/gemini/copilot) | `omc team 2:codex "security review"` |
+| `code review` | ![analysis](https://img.shields.io/badge/analysis-purple) | Code review mode | `code review the auth module` |
+| `deep-analyze` | ![analysis](https://img.shields.io/badge/analysis-purple) | Deep analysis mode | `deep-analyze why tests are failing` |
+| `deep-dive` | ![analysis](https://img.shields.io/badge/analysis-purple) | Trace → interview pipeline | `deep-dive why auth is slow` |
+| `deep-interview` | ![analysis](https://img.shields.io/badge/analysis-purple) | Socratic requirements clarification | `deep-interview "vague idea"` |
+| `deep-review` | ![analysis](https://img.shields.io/badge/analysis-purple) | Multi-pass code review (4 passes) | `deep-review this PR` |
+| `deepsearch` | ![analysis](https://img.shields.io/badge/analysis-purple) | Codebase-focused search routing | `deepsearch for auth middleware` |
+| `discover` | ![analysis](https://img.shields.io/badge/analysis-purple) | Parallel codebase quality scan | `discover src/hooks/` |
+| `security review` | ![analysis](https://img.shields.io/badge/analysis-purple) | Security review mode | `security review the API endpoints` |
+| `tdd`, `test first` | ![analysis](https://img.shields.io/badge/analysis-purple) | TDD workflow enforcement | `tdd: implement password validation` |
+| `ultrathink` | ![analysis](https://img.shields.io/badge/analysis-purple) | Deep reasoning mode | `ultrathink about this architecture` |
+| `ralplan` | ![planning](https://img.shields.io/badge/planning-orange) | Iterative planning consensus | `ralplan this feature` |
+| `autopilot` | ![execution](https://img.shields.io/badge/execution-green) | Full autonomous execution | `autopilot: build a todo app` |
+| `experiment` | ![execution](https://img.shields.io/badge/execution-green) | Hypothesis-driven experiment loop | `experiment: optimize API latency` |
+| `ralph` | ![execution](https://img.shields.io/badge/execution-green) | Persistence mode | `ralph: refactor auth` |
+| `ralphthon` | ![execution](https://img.shields.io/badge/execution-green) | Autonomous hackathon mode | `ralphthon: build MVP in 2 hours` |
+| `ulw` | ![execution](https://img.shields.io/badge/execution-green) | Maximum parallelism | `ulw fix all errors` |
+| `gh setup` | ![github](https://img.shields.io/badge/github-blue) | Configure GitHub integration | `gh setup` |
+| `gh triage` | ![github](https://img.shields.io/badge/github-blue) | GitHub issue/PR/CI triage | `gh triage` |
+| `gh review` | ![github](https://img.shields.io/badge/github-blue) | Interactive GitHub PR review | `gh review` |
+| `gh auto-review` | ![github](https://img.shields.io/badge/github-blue) | Automated code review via code-reviewer agent | `gh auto-review` |
+| `gh project` | ![github](https://img.shields.io/badge/github-blue) | Manage GitHub Projects (v2) boards | `gh project` |
+| `ado setup` | ![devops](https://img.shields.io/badge/devops-gray) | Configure Azure DevOps integration | `ado setup` |
+| `ado triage` | ![devops](https://img.shields.io/badge/devops-gray) | Azure DevOps work item triage | `ado triage` |
+| `ado review` | ![devops](https://img.shields.io/badge/devops-gray) | Interactive Azure DevOps PR review | `ado review` |
+| `ado auto-review` | ![devops](https://img.shields.io/badge/devops-gray) | Automated code review via code-reviewer agent | `ado auto-review` |
+| `ado sprint` | ![devops](https://img.shields.io/badge/devops-gray) | Sprint planning and iteration management | `ado sprint` |
+| `cancelomc`, `stopomc` | ![control](https://img.shields.io/badge/control-gray) | Stop active OMC modes | `stopomc` |
 
 **Notes:**
 
-- **ralph includes ultrawork**: when you activate ralph mode, it automatically includes ultrawork's parallel execution.
-- `swarm` compatibility alias has been removed; migrate existing prompts to `/team` syntax.
-- `plan this` / `plan the` keyword triggers were removed; use `ralplan` or explicit `/oh-my-copilot:omg-plan`.
-
-## Azure DevOps Integration
-
-oh-my-copilot supports Azure DevOps natively — auto-detection, work item management, PR operations, and triage workflows.
-
-### Auto-Detection
-
-When your git remote points to `dev.azure.com` or `*.visualstudio.com`, OMC automatically:
-- Detects the ADO platform on session start
-- Injects available `mcp__azure-devops__*` MCP tool context into agent prompts
-- Reads `.omg/config.json` for project-specific settings
-
-### Setup
-
-```bash
-/oh-my-copilot:omg-ado-setup
-```
-
-This configures your ADO connection — verifies `az` CLI auth, auto-detects org/project from git remote, and writes `.omg/config.json`:
-
-```json
-{
-  "version": 1,
-  "platform": "azure-devops",
-  "ado": {
-    "org": "my-org",
-    "project": "my-project",
-    "defaultWorkItemType": "User Story",
-    "areaPath": "MyProject\\Team Alpha",
-    "iterationPath": "MyProject\\Sprint 5"
-  }
-}
-```
-
-Cross-project support: when code and work items live in different ADO projects, add `workItemOrg` and `workItemProject` fields.
-
-### Triage
-
-```bash
-/oh-my-copilot:omg-ado-triage
-```
-
-Scans 5 ADO surfaces in parallel and produces a prioritized summary:
-- Untriaged work items
-- Your active work items
-- Open pull requests with review status
-- Pipeline build status
-- Security alerts
-
-Uses MCP tools when available, falls back to `az` CLI.
-
-### Agent Awareness
-
-Five agents have built-in ADO knowledge (planner, verifier, debugger, analyst, explore). They automatically use ADO MCP tools for:
-- Work item queries and CRUD
-- PR creation and review
-- Build log investigation
-- Cross-repo code search
-- Wiki documentation lookup
-
-### Provider API
-
-The `AzureDevOpsProvider` exposes programmatic access:
-
-| Method | Description |
-|--------|-------------|
-| `listWorkItems()` | WIQL queries with injection prevention |
-| `createWorkItem()` | Create with type, area/iteration paths, tags |
-| `addTag()` / `removeTag()` | Work item tag management |
-| `addComment()` | Add discussion comments |
-| `listPullRequests()` | List PRs by status |
-| `createPullRequest()` | Create PR with source/target branches |
-| `mergePullRequest()` | Complete a PR |
-
-All commands use `execFileSync` with WIQL escaping for security.
+- **Informational filtering**: Asking "what is ralph?" or "explain ultrawork" won't trigger execution — only actionable uses activate keywords.
 
 ---
 
-## Utilities
-
-### Provider Advisor (`omc ask`)
-
-Run local provider CLIs and save a markdown artifact under `.omg/artifacts/ask/`:
+## Documentation
 
-```bash
-omc ask copilot "review this migration plan"
-omc ask codex --prompt "identify architecture risks"
-omc ask gemini --prompt "propose UI polish ideas"
-omc ask copilot --agent-prompt executor --prompt "draft implementation steps"
-```
+- [Documentation Home](docs/index.md)
+- [Quick Start](docs/get-started/quickstart.md)
+- [Full Reference](docs/REFERENCE.md)
+- [Team Mode](docs/guides/team-mode.md)
+- [Azure DevOps Integration](docs/guides/azure-devops.md)
+- [GitHub Integration](docs/guides/github.md)
+- [Architecture Overview](docs/architecture/overview.md)
+- [Permission Architecture](docs/architecture/permissions.md)
 
-Canonical env vars:
+---
 
-- `OMC_ASK_ADVISOR_SCRIPT`
-- `OMC_ASK_ORIGINAL_TASK`
+## Requirements
 
-Phase-1 aliases `OMX_ASK_ADVISOR_SCRIPT` and `OMX_ASK_ORIGINAL_TASK` are accepted with deprecation warnings.
+- [Copilot CLI](https://github.com/github/copilot-cli)
 
-### Rate Limit Wait
+---
 
-Auto-resume Copilot CLI sessions when rate limits reset.
+## Optional enhancements
 
-```bash
-omc wait          # Check status, get guidance
-omc wait --start  # Enable auto-resume daemon
-omc wait --stop   # Disable daemon
-```
+### Platform & tmux
 
-**Requires:** tmux (for session detection)
+OMC features like `omc team` and rate-limit detection require **tmux**:
 
-### Monitoring & Analytics
+| Platform       | tmux provider                                          | Install                 |
+| -------------- | ------------------------------------------------------ | ----------------------- |
+| macOS          | [tmux](https://github.com/tmux/tmux)                   | `brew install tmux`     |
+| Ubuntu/Debian  | tmux                                                   | `sudo apt install tmux` |
+| Fedora         | tmux                                                   | `sudo dnf install tmux` |
+| Arch           | tmux                                                   | `sudo pacman -S tmux`   |
+| Windows        | [psmux](https://github.com/marlocarlo/psmux) (native)  | `winget install psmux`  |
+| Windows (WSL2) | tmux (inside WSL)                                      | `sudo apt install tmux` |
 
-Use the HUD for live observability and `omc` for cost/session reporting:
+> **Windows users:** [psmux](https://github.com/marlocarlo/psmux) provides a native `tmux` binary for Windows with 76 tmux-compatible commands. No WSL required.
 
-- HUD analytics preset: `/oh-my-copilot:hud setup` then set `"omcHud": { "preset": "analytics" }`
-- Cost reports: `omc cost daily|weekly|monthly`
-- Session history/backfill: `omc sessions`, `omc backfill`
-- Raw logs: `.omg/state/token-tracking.jsonl`, `.omg/state/agent-replay-*.jsonl`
+### Multi-AI Orchestration
 
-### Notification Tags (Teams/Telegram/Discord/Slack)
+OMC can orchestrate multiple AI CLI providers as tmux workers for cross-validation, design consistency, and parallel execution. All four major CLI tools are supported:
 
-You can configure who gets tagged when stop callbacks send session summaries.
+| Provider                                                      | Install                                | What it enables                                  |
+| ------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------ |
+| [Copilot CLI](https://github.com/github/copilot-cli)            | `npm install -g @github/copilot`                     | Core orchestration platform                      |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `npm install -g @anthropic-ai/claude-code` | Deep reasoning, architecture analysis            |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli)     | `npm install -g @google/gemini-cli`    | Design review, UI consistency (1M token context) |
+| [Codex CLI](https://github.com/openai/codex)                  | `npm install -g @openai/codex`         | Architecture validation, code review cross-check |
 
 ```bash
-# Set/replace tag list
-omc config-stop-callback teams --enable --webhook <url> --tag-list "John Doe:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
-omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
-omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"
-omc config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>"
-
-# Incremental updates
-omc config-stop-callback telegram --add-tag charlie
-omc config-stop-callback discord --remove-tag @here
-omc config-stop-callback discord --clear-tags
+omc team 2:claude "review auth architecture"
+omc team 2:codex "security analysis"
+omc team 2:gemini "UI consistency check"
+omc team 1:copilot "review existing tests"
 ```
-
-Tag behavior:
-
-- Teams: `DisplayName:AAD-Object-ID` pairs for @mentions in Adaptive Cards (e.g. `"John Doe:xxxxxxxx-..."`).
-- Telegram: `alice` becomes `@alice`
-- Discord: supports `@here`, `@everyone`, numeric user IDs, and `role:<id>`
-- Slack: supports `<@MEMBER_ID>`, `<!channel>`, `<!here>`, `<!everyone>`, `<!subteam^GROUP_ID>`
-- `file` callbacks ignore tag options
+Only Copilot CLI is required — the others are optional and add cross-provider validation.
 
 ---
 
-## Documentation
+## Star History
 
-- **[Full Reference](docs/REFERENCE.md)** - Complete feature documentation
-- **[CLI Reference](https://docs/REFERENCE.md/docs.html#cli-reference)** - All `omc` commands, flags, and tools
-- **[Notifications Guide](https://docs/REFERENCE.md/docs.html#notifications)** - Discord, Telegram, Slack, Teams, and webhook setup
-- **[Recommended Workflows](https://docs/REFERENCE.md/docs.html#workflows)** - Battle-tested skill chains for common tasks
-- **[Release Notes](https://docs/REFERENCE.md/docs.html#release-notes)** - What's new in each version
-- **[Website](https://docs/REFERENCE.md)** - Interactive guides and examples
-- **[Migration Guide](docs/MIGRATION.md)** - Upgrade from v2.x
-- **[Architecture](docs/ARCHITECTURE.md)** - How it works under the hood
-- **[Performance Monitoring](docs/PERFORMANCE-MONITORING.md)** - Agent tracking, debugging, and optimization
+<a href="https://www.star-history.com/?repos=RobinNorberg%2Foh-my-copilot&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=RobinNorberg/oh-my-copilot&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=RobinNorberg/oh-my-copilot&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=RobinNorberg/oh-my-copilot&type=date&legend=top-left" />
+ </picture>
+</a>
 
 ---
 
-## Requirements
-
-- [Copilot CLI](https://docs.github.com/copilot-cli) CLI
-
-### Platform & tmux
-
-OMC features like `omc team` and rate-limit detection require **tmux**:
-
-| Platform       | tmux provider                                            | Install                |
-| -------------- | -------------------------------------------------------- | ---------------------- |
-| macOS          | [tmux](https://github.com/tmux/tmux)                    | `brew install tmux`    |
-| Ubuntu/Debian  | tmux                                                     | `sudo apt install tmux`|
-| Fedora         | tmux                                                     | `sudo dnf install tmux`|
-| Arch           | tmux                                                     | `sudo pacman -S tmux`  |
-| Windows        | [psmux](https://github.com/marlocarlo/psmux) (native)   | `winget install psmux` |
-| Windows (WSL2) | tmux (inside WSL)                                        | `sudo apt install tmux`|
-
-> **Windows users:** [psmux](https://github.com/marlocarlo/psmux) provides a native `tmux` binary for Windows with 76 tmux-compatible commands. No WSL required.
-
-### Optional: Multi-AI Orchestration
-
-OMC can optionally orchestrate external AI providers for cross-validation and design consistency. These are **not required** — OMC works fully without them.
+<div align="center">
 
-| Provider                                                  | Install                             | What it enables                                  |
-| --------------------------------------------------------- | ----------------------------------- | ------------------------------------------------ |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | Design review, UI consistency (1M token context) |
-| [Codex CLI](https://github.com/openai/codex)              | `npm install -g @openai/codex`      | Architecture validation, code review cross-check |
+**Inspired by:** • [oh-my-claudecode](https://github.com/yeachan-heo/oh-my-claudecode), [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [Superpowers](https://github.com/obra/superpowers) • [get-shit-done](https://github.com/gsd-build/get-shit-done) • [Ouroboros](https://github.com/Q00/ouroboros) • [BMAD](https://github.com/bmad-code-org/BMAD-METHOD)
 
-**Cost:** 3 Pro plans (Copilot + Gemini + ChatGPT) cover everything for ~$60/month.
+</div>
 
 ---
 
-## License
+## 🤝 Contributing
 
-MIT
+Contributions welcome! Open an issue or PR on [GitHub](https://github.com/RobinNorberg/oh-my-copilot) to the dev branch.
 
 ---
 
-<div align="center">
-
-**Inspired by:** [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) • [copilot-hud](https://github.com/ryanjoachim/copilot-hud) • [Superpowers](https://github.com/obra/superpowers) • [everything-copilot-cli](https://github.com/affaan-m/everything-copilot-cli) • [Ouroboros](https://github.com/Q00/ouroboros)
-
-**Zero learning curve. Maximum power.**
+## License
 
-</div>
+MIT — see [LICENSE](LICENSE).
 
+---