@ngockhoale/ukit 2.1.5 → 2.2.1

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to UKit are documented here.
 
+## 2.2.1 - 2026-08-22
+
+UKit gains a fourth runtime and loses one. omp (Oh My Pi) reaches full parity with the Claude Code workspace — same agents, same skills, same hooks, same `/ukit:*` commands — and the Antigravity adapter, unused and unmaintained, is gone. The parity is deliberate rather than incidental: the port reuses the existing `.claude/` assets wherever omp's discovery can already reach them, so there is one source of truth per capability, not two that drift.
+
+### Added
+
+- **omp (Oh My Pi) adapter — `ukit install --tools=omp`** (alias `--tools=oh-my-pi`). Installs 11 files: `.omp/AGENTS.md` (a thin `@../AGENTS.md` import rather than a copy, so the shared instructions have exactly one home), `.omp/RULES.md` (sticky hard rules), `.omp/config.yml`, `.omp/README.md`, `.omp/hooks/pre/ukit-bridge.js`, and the six agents under `.omp/agents/`. **No symlinks are created.** omp's discovery providers already rank its `claude` provider above nothing at all for skills and commands, so `.claude/skills/` and `.claude/commands/` are read directly — an `.omp/skills` symlink would shadow the canonical tree for no benefit. `.omp/agents/` must be real files because omp explicitly skips `.claude/agents/*.md`.
+- **All six shared agents ported to omp's task-agent contract**: `bug-debugger`, `code-reviewer`, `feature-implementer`, `handoff-planner`, `ukit-small-task-maintainer`, `ukit-vision-analyst`. The differences between each agent's Claude Code and omp form — and why each one is or is not a faithful port — are recorded in [`docs/research/2026-08-22_omp-agent-parity.md`](docs/research/2026-08-22_omp-agent-parity.md).
+- **UNIC model names survive the port.** `.omp/config.yml` ships `modelRoles` with all four lanes intact: `lite: unic-lite`, `code: unic-code`, `smart: unic-smart`, `vision: unic-vision`. The vision lane stays a capability lane, not a fourth cost tier.
+- **Hook bridge — one source of truth, two runtimes.** `.omp/hooks/pre/ukit-bridge.js` is an omp hook factory (`export default function hook(pi)`) that translates omp's events into the Claude Code hook JSON shape and then executes the **existing** `.claude/hooks/*.sh` scripts. The 20 shell hooks are not duplicated, forked, or rewritten for omp; a fix to one fixes both runtimes.
+- **Auto-compact parity.** `compact.agentContext.targets` gains an `omp` entry using `mode: 'precompact-reinject'` — the same strategy as `claude`, not Codex's `soft-handoff`. omp exposes real pre-compaction hook events, so there is nothing to work around with a state file.
+- **`agent-code-reviewer` manifest item.** `templates/.claude/agents/code-reviewer.md` had shipped as a template with no manifest item since it was introduced, and `autoDiscoverTemplates: false` meant it was therefore **silently never installed** — UKit was installing five of its six Claude agents. Both the handoff Phase 4 reviewer and the Post-Edit Sidecar Review added in 2.1.5 instruct the model to spawn an agent that was not present in any installed project. Found by the omp parity work, because the new adapter would otherwise have shipped a strictly better agent set than the one it was porting from.
+
+### Changed
+
+- **`/ukit:*` commands are phrased for whichever runtime is reading them.** The command bodies no longer assume Claude Code's spawn mechanics; each names its model tier and its delegation step in runtime-neutral terms, so the same file drives the same pipeline under Claude Code and under omp.
+- **`ukit status` reports `Oh My Pi (omp)`** and checks `.omp/config.yml`; the Antigravity row is gone.
+- **`.omp/` is TCC-protected** (`applyPlan.js`) and **git-ignored** by the managed `.gitignore` block, alongside `.claude/` and `.codex/`.
+
+### Removed
+
+- **The Antigravity adapter.** `templates/.antigravity/`, `templates/adapter-presets/antigravity/`, the five `multi-antigravity-*` manifest items, its entry in `src/cli/adapters.js`, and every user-facing mention — in `README.md`, `QUICK_START.md`, `docs/PROJECT.md`, and in the installed workspace itself: `AGENTS.md`, `.codex/README.md` and the four `/ukit:handoff-*` command files all named Antigravity as a tool you could use. `--tools=antigravity` now fails fast with `Antigravity has been removed as a UKit adapter.` plus the list of adapters that do exist, rather than silently installing nothing.
+- **Legacy cleanup is retained, not removed.** `ukit uninstall` still cleans `.antigravity/`, and `.antigravity/` keeps its TCC protection, because a stale pre-2.2.0 install still has the directory. Install-time pruning now covers it too: `.antigravity/` joined `AUTO_PRUNE_OBSOLETE_PREFIXES`, so a re-install removes the stale symlinks a pre-2.2.0 install left behind. Without it those links would dangle forever — pruning is the only pass that ever revisits them, and removing the adapter took them out of the manifest that uninstall reads. Only paths UKit itself recorded in `install.json` are considered, and a path the user has replaced with a real directory is skipped with a warning instead of being silently left behind.
+
+### Fixed
+
+- **Deselecting omp no longer orphans its agents.** `OPTIONAL_ADAPTERS`' `managedPaths` listed `.omp/agents` as a single entry, copying the shape of Codex's `.codex/agents`. Codex's is a symlink; omp's is a real directory of six real files. `removeFileOrLinkOnly` refuses real directories, so re-running `ukit install` without `omp` and confirming removal deleted nothing — while the metadata pass still dropped all six from `install.json`, leaving them on disk and untracked forever. The six paths are now listed individually, matching `uninstall.js`'s own list. Full `ukit uninstall` was never affected.
+- **The `--tools=antigravity` regression test was passing vacuously.** It asserted on a directory the install pipeline had never been pointed at, so the "no partial write" half would have held even if the error path did write. It now runs the real `bin/ukit`, and checks the exit code, the stderr text, the absence of a stack frame, and that not even the always-on `.claude/` adapter was written.
+
+**Known gap:** omp was not installed on the machine this release was built on. Every omp assertion in the test suite is against the generated `.omp/` tree and the bridge module's shape — the packed-tarball test confirms `templates/.omp/**` actually publishes, but nothing here observes omp's runtime behaviour. The three open verification items (does omp emit `session_start` on a post-compact continuation; omp's real base-URL key; omp's real auto-compact-window key) are recorded in `docs/AI_HANDOFF/tasks/TASK-008.md`.
+
 ## 2.1.5 - 2026-08-19
 
 `local-build` was the one execution contract in the daily (non-handoff) flow that let the executor claim done off write evidence alone — and it is also the busiest lane a weaker `unic-code` backend hits. This closes that gap and adds a non-blocking second opinion, without adding wait time to the main task.

package/README.md

@@ -1,6 +1,6 @@
 # UKit
 
-UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, Antigravity, OpenAI Codex, and OpenCode from the same repo setup.
+UKit installs a project-local AI workspace (`.claude/`, adapters, docs, and index helpers) so your team can work with Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi) from the same repo setup.
 
 ## Highest-Priority Team Rule
 
@@ -57,10 +57,13 @@ If maintainers roll out a newer CLI build, the in-project workflow still stays t
 - `AGENTS.md` — shared instructions for AGENTS-compatible tools
 
 **Adapters**
-- `.antigravity/skills/` → symlink to `.claude/skills/`
-- `.antigravity/rules/` — Antigravity rules
 - `.codex/settings.json` + `.codex/settings.local.json` — Codex config
 - `opencode.json` — OpenCode project config with UKit-safe guardrails
+- `.omp/AGENTS.md` — thin `@../AGENTS.md` import so omp reads the shared instructions
+- `.omp/RULES.md` — sticky hard rules for omp sessions
+- `.omp/config.yml` — omp model roles, tool approval, and bash patterns
+- `.omp/agents/` — the six shared agents in omp's task-agent format
+- `.omp/hooks/pre/ukit-bridge.js` — bridges omp events onto the existing `.claude/hooks/*.sh`
 
 **Project support files**
 - `.claude/ukit/.ukit/` — installer manifests, metadata, backups
@@ -192,8 +195,8 @@ For deeper index development, repo-level scripts are available:
 | Tool | Instructions | Skills | Config |
 |------|-------------|--------|--------|
 | Claude Code | `CLAUDE.md` | `.claude/skills/` (canonical) | `.claude/settings.json` |
-| Antigravity | `AGENTS.md` | `.antigravity/skills/` (symlink) | `.antigravity/rules/`, `.antigravity/README.md` |
 | OpenAI Codex | `AGENTS.md` | `.claude/skills/` (referenced) | `.codex/settings.json`, `.codex/settings.local.json`, `.codex/README.md` |
 | OpenCode | `AGENTS.md` | `.claude/skills/` (native Claude-compatible support) | `opencode.json` |
+| omp (Oh My Pi) | `.omp/AGENTS.md` (imports `AGENTS.md`) | `.claude/skills/` (read via omp's claude provider — no symlink) | `.omp/config.yml`, `.omp/RULES.md`, `.omp/README.md` |
 
 All supported tools share the same SKILL.md ecosystem so the workspace is authored once and reused everywhere.

package/manifests/platform.full.yaml

@@ -830,6 +830,20 @@ items:
     packs:
       - core
 
+  # The .omp/ mirror of this agent has always been installed; the .claude/ original was
+  # shipped as a template with no manifest item, so autoDiscoverTemplates:false meant it
+  # was silently never installed. Both handoff Phase 4 and the sidecar diff review need it.
+  - id: agent-code-reviewer
+    type: agent
+    sourceTemplate: .claude/agents/code-reviewer.md
+    targetPath: .claude/agents/code-reviewer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
   - id: agent-ukit-small-task-maintainer
     type: agent
     sourceTemplate: .claude/agents/ukit-small-task-maintainer.md
@@ -1517,62 +1531,137 @@ items:
 
   # ═══════════════════════════════════════════════════════════════
   # Multi-tool Adapters
-  # Symlink .claude/skills/ into Antigravity discovery paths.
   # Config files generated from templates.
   # ═══════════════════════════════════════════════════════════════
 
-  # --- Google Antigravity ---
+  # --- omp (Oh My Pi) ---
+  # No `type: link` items on purpose (PLAN.md §3 D10): omp's `claude` discovery provider
+  # already reads `.claude/skills` and `.claude/commands`, so a native-priority duplicate
+  # under `.omp/` would buy nothing. `.omp/agents/` must be real files because omp skips
+  # `.claude/agents/*.md` outright (TASK_AGENT_CONFIG_SOURCE = ".omp").
+  # `autoDiscoverTemplates: false` means a template file without an item here is silently
+  # never installed — every file under `templates/.omp/` needs exactly one entry below.
 
-  - id: multi-antigravity-skills-link
-    type: link
-    sourceTemplate: .claude/skills
-    targetPath: .antigravity/skills
+  - id: multi-omp-agents-md
+    type: config
+    sourceTemplate: .omp/AGENTS.md
+    targetPath: .omp/AGENTS.md
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-ukit-link
-    type: link
-    sourceTemplate: .claude/ukit
-    targetPath: .antigravity/ukit
+  - id: multi-omp-rules
+    type: config
+    sourceTemplate: .omp/RULES.md
+    targetPath: .omp/RULES.md
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-agents-link
-    type: link
-    sourceTemplate: .claude/agents
-    targetPath: .antigravity/agents
+  - id: multi-omp-config
+    type: config
+    sourceTemplate: .omp/config.yml
+    targetPath: .omp/config.yml
     requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-rules
+  - id: multi-omp-readme
     type: config
-    sourceTemplate: adapter-presets/antigravity/rules.md
-    targetPath: .antigravity/rules/rules.md
+    sourceTemplate: .omp/README.md
+    targetPath: .omp/README.md
     requires: []
     mergeStrategy: overwrite_with_backup
     variables:
       - project.name
+      - project.stack
       - runtime.packageManager
     enabledByDefault: true
     packs:
       - core
 
-  - id: multi-antigravity-readme
+  - id: multi-omp-hook-bridge
     type: config
-    sourceTemplate: adapter-presets/antigravity/README.md
-    targetPath: .antigravity/README.md
+    sourceTemplate: .omp/hooks/pre/ukit-bridge.js
+    targetPath: .omp/hooks/pre/ukit-bridge.js
     requires: []
     mergeStrategy: overwrite_with_backup
-    variables:
-      - project.name
-      - project.stack
-      - runtime.packageManager
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-bug-debugger
+    type: config
+    sourceTemplate: .omp/agents/bug-debugger.md
+    targetPath: .omp/agents/bug-debugger.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-code-reviewer
+    type: config
+    sourceTemplate: .omp/agents/code-reviewer.md
+    targetPath: .omp/agents/code-reviewer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-feature-implementer
+    type: config
+    sourceTemplate: .omp/agents/feature-implementer.md
+    targetPath: .omp/agents/feature-implementer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-handoff-planner
+    type: config
+    sourceTemplate: .omp/agents/handoff-planner.md
+    targetPath: .omp/agents/handoff-planner.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-ukit-small-task-maintainer
+    type: config
+    sourceTemplate: .omp/agents/ukit-small-task-maintainer.md
+    targetPath: .omp/agents/ukit-small-task-maintainer.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
+    enabledByDefault: true
+    packs:
+      - core
+
+  - id: multi-omp-agent-ukit-vision-analyst
+    type: config
+    sourceTemplate: .omp/agents/ukit-vision-analyst.md
+    targetPath: .omp/agents/ukit-vision-analyst.md
+    requires: []
+    mergeStrategy: overwrite_with_backup
+    variables: []
     enabledByDefault: true
     packs:
       - core

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "2.1.5",
-  "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
+  "version": "2.2.1",
+  "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex, OpenCode, and omp (Oh My Pi).",
   "license": "MIT",
   "type": "module",
   "keywords": [
     "ukit",
     "claude",
     "codex",
-    "antigravity",
     "claude-code",
     "opencode",
+    "omp",
+    "oh-my-pi",
     "skills",
     "agents",
     "ai",

package/src/cli/adapters.js

@@ -1,22 +1,4 @@
 export const OPTIONAL_ADAPTERS = [
-  {
-    key: 'antigravity',
-    label: 'Antigravity',
-    itemIds: [
-      'multi-antigravity-skills-link',
-      'multi-antigravity-ukit-link',
-      'multi-antigravity-rules',
-      'multi-antigravity-readme',
-      'multi-antigravity-agents-link',
-    ],
-    managedPaths: [
-      '.antigravity/skills',
-      '.antigravity/ukit',
-      '.antigravity/rules/rules.md',
-      '.antigravity/README.md',
-      '.antigravity/agents',
-    ],
-  },
   {
     key: 'codex',
     label: 'OpenAI Codex',
@@ -47,6 +29,42 @@ export const OPTIONAL_ADAPTERS = [
       'opencode.json',
     ],
   },
+  {
+    key: 'omp',
+    label: 'Oh My Pi (omp)',
+    itemIds: [
+      'multi-omp-agents-md',
+      'multi-omp-rules',
+      'multi-omp-config',
+      'multi-omp-readme',
+      'multi-omp-hook-bridge',
+      'multi-omp-agent-bug-debugger',
+      'multi-omp-agent-code-reviewer',
+      'multi-omp-agent-feature-implementer',
+      'multi-omp-agent-handoff-planner',
+      'multi-omp-agent-ukit-small-task-maintainer',
+      'multi-omp-agent-ukit-vision-analyst',
+    ],
+    managedPaths: [
+      '.omp/AGENTS.md',
+      '.omp/RULES.md',
+      '.omp/config.yml',
+      '.omp/README.md',
+      '.omp/hooks/pre/ukit-bridge.js',
+      // Listed file-by-file, unlike Codex's single '.codex/agents' entry. Codex's is a
+      // symlink; omp's is a real directory of real files (manifest: omp skips .claude/agents,
+      // so these must be real). Deselect calls removeFileOrLinkOnly, which refuses real
+      // directories — a single '.omp/agents' entry would drop all six from install.json
+      // while leaving them on disk, orphaned and no longer tracked. Keep in sync with
+      // buildFallbackPaths in src/core/uninstall.js.
+      '.omp/agents/bug-debugger.md',
+      '.omp/agents/code-reviewer.md',
+      '.omp/agents/feature-implementer.md',
+      '.omp/agents/handoff-planner.md',
+      '.omp/agents/ukit-small-task-maintainer.md',
+      '.omp/agents/ukit-vision-analyst.md',
+    ],
+  },
 ];
 
 export const ADAPTER_BY_KEY = new Map(OPTIONAL_ADAPTERS.map((adapter) => [adapter.key, adapter]));
@@ -55,14 +73,15 @@ export const DEFAULT_OPTIONAL_TOOL_KEYS = OPTIONAL_ADAPTERS.map((adapter) => ada
 export const TOOL_ALIASES = new Map([
   ['claude', 'claude'],
   ['claude-code', 'claude'],
-  ['antigravity', 'antigravity'],
   ['codex', 'codex'],
   ['openai-codex', 'codex'],
   ['opencode', 'opencode'],
   ['open-code', 'opencode'],
+  ['omp', 'omp'],
+  ['oh-my-pi', 'omp'],
 ]);
 
-export const TOOLS_FLAG_HELP = 'all|none|claude,antigravity,codex,opencode';
+export const TOOLS_FLAG_HELP = 'all|none|claude,codex,opencode,omp';
 
 export function parseToolsArg(argv = []) {
   let toolsArg = null;
@@ -111,7 +130,14 @@ export function resolveOptionalToolKeys(toolsArg) {
     const token = rawToken.trim();
     if (!token) continue;
 
-    const normalizedTool = TOOL_ALIASES.get(token.toLowerCase()) ?? null;
+    const normalizedToken = token.toLowerCase();
+    if (normalizedToken === 'antigravity' || normalizedToken === 'google-antigravity') {
+      throw new Error(
+        `Antigravity has been removed as a UKit adapter. Allowed: ${TOOLS_FLAG_HELP}`,
+      );
+    }
+
+    const normalizedTool = TOOL_ALIASES.get(normalizedToken) ?? null;
     if (!normalizedTool) {
       throw new Error(`Unknown tool '${token}'. Allowed: ${TOOLS_FLAG_HELP}`);
     }

package/src/cli/index.js

@@ -96,8 +96,8 @@ export async function runCli({ argv, packageRoot, projectRoot, packageVersion })
     console.log('');
     console.log('Options (install / diff):');
     console.log('  --tools=<list>     Comma-separated adapters to enable (default: all)');
-    console.log('                     Values: claude, antigravity, codex, opencode');
-    console.log('                     Example: ukit install --tools=claude,codex,opencode');
+    console.log('                     Values: claude, codex, opencode, omp');
+    console.log('                     Example: ukit install --tools=claude,codex,opencode,omp');
     console.log('                     Use --tools=none to disable all optional adapters');
     console.log('  --with-codegraph   Enable CodeGraph MCP integration in CLAUDE.md');
     console.log('                     Adds routing rules that prefer codegraph_* tools for');

package/src/core/applyPlan.js

@@ -2,9 +2,12 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { writeFileAtomic, copyFileSafe, createDirectoryLink, removeLinkOnly } from './fileOps.js';
 
-const TCC_PROTECTED_PREFIXES = ['.codex/', '.antigravity/'];
+// legacy: '.antigravity/' stays TCC-protected — Antigravity adapter removed in v2.2.0, but a
+// stale install may still have the dir and must not lose TCC protection.
+const TCC_PROTECTED_PREFIXES = ['.codex/', '.antigravity/', '.omp/'];
 
-function isTccProtectedPath(filePath) {
+// Exported for tests: the prefix boundary is security-relevant and worth asserting directly.
+export function isTccProtectedPath(filePath) {
   const normalized = filePath.replace(/\\/g, '/');
   return TCC_PROTECTED_PREFIXES.some((prefix) => {
     const idx = normalized.indexOf(`/${prefix}`);

package/src/core/ensureGitignore.js

@@ -4,9 +4,11 @@ import { writeFileAtomic } from './fileOps.js';
 
 const UKIT_ENTRIES = [
   '.cache/',
+  // legacy: Antigravity adapter removed in v2.2.0; leftovers must stay ignored
   '.antigravity/',
   '.claude/',
   '.codex/',
+  '.omp/',
   '.ukit/',
   'opencode.json',
   'AGENTS.md',

package/src/core/runInstallPipeline.js

@@ -16,6 +16,10 @@ import { cleanupEmptyParents, readJsonIfExists, removeFileOrLinkOnly, resolvePro
 
 const AUTO_PRUNE_OBSOLETE_PREFIXES = [
   '.claude/skills/',
+  // The Antigravity adapter was removed in v2.2.0. Without this, a pre-2.2.0 install
+  // leaves its .antigravity/ links dangling forever, since nothing else ever revisits
+  // them. Only paths UKit itself recorded in install.json are considered here.
+  '.antigravity/',
 ];
 
 const AUTO_PRUNE_OBSOLETE_PATHS = new Set([
@@ -219,6 +223,21 @@ async function pruneObsoleteManagedPaths({
     if (removed) {
       removedCount += 1;
       await cleanupEmptyParents(absolutePath, projectRoot);
+      continue;
+    }
+
+    // removeFileOrLinkOnly refuses real directories. A path recorded as managed that is
+    // now a real directory means the user replaced it — say so instead of silently
+    // leaving it behind, matching the link-update warning in applyPlan.js.
+    try {
+      const stat = await fs.lstat(absolutePath);
+      if (stat.isDirectory() && !stat.isSymbolicLink()) {
+        console.warn(
+          `[UKit] Warning: skipping obsolete path ${absolutePath} — exists as a real directory (possible user content). Remove it manually if intended.`,
+        );
+      }
+    } catch {
+      // Already gone — nothing to prune and nothing to warn about.
     }
   }
 

package/src/core/runtimeConfig.js

@@ -6,7 +6,9 @@ import { buildRuntimePaths } from './runtimePaths.js';
 const require = createRequire(import.meta.url);
 const { version: PACKAGE_VERSION } = require('../../package.json');
 
-const VALID_AGENTS = new Set(['claude-code', 'codex', 'antigravity', 'opencode']);
+// legacy: 'antigravity' stays valid — Antigravity adapter removed in v2.2.0, but an existing
+// config.json naming it must not become invalid.
+const VALID_AGENTS = new Set(['claude-code', 'codex', 'antigravity', 'opencode', 'omp']);
 
 const BLOCKED_MERGE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 
@@ -79,6 +81,9 @@ export function buildDefaultRuntimeConfig(overrides = {}) {
         targets: {
           claude: { autoCompact: true, mode: 'precompact-reinject', preserveExistingHooks: true },
           opencode: { autoCompact: true, mode: 'native-auto-prune', preserveExistingCompaction: true },
+          // 'precompact-reinject' like claude, NOT codex's 'soft-handoff': omp exposes real
+          // pre-compaction hook events, so there is nothing to work around with a state file.
+          omp: { autoCompact: true, mode: 'precompact-reinject', preserveExistingHooks: true },
           codex: {
             autoCompact: true,
             mode: 'soft-handoff',

package/src/core/status.js

@@ -11,8 +11,10 @@ import { detectProjectContext } from '../context/detectProjectContext.js';
 function formatPrimaryAgent(agentKey) {
   if (agentKey === 'claude-code') return 'Claude Code';
   if (agentKey === 'codex') return 'OpenAI Codex';
+  // legacy: Antigravity adapter removed in this release; existing config.json may still name it
   if (agentKey === 'antigravity') return 'Antigravity';
   if (agentKey === 'opencode') return 'OpenCode';
+  if (agentKey === 'omp') return 'Oh My Pi (omp)';
   return agentKey || 'Unknown';
 }
 
@@ -20,9 +22,9 @@ async function detectAdapterLabels(projectRoot, primaryAgent) {
   const labels = [formatPrimaryAgent(primaryAgent)];
 
   const checks = [
-    { label: 'Antigravity', path: '.antigravity/README.md' },
     { label: 'OpenAI Codex', path: '.codex/settings.json' },
     { label: 'OpenCode', path: 'opencode.json' },
+    { label: 'Oh My Pi (omp)', path: '.omp/config.yml' },
   ];
 
   for (const check of checks) {

package/src/core/uninstall.js

@@ -24,8 +24,10 @@ const ALLOWED_UNINSTALL_PREFIXES = [
   'AGENTS.md',
   'docs/',
   '.claude/',
+  // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
   '.antigravity/',
   '.codex/',
+  '.omp/',
   '.ukit/',
   'opencode.json',
 ];
@@ -77,14 +79,28 @@ function buildFallbackPaths(projectRoot) {
       path.join(projectRoot, '.claude', 'ukit', '.env.example'),
       path.join(projectRoot, '.claude', 'ukit', 'permission-usage.json'),
       path.join(projectRoot, '.claude', 'ukit', 'permission-audit.log'),
+      // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
       path.join(projectRoot, '.antigravity', 'rules', 'rules.md'),
       path.join(projectRoot, '.antigravity', 'README.md'),
       path.join(projectRoot, '.codex', 'README.md'),
       path.join(projectRoot, 'opencode.json'),
+      // omp adapter — 11 managed files, no symlinks (the adapter creates none)
+      path.join(projectRoot, '.omp', 'AGENTS.md'),
+      path.join(projectRoot, '.omp', 'RULES.md'),
+      path.join(projectRoot, '.omp', 'config.yml'),
+      path.join(projectRoot, '.omp', 'README.md'),
+      path.join(projectRoot, '.omp', 'hooks', 'pre', 'ukit-bridge.js'),
+      path.join(projectRoot, '.omp', 'agents', 'bug-debugger.md'),
+      path.join(projectRoot, '.omp', 'agents', 'code-reviewer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'feature-implementer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'handoff-planner.md'),
+      path.join(projectRoot, '.omp', 'agents', 'ukit-small-task-maintainer.md'),
+      path.join(projectRoot, '.omp', 'agents', 'ukit-vision-analyst.md'),
       path.join(projectRoot, '.ukit'),
       stateDir,
     ],
     linkPaths: [
+      // legacy: Antigravity adapter removed in v2.2.0; still cleaned up on repos that installed it
       path.join(projectRoot, '.antigravity', 'skills'),
       path.join(projectRoot, '.antigravity', 'ukit'),
       path.join(projectRoot, '.codex', 'skills'),

package/src/index/routeCatalog.js

@@ -256,7 +256,7 @@ export const ROUTE_CATALOG = [
     signals: [
       { type: 'prompt', regex: /\b(stale|refresh|cleanup|reinstall|maintenance|workspace drift|index freshness|out of date)\b/i, score: 4 },
       { type: 'command', regex: /\bukit install\b|\brefresh-index\.mjs\b|\bbuild-index\.mjs\b/i, score: 3 },
-      { type: 'file', regex: /\.claude\/|\.codex\/|\.antigravity\//i, score: 1 },
+      { type: 'file', regex: /\.claude\/|\.codex\/|\.antigravity\/|\.omp\//i, score: 1 },
     ],
   },
   {

package/src/manifest/selectItems.js

@@ -1,9 +1,4 @@
 export const OPTIONAL_ADAPTER_ITEM_IDS = new Set([
-  'multi-antigravity-skills-link',
-  'multi-antigravity-ukit-link',
-  'multi-antigravity-rules',
-  'multi-antigravity-readme',
-  'multi-antigravity-agents-link',
   'multi-codex-skills-link',
   'multi-codex-ukit-link',
   'multi-codex-readme',
@@ -11,6 +6,17 @@ export const OPTIONAL_ADAPTER_ITEM_IDS = new Set([
   'multi-codex-settings-local',
   'multi-codex-agents-link',
   'multi-opencode-config',
+  'multi-omp-agents-md',
+  'multi-omp-rules',
+  'multi-omp-config',
+  'multi-omp-readme',
+  'multi-omp-hook-bridge',
+  'multi-omp-agent-bug-debugger',
+  'multi-omp-agent-code-reviewer',
+  'multi-omp-agent-feature-implementer',
+  'multi-omp-agent-handoff-planner',
+  'multi-omp-agent-ukit-small-task-maintainer',
+  'multi-omp-agent-ukit-vision-analyst',
 ]);
 
 function resolveItemOrder(items) {

package/templates/.claude/commands/ukit/handoff-create.md

@@ -1,11 +1,13 @@
 # /ukit:handoff-create — Phase 1 + 2: Plan
 
 **Role: PLANNER**
-**Tool: any** (Claude Code / Codex / Antigravity / Kilo / OpenCode — your choice)
+**Tool: any** (Claude Code / Codex / omp / Kilo / OpenCode — your choice)
 **Model split:**
 - Read/understand → lite model (haiku · unic-lite · cheapest available)
 - Write plan + tasks → strong model (Opus · unic-smart · strongest available)
 
+> **omp model tiers:** the tiers above map to `.omp/config.yml`'s `modelRoles`, referenced from agent frontmatter as `@lite` / `@code` / `@smart`.
+
 ## Problem / feature
 $ARGUMENTS
 
@@ -39,7 +41,7 @@ After the batched call, run Steps 1–2.5 to completion without further question
 
 ## Step 1 — Read context (lite model)
 
-**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "ukit-small-task-maintainer"`. Do NOT read these files yourself in the current session — this step is contracted to the lite tier (haiku/unic-lite), which only the spawned agent's frontmatter model guarantees. Ask the agent to:
+**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "ukit-small-task-maintainer"` (omp: the `task` tool with `agent: "ukit-small-task-maintainer"`). Do NOT read these files yourself in the current session — this step is contracted to the lite tier (haiku/unic-lite), which only the spawned agent's frontmatter model guarantees. Ask the agent to:
 
 1. Read `docs/AI_HANDOFF/INDEX.md` → current tasks + statuses (or "empty")
 2. Read `docs/AI_HANDOFF/ACTIVE.md` → active cycle info (or "no active cycle")
@@ -53,7 +55,7 @@ After the batched call, run Steps 1–2.5 to completion without further question
 
 ## Step 2 — Write plan + tasks (strong model)
 
-**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "handoff-planner"`, passing it the Step 1 summary and the problem/feature description. Do NOT write PLAN.md or task files yourself in the current session — this step is contracted to the strong tier (opus/unic-smart), which only the spawned agent's frontmatter model guarantees.
+**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "handoff-planner"` (omp: the `task` tool with `agent: "handoff-planner"`), passing it the Step 1 summary and the problem/feature description. Do NOT write PLAN.md or task files yourself in the current session — this step is contracted to the strong tier (opus/unic-smart), which only the spawned agent's frontmatter model guarantees.
 
 The planner agent does the following (use Step 1 summary — do NOT re-read files):
 
@@ -119,7 +121,7 @@ The planner agent does the following (use Step 1 summary — do NOT re-read file
 Two independent strong-model passes shape the plan before any code is written — that gate is
 intact. What it no longer does is hand a stalled plan back and wait.
 
-**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "code-reviewer"`, passing `REVIEW_TARGET_TYPE=plan` and the path to `docs/AI_HANDOFF/PLAN.md`. This MUST be a separate agent invocation from Step 2's `handoff-planner` call (fresh context) — same-session self-review defeats the purpose of an independent gate.
+**Claude Code — MANDATORY, do this before anything else:** call the Agent tool with `subagent_type: "code-reviewer"` (omp: the `task` tool with `agent: "code-reviewer"`), passing `REVIEW_TARGET_TYPE=plan` and the path to `docs/AI_HANDOFF/PLAN.md`. This MUST be a separate agent invocation from Step 2's `handoff-planner` call (fresh context) — same-session self-review defeats the purpose of an independent gate.
 
 1. Reviewer reads `PLAN.md` only (no diff, no task files, no executor report), checks Completeness / Consistency / Clarity / Scope / YAGNI — see `.claude/agents/code-reviewer.md` → Spec/Plan Review — and appends its verdict to PLAN.md's `## Plan Review Log` (new round entry, prior rounds kept).
 2. `Issues Found` → route back to Step 2: planner revises `PLAN.md` and the affected `TASK-xxx.md` files to address every finding, then re-submit for another Step 2.5 review (this becomes the next round). Do NOT commit or hand off to executor on `Issues Found`.