English | Deutsch | Español | Français | Italiano | 日本語 | 한국어 | Português | Русский | Türkçe | Tiếng Việt | 中文

Extension-first multi-agent orchestration for Gemini CLI, with tmux-backed team execution, persistent local state, and verification-oriented workflows.

• Repository: r3dlex/oh-my-antigravity
• npm package name: @r3dlex/oh-my-antigravity
• CLI commands: omg, omg-cli, and oh-my-antigravity

Package status: the scoped package has not completed its first npmjs.com publish. Until that one-time maintainer action is complete, use the source installation below rather than a registry install.

• Node.js >=20.10.0 and npm
• Google Gemini CLI, which provides the gemini command
• tmux for the default team backend
• Git for the current source installation
• Docker or Podman only when using container sandbox mode

Check the required tools:

node --version
npm --version
gemini --version
tmux -V
git --version

This is the recommended path until the first npm publish is complete:

git clone https://github.com/r3dlex/oh-my-antigravity.git
cd oh-my-antigravity
npm ci
npm run build
npm install -g .

# Run these from the project where you want to use omg.
cd /path/to/your-project
omg setup --scope project --dry-run
omg setup --scope project
omg doctor

--dry-run previews managed project-file changes; it does not link the extension or clean legacy user-skill conflicts. An applied setup reports Setup scope: project, per-action statuses, and a successful extension link (or a manual link command). A healthy installation ends the doctor report with:

Overall: healthy

Launch an interactive Gemini CLI session with the extension loaded:

omg

Or verify team planning without starting workers:

omg team run --task "inspect this repository" --dry-run --json

Project scope is the supported default. --scope user currently falls back to project scope.

omg setup creates or updates:

Generated .omg/ state and local .gemini/ configuration are gitignored in this repository. Do not hand-edit generated runtime state. Preserve these managed markers in .gemini/GEMINI.md:

# >>> oh-my-antigravity (managed) >>>
# <<< oh-my-antigravity (managed) <<<

Safety notes:

• Run omg setup --scope project --dry-run before applying managed project-file changes in an existing project. Extension linking and legacy user-skill cleanup occur only during the applied setup and are not included in the preview.
• Repeated setup runs are idempotent for managed project files. The managed .gemini/GEMINI.md update preserves content outside its marker block.
• Setup removes same-named legacy skill directories from ~/.agents/skills/ when they conflict with skills bundled by this extension. Back up intentional local customizations before setup.
• omg doctor --fix only repairs supported managed state, such as an invalid setup-scope file or missing .omg/state directory.

omg doctor
omg doctor --json
omg extension path

doctor checks Node.js, npm, the gemini command, tmux, setup scope, extension assets, and state-directory writeability. Docker or Podman and a globally available oh-my-antigravity binary are reported as optional checks.

Contributors can run the repository verification harness from the oh-my-antigravity source checkout only:

npm run verify

For the current source installation:

cd /path/to/oh-my-antigravity
git pull --ff-only
npm ci
npm run build
npm install -g .
omg setup --scope project
omg doctor

After the scoped package is first-published, omg update will update the global npm package. omg uninstall removes the global npm package, but intentionally leaves project-local .omg/ and .gemini/ files for manual review or removal.

If the diagnostic output does not identify the problem, open an issue with omg doctor --json output after removing sensitive paths or values.

• CLI command reference
• Setup scopes and idempotency
• Architecture
• Runtime backends
• Verification gates
• Examples
• Changelog

Read CONTRIBUTING.md for the development setup, branch conventions, and validation sequence. Use GitHub Issues for bugs, onboarding problems, and focused proposals.

MIT