A desktop coding agent with free access to frontier models.
OmniRush.ai Start
You are an agent helping a user install and set up OmniRush.ai.
Goal: install OmniRush.ai, create a provisional workspace without requiring email identity first, create a first skill, prepare the desktop app with that workspace/skill, verify the running app opens to the setup-complete state, and offer to connect the OmniRush.ai MCP to the agent the user is already using.
The bootstrap command is
omnirush-bootstrap. Use that exact command for these setup steps so the bootstrap flow stays distinct from other OmniRush.ai tooling a user may already have on their PATH.
1. Install CLI
Install the omnirush-bootstrap CLI into a user-writable bin dir.
If you already have this repository locally:
node packages/omnirush-bootstrap/bin/omnirush.mjs install \
--install-dir "$HOME/.omnirush/bootstrap" \
--bin-dir "$HOME/.local/bin" \
--json
Otherwise, download the bootstrap script from the install origin your
organization's administrator gave you, inspect it, then run it. Do not pipe
remote scripts directly into a shell. The script downloads the
omnirush-bootstrap CLI (a single dependency-free Node file) and installs it
into $HOME/.local/bin - no npm or npx required. There is no public hosted
install origin: the former hosted domain is retired, so never substitute a
guessed URL.
curl -fsSLo /tmp/omnirush-install.sh https://<your-install-origin>/install.sh
less /tmp/omnirush-install.sh
sh /tmp/omnirush-install.sh
Verify:
omnirush-bootstrap doctor --json
2. Install App
Install the desktop app for this OS from the manifest:
omnirush-bootstrap install app \
--manifest https://<your-install-origin>/install-manifest.json \
--json
Verify:
omnirush-bootstrap doctor --app --json
3. Create Cloud Workspace
For agent-first setup where email identity should not block desktop readiness, create a provisional workspace first. This does not create an email/password account. It writes claim links to the local desktop bootstrap file so a human can claim ownership later.
Optionally ask the user for their own email address first. It is only used to pre-fill the claim page later (not a security boundary, not an account, no password) - skip it if the user does not want to share it. Also optionally ask for teammate email addresses to invite. Invites only go out once the workspace is claimed (a provisional workspace has no authenticated owner yet to send them as) - they fire automatically the moment a human claims ownership.
--base-url is required and must be your organization's Den API origin;
omnirush.ai runs no hosted Den.
omnirush-bootstrap cloud bootstrap-workspace \
--base-url https://<your-den-api-origin> \
--workspace-name "<workspace-name>" \
--skill-name "First OmniRush.ai Skill" \
--claim-roles owner \
--prepare-desktop \
[--owner-email "<email-if-given>"] \
[--teammate-emails "<email1>,<email2>"] \
--json
If the user wants to attach a real account immediately, finish this provisional
setup first, then use the Claim this workspace action in the desktop app. Do
not create an email/password account from the CLI during agent-first install.
4. Launch the App
Open the desktop app so the user lands on the setup-complete screen with their first skill ready.
open -a OmniRush.ai # macOS
5. Finish Well (most important step)
Do NOT end by dumping readiness JSON or a list of ok: true checks. The user
does not care about flags — they want to know what to do next. End with a short,
friendly, human message that gives momentum:
- Confirm in one line that OmniRush.ai is installed and their workspace is ready (use the workspace name).
- Point them at ONE concrete first task they can run right now, e.g. "OmniRush.ai is open — try typing: 'summarize the files in my Downloads folder' and hit Run."
- Mention that teammates whose emails were already provided will be invited automatically once the workspace is claimed. If no emails were provided, offer to collect them later.
- End with this single question: "Want me to connect the OmniRush.ai MCP to this agent so you can manage your organization from here?"
Keep it to a few sentences. Warm, concrete, action-oriented. No JSON, no checklists, no internal flag names in the final message.
If the user says yes:
A provisional workspace must be claimed before its owner can authenticate the OmniRush.ai MCP. If it has not been claimed yet, explain that dependency and ask whether to open the claim step now. Retrieve and open the claim link only after the user confirms.
After the user has claimed the workspace and signed in, configure the MCP in the agent they are currently using. The server URL is:
https://<your-den-api-origin>/mcp/agentFor Codex, run:
codex mcp add omnirush --url https://<your-den-api-origin>/mcp/agent codex mcp login omnirushIf an
omnirushentry already exists, do not add a duplicate. Authenticate the existing entry instead. To switch organizations or recover stale auth, runcodex mcp logout omnirushbeforecodex mcp login omnirush.For another agent, use its current instructions from
https://github.com/omnirush-ai/omnirush-gui/blob/main/packages/docs/cloud/run-in-the-cloud/cloud-mcp.mdx; do not guess unsupported client commands.Tell the user to restart or reopen the current agent after setup so the new MCP tools are loaded. Do not claim the connection works until the restarted client can see OmniRush.ai's
search_capabilitiesandexecute_capabilitytools.
6. Retrieving the Claim Link
Do not print the claim URL preemptively. Only retrieve it when the user explicitly says they want to claim the workspace now (for example, after asking "claim the workspace").
omnirush-bootstrap cloud claim-link --role owner --json
Then open the returned url for the user (for example open <url> on macOS)
instead of pasting the raw link into chat.
7. Success Criteria (internal — do not show the user)
You are done only when all are true:
omnirush-bootstrap doctor --jsonreturnsok: trueomnirush-bootstrap doctor --app --jsonreturnsok: trueomnirush-bootstrap cloud bootstrap-workspace ... --jsonreturns:ok: trueorganization.idis presentsetup.idis presentskill.idis presentskillRun.triggeredistrueskillRun.outputisOMNIRUSH_BOOTSTRAP_SKILL_TRIGGEREDclaimLinks[0].idis presentdesktop.preparedistruedesktop.bootstrapPathis presentdesktop.skillPathis present
omnirush-bootstrap doctor --desktop-bootstrap --jsonreturnsok: true- When the desktop app is launched, it lands on the onboarding screen showing a green "Setup complete" banner, the organization name, a "First skill ready" tile, and a "Claim this workspace" action.
8. If Something Fails
- If CLI install fails: report OS, shell, command, and stderr.
- If the
omnirush-bootstrapcommand is not found after install: ensure$HOME/.local/binis on PATH, or call the binary by its full path ($HOME/.local/bin/omnirush-bootstrap). - If app install fails: run
omnirush-bootstrap doctor --app --jsonand report failed checks. - If the user needs account ownership immediately: complete the install, launch
the app, and use
Claim this workspaceso email verification happens in the browser/app instead of in the CLI.
9. Constraints
- Do not require admin privileges.
- Prefer user-local install paths.
- Do not print passwords or tokens in final output.
- Report exactly what was installed and where.
10. Security note: desktop preparation
--prepare-desktop writes machine-local setup state to
desktop-bootstrap.json. For passwordless workspace bootstrap, this includes
short-lived claim links so a human can attach an owner later. The links are not
printed in final output. This file is local-only; do not copy it between
machines or commit it.