oh-my-antigravity

oh-my-antigravity (OmA)

Landing Page | History

한국어 | 日本語 | Français | 中文 | Español

[!IMPORTANT] Antigravity CLI: Gemini CLI will be replaced by Antigravity CLI on June 18th.

If you previously installed oh-my-gemini-cli in Gemini CLI, Antigravity CLI will ask whether to import plugins during installation. Check that option to bring your plugin over.

You can also install OmA directly with:

agy plugin install https://github.com/Joonghyun-Lee-Frieren/oh-my-antigravity

Context-engineering-powered multi-agent workflow pack for Antigravity CLI.

"Claude Code's core competitiveness isn't the Opus or Sonnet engine. It's Claude Code itself. Surprisingly, Gemini works well too when attached to Claude Code."

• Jeongkyu Shin (CEO of Lablup Inc.), from a YouTube channel interview

This project started from that observation: "What if we bring that harness model to Gemini CLI?"

OmA extends Gemini CLI from a single-session assistant into a structured, role-driven engineering workflow.

Quick Start

Installation

Install from GitHub using the official Gemini Extensions command:

gemini extensions install https://github.com/Joonghyun-Lee-Frieren/oh-my-antigravity

Verify in interactive mode:

/extensions list

Verify in terminal mode:

gemini extensions list

Run a smoke test:

/oma:status

Run a goal-style autonomous delivery loop:

/oma:goal "Implement the requested change, update tests, and verify acceptance criteria"

Note: extension install/update commands run in terminal mode (gemini extensions ...), not in interactive slash-command mode.

What's New in v0.9.2

• Orbit Router Diagnostics: The quiet BeforeModel router can now write an opt-in last-decision trace to .omg/state/model-router-last.json.
• Trace Without Noise: Set OMG_MODEL_ROUTING_TRACE=1 to capture selected lane, model, strategy, and match reason without restoring the old per-request banner.
• Doctor/Status Visibility: /oma:doctor, /oma:status, /oma:model, and hook validation guidance now account for router trace freshness and missing custom lane mappings.
• Version Bump: Bumped project and extension version to v0.9.2.

Extension Boundary and Upgrade Safety

• Install and update OmA through gemini extensions ...; do not rely on copied command/skill folders as the primary runtime path.
• Keep one authoritative OmA hook registration path per event. Mixing extension-managed hooks with manual duplicates is the fastest way to get repeated AfterAgent output or stale behavior.
• When OmA feels stale after an update, check gemini extensions list first, then refresh or reinstall the extension before editing shipped files.
• For long or multi-lane work, treat /oma:workspace audit as the default preflight before review, automation, or team-exec.

Interview Session Storage

• /oma:interview session state is now intended to live under .omg/state/interviews/[slug]/ instead of one shared interview file.
• .omg/state/interviews/active.json tracks the current interview so resume/status commands stay deterministic without mixing separate requirement threads.
• This keeps multiple requirement-discovery passes in the same project distinguishable and archive-friendly.

Shared Workflow State

• .omg/state/session-lock.json is now the single-writer lock for shared workflow and operating-profile state inside one project.
• Only the lock-owning orchestration session should write shared files like workspace.json, taskboard.md, workflow.md, checkpoint.md, mode.json, hud.json, approval.json, reasoning.json, hooks.json, and notify.json.
• Parallel top-level sessions that do not own the lock should write session-local drafts under .omg/state/sessions/[session-slug]/ and hand those notes back to the orchestrator for merge.
• Delegated worker/sub-agent turns should stay read-mostly and must not mutate shared workflow state directly.

At A Glance

Why OmA

Dynamic Team Assembly

Use team-assemble when a fixed engineering roster is not enough.

• Split selection into:
  • domain specialists (problem expertise)
  • format specialists (report/content/output quality)
• Spawn parallel exploration lanes (oma-researcher xN) for broad discovery tasks.
• Route decisions through a judgment lane (oma-consultant or oma-architect).
• Assign reasoning effort per lane from global profile + teammate overrides.
• Keep verify/fix loops explicit (oma-reviewer -> oma-verifier -> oma-debugger).
• Run anti-slop check before final delivery.
• Require explicit approval before autonomous execution starts.

Example flow:

/oma:team-assemble "Compare 3 competitors and produce an exec report"
-> proposes: researcher x3 + consultant + editor + director
-> asks: Proceed with this team? (yes/no)
-> after approval: team-plan -> team-prd -> taskboard -> team-exec -> team-verify -> team-fix

Activation note:

• No separate research-preview setting is required in OmA.
• If the extension is loaded, /oma:team-assemble is immediately available.

Workspace and Taskboard Control

Use workspace and taskboard when work spans multiple roots, multiple implementation lanes, or long verify/fix loops.

• /oma:workspace keeps the primary root plus optional worktree/path lanes in .omg/state/workspace.json.
• Each lane can also carry a compact baseline branch/HEAD anchor so handoffs and resume flows can detect unexpected branch drift before implementation or review.
• /oma:workspace audit checks lane cleanliness, trust status, and handoff readiness before parallel execution, review, or automation.
• /oma:taskboard keeps stable task IDs, owners, dependencies, statuses (todo, ready, in-progress, blocked, done, verified), baseline anchors, lane-health notes, and evidence pointers in .omg/state/taskboard.md.
• team-plan seeds stable task IDs plus lane assumptions and baseline anchors, team-exec pulls the smallest ready slice with explicit lane/subagent context and baseline checks, and team-verify marks tasks verified only with evidence plus safe lane state.
• checkpoint and status can reference these files instead of replaying the whole chat, which improves cache stability and reduces token waste.
• /oma:recall "<query>" performs state-first recall and bounded fallback search, so you can recover prior rationale without replaying full transcripts.

Example flow:

/oma:workspace set .
/oma:workspace audit
/oma:workspace add ../feature-auth oma-executor
/oma:taskboard sync
/oma:taskboard next
/oma:recall "why was auth lane blocked" scope=state

Workspace Hygiene and Hook Symmetry

Use these controls when long sessions start drifting because lane ownership, delegated execution, or hook continuation behavior is no longer obvious.

• /oma:workspace audit surfaces dirty shared worktrees, untrusted review paths, and handoff-ready vs handoff-blocked lanes.
• /oma:hooks and /oma:hooks-validate now model paired agent lifecycle outcomes (completed, blocked, stopped) so blocked continuations re-enter the safety lane once before downstream hooks resume.
• team-exec, team, team-verify, stop, and cancel keep delegated lane/subagent context compact and explicit, expanding details only when execution stops early or hits a blocker.

Notification Routing

Use notify when a long-running OmA session needs explicit signals for approvals, verification outcomes, blockers, or idle drift.

• Supported profiles:
  • quiet: only urgent interruptions (approval-needed, verify-failed, blocker-raised, session-stop)
  • balanced: quiet + checkpoint and team-approval updates
  • watchdog: balanced + idle-watchdog alerts for unattended loops
• Supported channels:
  • desktop (host notification adapter)
  • terminal-bell
  • file
  • webhook (external bridge)
• Safety boundary:
  • OmA manages event routing, templates, and persisted policy
  • actual delivery must be implemented by Gemini host hooks, shell adapters, or project-specific webhook bridges
  • delegated worker sessions keep external dispatch disabled unless the user explicitly opts in

Example flow:

/oma:notify profile watchdog
-> enables: approval-needed, verify-failed, blocker-raised, checkpoint-saved, idle-watchdog, session-stop
-> suggests channels: terminal-bell + file by default
-> persists policy: .omg/state/notify.json

Model Router (BeforeModel Hook)

OmA ships a quiet model-routing hook. The previous AfterAgent quota-watch usage monitor was removed in v0.8.4 because Gemini CLI can report usage as unavailable, which created noisy low-value output.

• Hook entrypoint: hooks/hooks.json (BeforeModel -> oma-model-router)
• Script: hooks/scripts/before-model-banner.js