
Oma Bootstrap
Install or verify the oma CLI and its runtimes (bun, uv, serena) before any oma-*...
Install
npx skills add first-fluke/oh-my-agent --skill oma-bootstrap -g -a claude-code -y- Repository
- first-fluke/oh-my-agent1.4k
- Category
- AI and agents
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 632 tokens
- Runs scripts
- No, instructions only
What it does
Install or verify the oma CLI and its runtimes (bun, uv, serena) before any oma-* skill, agent, or workflow runs an `oma` command. Use when `oma` is missing from PATH, when a skill says to run `oma ...` and the shell reports "command not found", or on the first task in a fresh Cursor or Grok Bot workspace.
oma bootstrap
The oma-* skills in this plugin describe what to do. Several of them delegate
the mechanics to the oma CLI (oma agent spawn, oma market run,
oma recap, oma hook run, oma doctor), and code search expects the
Serena MCP binary. Marketplace installs ship the skill text, not the binaries,
so a fresh workspace may have neither.
When to run
- A skill instruction contains an
oma ...command andcommand -v omais empty. - The shell reports
oma: command not foundorserena: command not found. - The workspace has no
.agents/directory and a skill needs project state (.agents/state/,.agents/results/,oma-config.yaml).
Skip this skill when oma --version already prints a version.
Steps
Run from the repository root. Every step is idempotent; rerunning is safe.
-
Check:
command -v oma && oma --version. If both succeed, stop here. -
Provision the runtimes with the official installer in non-interactive mode. It installs bun, uv, serena-agent, and cue when missing, and
OMA_INSTALL_NO_RUN=1skips the interactive setup it would otherwise launch at the end:curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh \ | OMA_INSTALL_NO_RUN=1 bash export PATH="$HOME/.bun/bin:$HOME/.local/bin:$PATH"Without
curl, usewget -qO-in its place. Each dependency is best-effort: the installer warns and continues when one fails. -
Install the CLI as a persistent global binary (skills call bare
oma):bun install --global oh-my-agent -
Wire the project non-interactively. This creates
.agents/with the default preset and leaves existing files untouched:oma install --yes -
Verify:
oma doctor. It reports whetherserenais on PATH and whether the project is registered. Report any warning before continuing with the original task.

