Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/omnigent-ai/omnigent/llms.txt

Use this file to discover all available pages before exploring further.

Omnigent is an open-source meta-harness and declarative runtime for AI agents. It sits above the individual coding agents you already use — Claude Code, Codex, Pi, and agents you write yourself — and gives you a single place to run them, govern them, and collaborate on them in real time from any device.

Quickstart

Run your first agent in under five minutes with a single install command.

Write Your Own Agent

Define an agent in YAML: prompt, tools, sub-agents, and policies in one file.

Policies & Governance

Control what agents can do with ALLOW / DENY / ASK rules at three trust levels.

API Reference

Explore the full REST and SSE API for sessions, hosts, runners, and resources.

Why Omnigent?

One harness, all agents

Run Claude Code, Codex, Pi, or a custom agent from the same CLI and web UI. Switch harnesses with a flag — no rewriting required.

Policies that stack

Set guardrails at the server, agent, or session level. Pause before risky shell commands, cap token spend, or block specific tools — all declaratively.

Collaborate in real time

Share a live session link, co-drive an agent with a teammate, or fork a conversation to continue it independently.

Cloud-native sandboxes

Run agent sessions in disposable Modal or Daytona sandboxes — your laptop doesn’t have to stay online.

Get Started in Three Steps

1

Install Omnigent

One command installs Omnigent and all its dependencies:
curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh
Or install manually with uv or pip:
uv tool install omnigent
2

Run an agent

Start Claude Code in a live session your team can join:
omnigent claude
Or try one of the bundled examples — Polly (multi-agent coding orchestrator) or Debby (dual-headed brainstorming partner):
omnigent run examples/polly/
omnigent run examples/debby/
3

Open the web UI

Omnigent starts a local web UI at http://localhost:6767 automatically. Open it in your browser — or on your phone over the local network — to see the same session in real time.For a stable URL accessible from anywhere, deploy a server and invite your team.

Explore the Documentation

Core Concepts

Understand the server / runner / harness architecture and how sessions work.

Deployment

Deploy on Docker, Render, Railway, Fly.io, Modal, or Hugging Face Spaces.

CLI Reference

Every command, subcommand, and flag — with examples and default values.

Agent YAML

Full schema reference for the declarative agent spec format.

Builtin Policies

Catalog of safety, cost, and access policies you can apply out of the box.

Python SDK

Programmatic session management and streaming with omnigent-client.

Build docs developers (and LLMs) love