omnilane 0.8.3 → 0.9.1

package/README.ko.md

@@ -21,105 +21,55 @@
 
 ---
 
-## v0.8.3 새 기능
-
-- **MCP 서버** — `omnilane mcp` 는 의존성 없는 stdio MCP 서버를 시작하여,
-  MCP 지원 호스트(Claude Code, Codex, Gemini CLI, Cursor, OpenCode 등)가
-  스킬 설치 없이 omnilane 을 발견하고 호출할 수 있습니다: 도구는 `route`,
-  `jobs_status`, `jobs_result`, `list_lanes`. `route` 는 읽기 전용 advise 가
-  기본값이며, work 모드는 명시적 workdir 이 필요합니다.
+## 👋 처음이신가요?
 
-## v0.8.2 새 기능
+이미 AI 코딩 어시스턴트——**Claude Code, Codex, Cursor, Gemini CLI** 같은——를 쓰고
+계시죠. 각각은 한 번에 하나의 AI 모델과 대화하며, "어떤 작업에 어떤 모델이 최선인가"는
+당신 몫으로 남습니다.
 
-- **`openrouter` vendor** — `curl`과 `OPENROUTER_API_KEY`만으로
-  OpenRouter API에 직접 디스패치합니다. 어떤 omnilane 설치에서도 수백 개의
-  호스팅 모델에 접근할 수 있으며 코딩 에이전트 CLI를 추가로 설치할 필요가
-  없습니다. advise/consult 전용(파일 편집 불가, work 모드는 명확한 오류로
-  안내)이며 모델 slug는 필수입니다. 예:
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`
-- **`opencode` vendor** — 멀티 프로바이더 집합 CLI OpenCode를 통한
-  헤드리스 디스패치(`opencode run`). advise 모드는 내장 읽기 전용 `plan`
-  에이전트를 사용하고 work 모드는 `--auto`를 사용합니다. 기본
-  `coding-overflow` 체인의 마지막 폴백으로 추가되었습니다.
-
-## v0.8.1 새 기능
-
-- **Claude Code 플러그인이 라우팅 리마인더를 자동 로드** — 플러그인에
-  `SessionStart` 훅(`hooks/hooks.json`)이 포함되어 세션 시작 시
-  (`startup|resume|clear`) 라우팅 리마인더를 자동 주입합니다.
-  `~/.claude/CLAUDE.md` 수정 없이 플러그인 설치만으로 적용됩니다.
-  다른 CLI는 기존대로 `install.sh` 지침 파일 방식을 사용합니다.
+**omnilane 이 대신 골라 줍니다.** 모든 작업을 그 일에 가장 강한(그리고 가장 저렴한) 모델로
+자동 라우팅합니다——어려운 코딩은 최고 코더에게, 간단한 확인은 빠르고 싼 모델에게, 긴 문서는
+큰 컨텍스트 모델에게——전부 이미 결제 중인 구독과 API 키로. 기본값 그대로 쓰거나, 작은 설정
+파일 하나만 손보면 됩니다. 새로 관리할 대상이 늘지 않고(기존 도구 뒤에서 동작),
+`./install.sh --uninstall` 로 깔끔히 제거됩니다.
 
-## v0.8.0 새 기능
+**[⬇ 60초 시작으로](#-60초-시작)**
 
-- **새 디스패치 벤더 2종** — `kimi`(Moonshot Kimi Code CLI)와
-  `qwen`(Alibaba Qwen Code CLI)이 통일 runner 계약으로 합류:
-  advise 는 읽기 전용, work 는 자동 승인, API 키 환경 변수를 제거해
-  CLI 자체 구독 로그인을 사용, 빈 출력은 명시적 실패.
-  `--vendor kimi|qwen` 으로 직접 지정할 수 있습니다.
-- **coding-overflow 폴백 체인** — 쿼터 안전 밸브가 grok → kimi → qwen
-  → `off` 순으로 폴백해 세 벤더 중 하나만 설치돼 있어도 동작합니다.
-  runner 는 페이크 바이너리로 계약 테스트 완료. 실제 모델 사용 보고를
-  환영합니다.
+## v0.9.1 새 기능
 
-## v0.7.1 새 기능
+- **수정**: `configure set` 이 더 이상 `routing.local.yaml` 의 수기 주석을
+  삭제하지 않습니다. 자체 스탬프 줄과 교체 대상 레인만 다시 씁니다.
 
-- **라우팅 테이블 갱신(2026-07 모델 데이터)** — hardest-coding 1순위를
-  GPT-5.6 Sol **max** 로 변경. Artificial Analysis Coding Agent Index v1.1 에서
-  Sol (max) 이 80점으로 현행 최고를 기록해, 기존 「xhigh 가 max 보다 낫다」
-  스냅샷을 대체합니다.
-- **Claude 백업 강화** — hardest-coding 과 hard-judgment 의 Claude Opus 4.8
-  백업을 **xhigh** 로 변경. 어려운 작업과 장시간 작업에 extra effort 를
-  권장하는 Anthropic 공식 가이드를 따릅니다.
+## v0.9.0 새 기능
 
-## v0.7.0 새 기능
+- **OpenAI 호환 direct-API 벤더 5개 추가** — `deepseek`, `zai` (GLM), `mistral`,
+  `groq`, `cerebras` 가 `openrouter` 처럼 CLI 없는 레인으로 추가(curl 과
+  `<VENDOR>_API_KEY` 만 필요). `lib/common.sh` 레지스트리에 한 줄로 추가되며,
+  모델 능력 비교는 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 참고.
+- **Fish 셸 자동완성** — `omnilane completion fish | source`.
 
-- **디스패치를 먼저 미리보기** — `--dry-run` 은 완전히 해석된 실행 계획(vendor,
-  모델, 모드, 타임아웃, 부작용 판정)을 출력하며 모델 호출도 작업 상태 생성도
-  하지 않습니다.
-- **버전 있는 JSON 자동화** — `--list`/`--explain`/`--validate` 와
-  `jobs list|status|result|stats` 에 `--json` 엔벨로프를 제공하고, 읽기 전용
-  `jobs wait`, `jobs audit`, 결정적 manifest 를 갖춘 오프라인
-  `omnilane release-audit` 게이트를 추가했습니다.
-- **로컬 작업을 끝까지 제어** — `jobs tail` 로 실시간 출력을 확인하고,
-  `jobs retry` 로 완료된 작업을 fail-closed 로 재실행하며,
-  `prune --older-than` 으로 오래된 작업을 정리합니다. `--help` 가 모든 명령을
-  다룹니다.
-- **설치와 자동완성을 안전하게** — `install.sh --check`/`--dry-run` 은 쓰기 없이
-  드리프트를 보고하고, `omnilane completion bash|zsh` 가 안전한 탭 완성을
-  제공하며, macOS 기본 Bash 3.2 크래시 5건을 수정했습니다.
-
-## v0.6.0 새 기능
-
-- **라우팅을 오프라인으로 설명하고 검증** — `--explain` 으로 각 폴백 후보를
-  확인하고 `--validate` 로 전체 유효 라우팅 테이블을 검사합니다. 공급자를
-  호출하거나 잡 상태를 만들지 않습니다.
-- **로컬 상태를 기계 판독 데이터로 관찰** — 제한된 `jobs.sh stats` 집계와
-  `omnilane doctor --json` 을 사용해 태스크나 결과 본문 노출 없이 자동화합니다.
-- **Live Board 에서 두 잡 비교** — 불러온 잡 하나를 메모리에만 존재하는 참조
-  스냅샷으로 고정하고 모델 경로와 공개 결과를 나란히 비교합니다.
-- **조용한 잠금 복구** — 소유자 파일이 확인과 읽기 사이에 사라져도 오해를 부르는
-  파일 없음 진단을 노출하지 않으며 fail-closed 동작을 유지합니다.
+## ⚡ 60초 시작
 
-## v0.5.1 새 기능
+**가장 빠른 방법——npm 으로 설치:**
 
-- **Git 저장소 밖에서 Codex work 사용** — 일반 디렉터리를 계속 지원하며
-  Omnilane 은 `git init` 을 요구하거나 자동 실행하지 않습니다.
-- **비 Git 멈춤을 안전하게 종료** — 전체 상한이 없으면 결정된 호출별 워치독을
-  process group 퓨즈로 사용하고, 명시한 timeout 우선순위와 종료 코드 의미는
-  그대로 유지합니다.
-- **표시 버전을 신뢰 가능하게 유지** — `VERSION` 이 `omnilane --version` 과 두
-  plugin manifest 를 통일하며 CI 가 변경 기록과 5개 언어 README 를 검사합니다.
+```bash
+npm i -g omnilane                                    # CLI 설치
+omnilane route hardest-coding "간헐적으로 실패하는 auth 토큰 갱신 테스트 수정"
+omnilane doctor                                      # 사용 가능한 AI CLI / 키 확인
+omnilane ui start                                    # 선택: 브라우저에서 잡을 실시간 확인
+```
 
-## ⚡ 60초 시작
+**또는 리포지토리 clone**(라우팅 테이블과 커스터마이즈용 스킬을 얻음):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
 ./install.sh          # CLI 감지, 스킬 연결, 당신의 언어로 대화
 omnilane route hardest-coding "간헐적으로 실패하는 auth 토큰 갱신 테스트 수정"
-omnilane ui start     # 선택: 브라우저에서 잡을 실시간 확인
 ```
 
+> 처음이신가요? 먼저 `omnilane doctor` 를 실행하세요. omnilane 이 지금 어떤 모델 CLI 와
+> API 키에 접근할 수 있는지 알려 주어, 실제로 무엇이 실행될지 파악할 수 있습니다.
+
 ## 🧭 동작 방식
 
 omnilane 은 **어떤** agentic CLI 든 메인 루프가 서브태스크를 레인으로 분류하고,
@@ -147,6 +97,8 @@ flowchart LR
   고정하며 폴백하지 않습니다.
 - **`skills/omnilane/SKILL.md`** — 네 하네스 공용 스킬: 자기 모델을 파악하고,
   자기 레인은 직접 수행, 나머지는 디스패치.
+- **`omnilane mcp`** — 같은 라우팅을 MCP stdio 서버로 제공.
+  스킬 대신 MCP 로 통합하는 호스트용.
 
 <div align="center">
 
@@ -294,10 +246,13 @@ MCP 지원 호스트가 스킬 설치나 라우팅 리마인더 없이 omnilane
 }
 ```
 
-서버는 `route`, `jobs_status`, `jobs_result`, `list_lanes` 를 제공합니다.
+서버는 `route` 와 함께 읽기 전용 조회 도구 `list_lanes`, `explain`, `validate`, `dry_run`, `jobs_list`, `jobs_status`, `jobs_result`, `jobs_stats`, `jobs_audit`, `doctor` 를 제공합니다.
 `route` 의 기본값은 읽기 전용 `advise` 모드이며, `work` 를 선택한 호출은
 명시적 `workdir` 을 함께 제공해야 합니다.
 
+실행에 필요한 것은 Node.js 뿐입니다(npm 패키지 없음). npm 을 선호하면
+`npm install -g omnilane` 으로 MCP 서버가 포함된 CLI 를 설치할 수 있습니다.
+
 ## ⚙️ 사용자 설정
 
 세 계층, 모두 선택 사항:
@@ -322,6 +277,8 @@ scripts/dispatch.sh --list     # 실효 테이블(폴백 해석 주석 포함)
 ```
 eval "$(omnilane completion bash)"             # 현재 Bash 에서 완성 활성화
 source <(omnilane completion zsh)               # 현재 Zsh 에서 완성 활성화
+omnilane completion fish | source              # 현재 Fish 에서 완성 활성화
+omnilane mcp                                   # MCP stdio 서버(Node.js 필요)
 omnilane release-audit [--target VERSION] [--json] # 오프라인 읽기 전용 릴리스 게이트
 omnilane ui start                              # 로컬 Live UI 를 시작하거나 재사용하고 URL 표시
 omnilane ui status                             # Live UI 실행 상태 표시
@@ -335,11 +292,15 @@ dispatch.sh [--json] --list [--json]
 dispatch.sh [--json] --explain LANE [--json]       # 후보별 라우팅 결정을 오프라인 설명
 dispatch.sh [--json] --validate [--json]           # 공급자 호출 없이 실효 라우팅 검사
 jobs.sh [--json] {list | status ID | result ID}    # JSON은 본문 없이 메타데이터만 반환
+jobs.sh [--json] list [--lane L] [--vendor V] [--status running|done]  # 목록 필터
 jobs.sh wait ID [--timeout N]                     # 작업 종료값, 124 시간 초과, 125 작업자 소실
-jobs.sh [--json] stats [--last N]                  # 로컬 성공률과 라우팅 집계
+jobs.sh cancel ID                                 # 실행 중 작업 중지: 그룹 SIGTERM 후 SIGKILL
+jobs.sh rm ID                                     # 완료/종료 작업 1건 삭제(실행 중이면 거부)
+jobs.sh [--json] stats [--last N] [--lane L] [--vendor V]  # 로컬 성공률과 라우팅 집계
 jobs.sh audit [--last N] [--json]                  # 읽기 전용 작업 무결성/개인정보 검사
 jobs.sh prune [--keep N] [--apply]                # 기본은 미리보기이며 완료된 작업만 정리
 configure.sh                                        # 대화형 레인 메뉴
+configure.sh set|get|unset|list|diff LANE [SPEC]    # routing.local.yaml 비대화식 편집/확인
 ```
 
 종료 코드: `2` 사용법 오류(잘못된 벤더 또는 지정 벤더가 레인에 없는 경우 포함),
@@ -405,12 +366,110 @@ CLI 를 사용할 수 없음, `5` 1라운드 성공 투표자 부족, `6` 2라
   process group을 정리합니다. Omnilane 은 `git init` 을 자동 실행하지 않으며 저장소
   생성을 요구하지도 않습니다.
 
+## 📜 릴리스 기록
+
+<details>
+<summary>이전 릴리스(v0.8.3 이하)</summary>
+
+## v0.8.3 새 기능
+
+- **MCP 서버** — `omnilane mcp` 는 의존성 없는 stdio MCP 서버를 시작하여,
+  MCP 지원 호스트(Claude Code, Codex, Gemini CLI, Cursor, OpenCode 등)가
+  스킬 설치 없이 omnilane 을 발견하고 호출할 수 있습니다: 도구는 `route`,
+  `jobs_status`, `jobs_result`, `list_lanes`. `route` 는 읽기 전용 advise 가
+  기본값이며, work 모드는 명시적 workdir 이 필요합니다.
+
+## v0.8.2 새 기능
+
+- **`openrouter` vendor** — `curl`과 `OPENROUTER_API_KEY`만으로
+  OpenRouter API에 직접 디스패치합니다. 어떤 omnilane 설치에서도 수백 개의
+  호스팅 모델에 접근할 수 있으며 코딩 에이전트 CLI를 추가로 설치할 필요가
+  없습니다. advise/consult 전용(파일 편집 불가, work 모드는 명확한 오류로
+  안내)이며 모델 slug는 필수입니다. 예:
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`
+- **`opencode` vendor** — 멀티 프로바이더 집합 CLI OpenCode를 통한
+  헤드리스 디스패치(`opencode run`). advise 모드는 내장 읽기 전용 `plan`
+  에이전트를 사용하고 work 모드는 `--auto`를 사용합니다. 기본
+  `coding-overflow` 체인의 마지막 폴백으로 추가되었습니다.
+
+## v0.8.1 새 기능
+
+- **Claude Code 플러그인이 라우팅 리마인더를 자동 로드** — 플러그인에
+  `SessionStart` 훅(`hooks/hooks.json`)이 포함되어 세션 시작 시
+  (`startup|resume|clear`) 라우팅 리마인더를 자동 주입합니다.
+  `~/.claude/CLAUDE.md` 수정 없이 플러그인 설치만으로 적용됩니다.
+  다른 CLI는 기존대로 `install.sh` 지침 파일 방식을 사용합니다.
+
+## v0.8.0 새 기능
+
+- **새 디스패치 벤더 2종** — `kimi`(Moonshot Kimi Code CLI)와
+  `qwen`(Alibaba Qwen Code CLI)이 통일 runner 계약으로 합류:
+  advise 는 읽기 전용, work 는 자동 승인, API 키 환경 변수를 제거해
+  CLI 자체 구독 로그인을 사용, 빈 출력은 명시적 실패.
+  `--vendor kimi|qwen` 으로 직접 지정할 수 있습니다.
+- **coding-overflow 폴백 체인** — 쿼터 안전 밸브가 grok → kimi → qwen
+  → `off` 순으로 폴백해 세 벤더 중 하나만 설치돼 있어도 동작합니다.
+  runner 는 페이크 바이너리로 계약 테스트 완료. 실제 모델 사용 보고를
+  환영합니다.
+
+## v0.7.1 새 기능
+
+- **라우팅 테이블 갱신(2026-07 모델 데이터)** — hardest-coding 1순위를
+  GPT-5.6 Sol **max** 로 변경. Artificial Analysis Coding Agent Index v1.1 에서
+  Sol (max) 이 80점으로 현행 최고를 기록해, 기존 「xhigh 가 max 보다 낫다」
+  스냅샷을 대체합니다.
+- **Claude 백업 강화** — hardest-coding 과 hard-judgment 의 Claude Opus 4.8
+  백업을 **xhigh** 로 변경. 어려운 작업과 장시간 작업에 extra effort 를
+  권장하는 Anthropic 공식 가이드를 따릅니다.
+
+## v0.7.0 새 기능
+
+- **디스패치를 먼저 미리보기** — `--dry-run` 은 완전히 해석된 실행 계획(vendor,
+  모델, 모드, 타임아웃, 부작용 판정)을 출력하며 모델 호출도 작업 상태 생성도
+  하지 않습니다.
+- **버전 있는 JSON 자동화** — `--list`/`--explain`/`--validate` 와
+  `jobs list|status|result|stats` 에 `--json` 엔벨로프를 제공하고, 읽기 전용
+  `jobs wait`, `jobs audit`, 결정적 manifest 를 갖춘 오프라인
+  `omnilane release-audit` 게이트를 추가했습니다.
+- **로컬 작업을 끝까지 제어** — `jobs tail` 로 실시간 출력을 확인하고,
+  `jobs retry` 로 완료된 작업을 fail-closed 로 재실행하며,
+  `prune --older-than` 으로 오래된 작업을 정리합니다. `--help` 가 모든 명령을
+  다룹니다.
+- **설치와 자동완성을 안전하게** — `install.sh --check`/`--dry-run` 은 쓰기 없이
+  드리프트를 보고하고, `omnilane completion bash|zsh` 가 안전한 탭 완성을
+  제공하며, macOS 기본 Bash 3.2 크래시 5건을 수정했습니다.
+
+## v0.6.0 새 기능
+
+- **라우팅을 오프라인으로 설명하고 검증** — `--explain` 으로 각 폴백 후보를
+  확인하고 `--validate` 로 전체 유효 라우팅 테이블을 검사합니다. 공급자를
+  호출하거나 잡 상태를 만들지 않습니다.
+- **로컬 상태를 기계 판독 데이터로 관찰** — 제한된 `jobs.sh stats` 집계와
+  `omnilane doctor --json` 을 사용해 태스크나 결과 본문 노출 없이 자동화합니다.
+- **Live Board 에서 두 잡 비교** — 불러온 잡 하나를 메모리에만 존재하는 참조
+  스냅샷으로 고정하고 모델 경로와 공개 결과를 나란히 비교합니다.
+- **조용한 잠금 복구** — 소유자 파일이 확인과 읽기 사이에 사라져도 오해를 부르는
+  파일 없음 진단을 노출하지 않으며 fail-closed 동작을 유지합니다.
+
+## v0.5.1 새 기능
+
+- **Git 저장소 밖에서 Codex work 사용** — 일반 디렉터리를 계속 지원하며
+  Omnilane 은 `git init` 을 요구하거나 자동 실행하지 않습니다.
+- **비 Git 멈춤을 안전하게 종료** — 전체 상한이 없으면 결정된 호출별 워치독을
+  process group 퓨즈로 사용하고, 명시한 timeout 우선순위와 종료 코드 의미는
+  그대로 유지합니다.
+- **표시 버전을 신뢰 가능하게 유지** — `VERSION` 이 `omnilane --version` 과 두
+  plugin manifest 를 통일하며 CI 가 변경 기록과 5개 언어 README 를 검사합니다.
+
+</details>
+
 ## 🌱 상태
 
-v0.8.3 는 8개의 디스패치 벤더를 갖춥니다——4개의 하네스 네이티브(codex,
+omnilane 은 13개의 디스패치 벤더를 갖춥니다——4개의 하네스 네이티브(codex,
 claude, grok, gemini), 3개의 집합/오버플로 CLI(kimi, qwen, opencode), 그리고
-CLI 가 필요 없는 `openrouter` 직접 API 벤더——모두 통일 runner 계약과 계약
-테스트를 갖추었고, Claude Code `SessionStart` 자동 리마인더도 포함합니다.
+CLI 가 필요 없는 OpenAI 호환 direct-API 벤더 6개(openrouter, deepseek, zai,
+mistral, groq, cerebras)——모두 통일 runner 계약과 계약 테스트를 갖추었고,
+Claude Code `SessionStart` 자동 리마인더와 MCP stdio 서버(`omnilane mcp`)도 포함합니다.
 kimi, qwen, opencode, openrouter 의 runner 는 페이크 바이너리로 계약 테스트를
 마쳤습니다. 실제 모델 사용 보고를 환영합니다. Grok/Antigravity 커맨드 셸
 동작은 CLI 버전에 따라 달라질 수 있습니다. issue 와 PR 환영합니다.

package/README.md

@@ -21,106 +21,57 @@ or any hosted model via OpenRouter — on the subscriptions you already pay for,
 
 ---
 
-## What's new in v0.8.3
-
-- **MCP server** — `omnilane mcp` starts a zero-dependency stdio MCP server,
-  so any MCP-capable host (Claude Code, Codex, Gemini CLI, Cursor, OpenCode…)
-  can discover and call omnilane without installing the skill: tools `route`,
-  `jobs_status`, `jobs_result`, and `list_lanes`. `route` defaults to
-  read-only advise mode; work mode requires an explicit workdir.
-
-## What's new in v0.8.2
-
-- **`openrouter` vendor** — dispatch straight to the OpenRouter API with
-  nothing but `curl` and an `OPENROUTER_API_KEY`: hundreds of hosted models
-  become reachable from any omnilane install, no coding-agent CLI required.
-  Advise/consult only (it cannot edit files; work mode fails with guidance)
-  and the model slug is mandatory, e.g.
-  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`.
-- **`opencode` vendor** — headless dispatch through the OpenCode
-  multi-provider aggregator CLI (`opencode run`). Advise mode pins OpenCode's
-  built-in read-only `plan` agent; work mode uses `--auto`. Joins the default
-  `coding-overflow` chain as its last fallback.
-
-## What's new in v0.8.1
-
-- **Claude Code plugin auto-loads the routing reminder** — the plugin now
-  ships a `SessionStart` hook (`hooks/hooks.json`) that injects the routing
-  reminder at session open (`startup|resume|clear`), so plugin installs get
-  the persistent reminder with no edit to `~/.claude/CLAUDE.md`. The
-  `install.sh` instruction-file reminder still covers the other CLIs.
+## 👋 New here?
 
-## What's new in v0.8.0
+You already drive an AI coding assistant — **Claude Code, Codex, Cursor, Gemini
+CLI**, and the like. Each one talks to a single AI model, and picking the best
+model for each task is left to you.
 
-- **Two new dispatch vendors** — `kimi` (Moonshot Kimi Code CLI) and `qwen`
-  (Alibaba Qwen Code CLI) join the vendor set with the uniform runner
-  contract: advise stays read-only, work auto-approves, API-key env is
-  stripped so the CLIs use their own subscription logins, and empty output
-  is a loud failure. Pin them with `--vendor kimi|qwen`.
-- **coding-overflow grows a chain** — the quota relief valve now falls back
-  grok → kimi → qwen before `off`, so it works with any one of the three
-  vendors installed. Runners are contract-tested against fake binaries;
-  real-model reports welcome.
+**omnilane picks for you.** For every piece of work it routes the task to the
+model that is best (and cheapest) for it — tough coding to a top coder, quick
+checks to a fast cheap model, long documents to a big-context model — all on the
+subscriptions and API keys you already pay for. Use the built-in defaults, or
+tweak one small file. Nothing new to babysit (it runs behind your existing tool),
+and `./install.sh --uninstall` removes it cleanly.
 
-## What's new in v0.7.1
+**[⬇ Jump to the 60-second start](#-60-second-start)**
 
-- **Routing refresh (2026-07 model data)** — hardest-coding now dispatches
-  GPT-5.6 Sol at **max** effort: Artificial Analysis Coding Agent Index v1.1
-  scores Sol (max) at 80, the current state of the art, retiring the older
-  xhigh-beats-max snapshot.
-- **Claude backups sharpened** — the Claude Opus 4.8 fallback on
-  hardest-coding and hard-judgment moves to **xhigh** effort, following
-  Anthropic's guidance to use extra effort for difficult tasks and
-  long-running work.
+## What's new in v0.9.1
 
-## What's new in v0.7.0
+- **Fix:** `configure set` no longer deletes hand-written comments from
+  `routing.local.yaml` — it rewrites only its own stamp header and the lane
+  being replaced.
 
-- **Preview any dispatch first** — `--dry-run` prints the fully resolved plan
-  (vendor, model, mode, timeouts, side-effect decision) with no provider call
-  and no job state.
-- **Automate with versioned JSON** — one `--json` envelope for `--list`,
-  `--explain`, `--validate`, and `jobs list|status|result|stats`, plus
-  read-only `jobs wait`, `jobs audit`, and an offline `omnilane release-audit`
-  gate with a deterministic manifest.
-- **Drive local jobs end to end** — `jobs tail` peeks at live output,
-  `jobs retry` re-dispatches a completed job fail-closed,
-  `prune --older-than` ages out old jobs, and `--help` covers every command.
-- **Install and complete safely** — `install.sh --check`/`--dry-run` report
-  drift without writing, `omnilane completion bash|zsh` ships safe tab
-  completion, and five macOS stock Bash 3.2 crashes are fixed.
+## What's new in v0.9.0
 
-## What's new in v0.6.0
+- **Five OpenAI-compatible direct-API vendors** — `deepseek`, `zai` (GLM),
+  `mistral`, `groq`, and `cerebras` join `openrouter` as CLI-free lanes (curl +
+  a `<VENDOR>_API_KEY`). A one-line `lib/common.sh` registry entry adds each;
+  see [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
+- **Fish shell completion** — `omnilane completion fish | source`.
 
-- **Explain and validate routes offline** — inspect every fallback candidate
-  with `--explain`, or lint the complete effective table with `--validate`,
-  without invoking a provider or creating job state.
-- **Inspect local health and outcomes** — bounded `jobs.sh stats` aggregates and
-  `omnilane doctor --json` make local automation observable without exposing
-  task or result bodies.
-- **Compare runs in Live Board** — pin one loaded job as a memory-only reference
-  and compare its model path and public result with the current selection.
-- **Keep lock recovery quiet** — transient owner-file read races no longer leak
-  misleading missing-file diagnostics.
+## ⚡ 60-second start
 
-## What's new in v0.5.1
+**The quick way — install from npm:**
 
-- **Use Codex work outside Git** — ordinary directories remain supported;
-  Omnilane never requires or runs `git init`.
-- **Stop non-Git hangs cleanly** — the resolved per-call watchdog becomes an
-  automatic process-group fuse when no whole-job timeout was configured, while
-  explicit timeout precedence and exit semantics remain intact.
-- **Trust the displayed version** — `VERSION` now drives `omnilane --version`
-  and both plugin manifests, with CI checking the changelog and all five READMEs.
+```bash
+npm i -g omnilane                                    # install the CLI
+omnilane route hardest-coding "fix the flaky auth token refresh"
+omnilane doctor                                      # see which AI CLIs / keys you have
+omnilane ui start                                    # optional: watch jobs live in your browser
+```
 
-## ⚡ 60-second start
+**Or clone the repo** (gets you the routing table and skill to customise):
 
 ```bash
 git clone https://github.com/Seraphim0916/omnilane && cd omnilane
 ./install.sh          # finds your CLIs, links the skill, speaks your language
 omnilane route hardest-coding "fix the flaky auth token refresh"
-omnilane ui start     # optional: watch jobs live in your browser
 ```
 
+> New to this? Run `omnilane doctor` first — it tells you which model CLIs and
+> API keys omnilane can already reach, so you know what will actually run.
+
 ## 🧭 How it works
 
 omnilane lets the main loop of **any** agentic CLI classify subtasks into
@@ -149,6 +100,8 @@ flowchart LR
   vendor without fallback.
 - **`skills/omnilane/SKILL.md`** — a single skill every harness can load:
   identify your own model, self-execute your lane, dispatch the rest.
+- **`omnilane mcp`** — the same routing surface as an MCP stdio server,
+  for hosts that integrate via MCP instead of skills.
 
 <div align="center">
 
@@ -301,10 +254,15 @@ adding a routing reminder. Configure the host to launch the installed CLI:
 }
 ```
 
-The server exposes `route`, `jobs_status`, `jobs_result`, and `list_lanes`.
-`route` defaults to read-only `advise` mode. Calls that select `work` must also
+The server exposes `route` plus read-only introspection: `list_lanes`,
+`explain`, `validate`, `dry_run`, `jobs_list`, `jobs_status`, `jobs_result`,
+`jobs_stats`, `jobs_audit`, and `doctor`. `route` defaults to read-only `advise` mode. Calls that select `work` must also
 provide an explicit `workdir`.
 
+Node.js is the only runtime requirement (no npm packages). If you prefer
+npm, `npm install -g omnilane` installs the CLI with the MCP server
+included.
+
 ## ⚙️ Configure
 
 Three layers, all optional:
@@ -314,6 +272,9 @@ Three layers, all optional:
    future models), and writes the result to `~/.omnilane/routing.local.yaml`.
    It intentionally skips the multi-vendor `consult` lane; edit that one by
    hand if needed. `install.sh` offers to run the menu at the end of a normal install.
+   For scripting, `configure set|get|unset|list|diff LANE [SPEC]` edits or inspects the same file
+   without a tty — `set` validates the lane and rejects an unsafe or structurally
+   invalid spec, rolling back on failure.
 2. **`~/.omnilane/routing.local.yaml`** — hand-edited overrides, same format
    as `routing.yaml`; local lines win. See `routing.local.yaml.example`.
 3. **`~/.omnilane/local.sh`** — per-machine binaries, proxies, auth wrappers;
@@ -332,6 +293,8 @@ omnilane list | route … | jobs … | configure   # global wrapper, works anywh
                                                # (install.sh links it into ~/.local/bin)
 eval "$(omnilane completion bash)"             # enable Bash completion for this shell
 source <(omnilane completion zsh)               # enable Zsh completion for this shell
+omnilane completion fish | source              # enable Fish completion for this shell
+omnilane mcp                                   # MCP stdio server (needs Node.js)
 omnilane release-audit [--target VERSION] [--json] # offline, read-only release gate
 omnilane ui start                              # start/reuse the local Live UI; print its URL
 omnilane ui status                             # report whether the Live UI is running
@@ -345,11 +308,15 @@ dispatch.sh [--json] --list [--json]
 dispatch.sh [--json] --explain LANE [--json]       # offline candidate-by-candidate decision trace
 dispatch.sh [--json] --validate [--json]           # lint effective routing; no provider calls
 jobs.sh [--json] {list | status ID | result ID}    # JSON result reports metadata, never bodies
+jobs.sh [--json] list [--lane L] [--vendor V] [--status running|done]  # filter the listing
 jobs.sh wait ID [--timeout N]                     # job exit; 124 timeout; 125 dead worker
-jobs.sh [--json] stats [--last N]                  # local success and routing aggregates
+jobs.sh cancel ID                                 # stop a running job: group SIGTERM, then SIGKILL
+jobs.sh rm ID                                     # delete one finished/dead job (refuses a running job)
+jobs.sh [--json] stats [--last N] [--lane L] [--vendor V]  # local success and routing aggregates
 jobs.sh audit [--last N] [--json]                  # read-only job integrity/privacy check
 jobs.sh prune [--keep N] [--apply]                # preview by default; completed jobs only
 configure.sh                                        # interactive lane menu
+configure.sh set|get|unset|list|diff LANE [SPEC]    # script/inspect routing.local.yaml, no tty
 ```
 
 **Big decisions can get a panel, not a person.** The `arbitrate` lane ships
@@ -437,13 +404,119 @@ configurator and `routing.local.yaml` exist so you can disagree.
   a Git worktree, so the automatic fuse above bounds that case and cleans the
   supervised process group. Omnilane neither initializes nor requires a repository.
 
+## 📜 Release history
+
+<details>
+<summary>Older releases (v0.8.3 and earlier)</summary>
+
+## What's new in v0.8.3
+
+- **MCP server** — `omnilane mcp` starts a zero-dependency stdio MCP server,
+  so any MCP-capable host (Claude Code, Codex, Gemini CLI, Cursor, OpenCode…)
+  can discover and call omnilane without installing the skill: tools `route`,
+  `jobs_status`, `jobs_result`, and `list_lanes`. `route` defaults to
+  read-only advise mode; work mode requires an explicit workdir.
+
+## What's new in v0.8.2
+
+- **`openrouter` vendor** — dispatch straight to the OpenRouter API with
+  nothing but `curl` and an `OPENROUTER_API_KEY`: hundreds of hosted models
+  become reachable from any omnilane install, no coding-agent CLI required.
+  Advise/consult only (it cannot edit files; work mode fails with guidance)
+  and the model slug is mandatory, e.g.
+  `dispatch.sh --vendor openrouter --model anthropic/claude-sonnet-5 consult "..."`.
+- **`deepseek`, `zai`, `mistral`, `groq`, `cerebras` vendors** — the same
+  CLI-free direct-API path as `openrouter`, for OpenAI-compatible providers:
+  DeepSeek, Z.ai GLM, Mistral, Groq, and Cerebras. Each needs only `curl` and
+  its `<VENDOR>_API_KEY`; advise/consult only. A one-line `lib/common.sh`
+  registry entry defines each endpoint, key env, and default model. See
+  [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
+- **`opencode` vendor** — headless dispatch through the OpenCode
+  multi-provider aggregator CLI (`opencode run`). Advise mode pins OpenCode's
+  built-in read-only `plan` agent; work mode uses `--auto`. Joins the default
+  `coding-overflow` chain as its last fallback.
+
+## What's new in v0.8.1
+
+- **Claude Code plugin auto-loads the routing reminder** — the plugin now
+  ships a `SessionStart` hook (`hooks/hooks.json`) that injects the routing
+  reminder at session open (`startup|resume|clear`), so plugin installs get
+  the persistent reminder with no edit to `~/.claude/CLAUDE.md`. The
+  `install.sh` instruction-file reminder still covers the other CLIs.
+
+## What's new in v0.8.0
+
+- **Two new dispatch vendors** — `kimi` (Moonshot Kimi Code CLI) and `qwen`
+  (Alibaba Qwen Code CLI) join the vendor set with the uniform runner
+  contract: advise stays read-only, work auto-approves, API-key env is
+  stripped so the CLIs use their own subscription logins, and empty output
+  is a loud failure. Pin them with `--vendor kimi|qwen`.
+- **coding-overflow grows a chain** — the quota relief valve now falls back
+  grok → kimi → qwen before `off`, so it works with any one of the three
+  vendors installed. Runners are contract-tested against fake binaries;
+  real-model reports welcome.
+
+## What's new in v0.7.1
+
+- **Routing refresh (2026-07 model data)** — hardest-coding now dispatches
+  GPT-5.6 Sol at **max** effort: Artificial Analysis Coding Agent Index v1.1
+  scores Sol (max) at 80, the current state of the art, retiring the older
+  xhigh-beats-max snapshot.
+- **Claude backups sharpened** — the Claude Opus 4.8 fallback on
+  hardest-coding and hard-judgment moves to **xhigh** effort, following
+  Anthropic's guidance to use extra effort for difficult tasks and
+  long-running work.
+
+## What's new in v0.7.0
+
+- **Preview any dispatch first** — `--dry-run` prints the fully resolved plan
+  (vendor, model, mode, timeouts, side-effect decision) with no provider call
+  and no job state.
+- **Automate with versioned JSON** — one `--json` envelope for `--list`,
+  `--explain`, `--validate`, and `jobs list|status|result|stats`, plus
+  read-only `jobs wait`, `jobs audit`, and an offline `omnilane release-audit`
+  gate with a deterministic manifest.
+- **Drive local jobs end to end** — `jobs tail` peeks at live output,
+  `jobs retry` re-dispatches a completed job fail-closed,
+  `prune --older-than` ages out old jobs, and `--help` covers every command.
+- **Install and complete safely** — `install.sh --check`/`--dry-run` report
+  drift without writing, `omnilane completion bash|zsh` ships safe tab
+  completion, and five macOS stock Bash 3.2 crashes are fixed.
+
+## What's new in v0.6.0
+
+- **Explain and validate routes offline** — inspect every fallback candidate
+  with `--explain`, or lint the complete effective table with `--validate`,
+  without invoking a provider or creating job state.
+- **Inspect local health and outcomes** — bounded `jobs.sh stats` aggregates and
+  `omnilane doctor --json` make local automation observable without exposing
+  task or result bodies.
+- **Compare runs in Live Board** — pin one loaded job as a memory-only reference
+  and compare its model path and public result with the current selection.
+- **Keep lock recovery quiet** — transient owner-file read races no longer leak
+  misleading missing-file diagnostics.
+
+## What's new in v0.5.1
+
+- **Use Codex work outside Git** — ordinary directories remain supported;
+  Omnilane never requires or runs `git init`.
+- **Stop non-Git hangs cleanly** — the resolved per-call watchdog becomes an
+  automatic process-group fuse when no whole-job timeout was configured, while
+  explicit timeout precedence and exit semantics remain intact.
+- **Trust the displayed version** — `VERSION` now drives `omnilane --version`
+  and both plugin manifests, with CI checking the changelog and all five READMEs.
+
+</details>
+
 ## 🌱 Status
 
-v0.8.3 spans eight dispatch vendors — four harness natives (codex, claude,
-grok, gemini), three aggregator/overflow CLIs (kimi, qwen, opencode), and the
-CLI-free `openrouter` direct-API vendor — on the uniform runner contract with
-contract tests, plus the Claude Code `SessionStart` auto-reminder. kimi, qwen,
-opencode, and openrouter runners are contract-tested against fake binaries;
+omnilane now spans thirteen dispatch vendors — four harness natives (codex,
+claude, grok, gemini), three aggregator/overflow CLIs (kimi, qwen, opencode),
+and six CLI-free OpenAI-compatible direct-API vendors (openrouter, deepseek,
+zai, mistral, groq, cerebras) — on the uniform runner contract with
+contract tests, plus the Claude Code `SessionStart`
+auto-reminder and an MCP stdio server surface (`omnilane mcp`). The direct-API
+and aggregator runners are contract-tested against fake binaries;
 real-model reports welcome. Grok/Antigravity command-shell behavior may still
 vary across CLI versions. Issues and PRs welcome.