omnigent
by omnigent-ai
Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.
3,634stars
407forks
Python
Added 6/18/2026
AI Agentsagent-frameworkagent-governanceagent-orchestrationagentsaiai-agentai-agentsclaude-codecodexcoding-agentsdeveloper-toolsllmmlmulti-agentpythonsandbox
Installation
# Add to your Claude Code skills
git clone https://github.com/omnigent-ai/omnigentGetting Started
Guides for using ai agents skills like omnigent.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 6/18/2026
{
"issues": [
{
"file": "README.md",
"line": 62,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/i\"",
"severity": "low"
},
{
"file": "omnigent/onboarding/agent/skills/build-omnigent/SKILL.md",
"line": 151,
"type": "dangerous-command",
"message": "Dangerous command (disables permission prompts): \"bypassPermissions\"",
"severity": "medium"
},
{
"file": "omnigent/onboarding/agent/skills/omnigent-knowledge/SKILL.md",
"line": 60,
"type": "dangerous-command",
"message": "Dangerous command (disables permission prompts): \"bypassPermissions\"",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-06-18T08:48:21.965Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}Omnigent
The open-source AI agent framework and meta-harness for all your AI agents.
Omnigent is an open-source AI agent framework and meta-harness that gives you a common orchestration layer over Claude Code, Codex, Cursor, Pi, and the agents you write yourself: swap or combine harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.
omnigent.ai · ⬇️ Download the macOS desktop app
Why Omnigent?
Omnigent lets you:
-
📱 Work with agents from any device, including your phone. Sessions follow you: start in your terminal, continue in the browser, pick it up on your phone. Messages, sub-agents, terminals, and files stay in sync.
-
🤖 Supervise multiple agents. Use Claude Code, Codex, Pi, and custom agents (defined in YAML) together in the same session. Ask one agent to review another's work, or split a task across agents that are each good at different things.
-
🔌 Use any model. A first-party API key, a Claude/ChatGPT subscription, or any compatible gateway. All first-class.
-
🤝 Collaborate. Share a session so teammates can chat with your agent and watch it work live, co-drive it on your machine, or fork the conversation to continue on their own.
-
☁️ Run agents in cloud sandboxes. No laptop required: run sessions in disposable Modal, Daytona, or Islo sandboxes, launched from the CLI or provisioned by the server per session (managed hosts).
-
🛡️ Govern your agents. Create policies to pause for your approval before risky actions, cap spend, or limit which tools an agent reaches. They apply to the whole server, one agent, or a single chat.
Quick start
1. Install
One command installs Omnigent and everything it needs:
curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh
Omnigent needs Python 3.12+. Install the omnigent package:
uv tool install omnigent # or: pip install "omnigent"
Or with Homebrew:
brew install omnigent-ai/tap/omnigent
Or install straight from the repo:
uv tool install -q --python 3.12 git+https://github.com/omnigent-ai/omnigent.git
uv(required). https://docs.astral.sh/uv/getting-started/installation/ The installer offers to set this up for you.git(required).- Node.js 22 LTS or newer with
npm, for the Claude, Codex, and Pi coding harnesses.omnigent runinstalls the harness CLI you pick. https://docs.npmjs.com/downloading-and-installing-node-js-and-npm tmux, required by the nativeomnigent claude/omnigent codexwrappers (brew install tmux/apt install tmux; the installer offers to install it for you).bubblewrap(bwrap), Linux only. The nativeomnigent claude/omnigent codexandpiharnesses wrap each agent terminal in abwrapOS-sandbox; on Linux that isolation is mandatory, so a missingbwrapbinary makes those terminals fail to start (apt install bubblewrap; the installer offers to install it for you). macOS uses the built-inseatbeltsandbox and needs nothing extra.- Databricks (optional). To use a Databricks workspace as your model
provider, install Omnigent with the
databricksextra:uv tool install "omnigent[databricks]"— or pass it to the bootstrap installer with... | sh -s -- --extra databricks. Signing in to the workspace also uses the Databricks CLI.
When a newer release is on PyPI, Omnigent shows a one-line notice (once per release) pointing here. To update:
omni upgrade # detects how you installed, drains & stops the local
# server, then runs the matching upgrade command
omni upgrade --check # just report whether a newer release is available
omni upgrade waits for in-flight agent sessions to finish before stopping the
local server (pass --force to stop them immediately); the next omni command
brings the server back up on the new version. Source checkouts update with
git pull instead. Silence the notice with OMNIGENT_NO_UPDATE_CHECK=1.
The check queries your configured package index — honoring UV_INDEX_URL /
PIP_INDEX_URL and your uv.toml / pip.conf (default PyPI), so private
mirrors work out of the box; override with OMNIGENT_INDEX_URL if needed.
2. Start your first agent
omnigent picks a model with you and starts a session in your terminal. It
also launches a local web UI at http://localhost:6767 that shows the same
session in the browser, or on a phone on your network (step 4). The
desktop app wraps that same UI
in a native window and adds OS notifications and a dock badge —
download it for macOS.
[!NOTE] The install puts two names for the same CLI on your PATH:
omnigentand the shorteromni. They're interchangeable.
[!TIP] On first run, Omnigent picks up model credentials already in your environment (an
ANTHROPIC_API_KEY/OPENAI_API_KEY, or aclaude/codexCLI you're logged into) and offers one as the default.
omnigent
Or launch a specific agent runtime, or your own agent:
omnigent claude # Claude Code, in a session your team can join
omnigent codex # Codex
omnigent run path/to/agent.yaml # your own agent (see "Write your own agent")
🐙 Polly and 🟠🔵 Debby
Two example agents ship with the repo, and they make good first sessions:
omnigent run examples/polly/
omnigent run examples/debby/
# Run an orchestrator on a different harness (sub-agents keep their own):
omnigent run examples/polly/ --harness pi
omnigent run examples/debby/ --harness openai-agents
omnigent run examples/polly/ --harness cursor # Cursor CLI (needs cursor-agent + CURSOR_API_KEY)
🐙 Polly is a multi-agent coding orchestrator who writes no code herself. She's the tech lead: she plans, delegates the work to coding sub-agents (Claude Code, Codex, or Pi) in parallel git worktrees, then routes each diff to a reviewer from a different vendor than the one that wrote it. You merge.
🟠🔵 Debby is a brainstorming partner with two heads, one Claude and one GPT.
Every question you ask goes to both heads, and she lays the two answers out
side by side. Type /debate and the heads critique each other for a few
rounds before converging. (She needs both a Claude and an OpenAI credential;
see step 3.)
Prefer the browser? Start a server and register your machine as a host:
omnigent server start # start the local server and web UI in the background
omnigent host # (separate terminal) register this machine as a host
In the web UI, hit New Chat, pick your machine, and go. Check status with
omnigent server status; stop everything with omnigent stop.
3. Choose & switch models
omnigent setup
Add a credential, set a default, or remove one, grouped by agent. Omnigent works with four kinds of credentials:
| Kind | What it is | |
|---|---|---|
| 🔑 | API key | A first-party vendor key for Anthropic, OpenAI, and similar providers |
| 🎟️ | Subscription | A Claude Pro/Max or ChatGPT plan, via the official claude / codex CLIs |
| 🌐 | Gateway | Any OpenAI- or Anthropic-compatible base_url and key (OpenRouter, LiteLLM, Ollama, vLLM, Azure) |
| 🧱 | Databricks | A Databricks workspace profile (requires the databricks extra) |
Defaults are per agent, so a Claude default and a Codex default coexist. You
can also switch models in the middle of a session with the /model command.
When you add a Gateway credential, omnigent setup asks for a base URL
and a key. The base URL depends on which agent you point it at:
| Provider | For | Base URL | Key |
|---|---|---|---|
| OpenRouter | Claude Code | https://openrouter.ai/api |
your OpenRouter key (sk-or-…) |
| OpenRouter | Codex / OpenAI agents | https://openrouter.ai/api/v1 |
your OpenRouter key (sk-or-…) |
| Ollama (local) | Codex / OpenAI agents | http://localhost:11434/v1 |
any value (Ollama ignores it) |
For Claude Code, point at OpenRouter's Anthropic-compatible endpoint
(…/api, not …/api/v1). For Codex and the OpenAI-agents harness, use
the OpenAI-compatible …/api/v1.
4. Deploy a server (and use it from your phone📱)
Run Omnigent on a server with a stable URL
(deploy/README.md is the full guide) and your sessions
become reachable from anywhere, including your phon
Frequently Asked Questions
What is omnigent?
omnigent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by omnigent-ai. Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device. It has 3,634 GitHub stars.
Is omnigent safe to use?
Yes. omnigent passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install omnigent?
Clone the repository with "git clone https://github.com/omnigent-ai/omnigent" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is omnigent written in?
omnigent is primarily written in Python. It is open-source under omnigent-ai on GitHub, so you can review or fork the full source.
Are there alternatives to omnigent?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh omnigent against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
217,466
33,379
JavaScript
AI Agentsai-agentsanthropic
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
192,996
58,642
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
120,031
19,897
Shell
AI Agents
An open-source AI agent that brings the power of Gemini directly into your terminal.
105,379
14,098
TypeScript
AI Agentsaiai-agents