Skip to content
Back to search

omnara

The open-source alternative to Claude Managed Agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/omnara-ai/omnara with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/omnara-ai/omnara'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/omnara-ai--omnara/badge.svg)](/listings/omnara-ai--omnara)

HTML

<a href="/listings/omnara-ai--omnara"><img src="/api/listings/omnara-ai--omnara/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Create your agent

instruction: |
  You are a coding agent running gpt-6.1-sol. Use the tools
  you have available to solve coding problems for the user.
model:
  provider_config: omnara-openrouter
  name: openai/gpt-6.1-sol
# ...
# add more tools, sandboxes, mcps

2. Upload your agent profile

$ npx omnara login
$ npx omnara profiles create --name agent --file agent.yaml
id                  aprf_aej3...
name                agent
[...]

3. Launch the agent from the profile and chat with it

$ npx omnara agents launch --profile $AGENT_PROFILE_ID --file agent.yaml
$ open https://app.omnara.com/projects/[$PROJECT_ID]/agents/[$AGENT_ID]

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 415 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://www.omnara.com#gh-light-mode-only">
  3. <img alt="Omnara" src="https://raw.githubusercontent.com/omnara-ai/omnara/main/frontend/apps/web/public/omnara-logo-black.png" width="212">
  4. </a>
  5. <a href="https://www.omnara.com#gh-dark-mode-only">
  6. <img alt="Omnara" src="https://raw.githubusercontent.com/omnara-ai/omnara/main/frontend/apps/web/public/omnara-logo-white.png" width="212">
  7. </a>
  8. </p>
  9. <h1 align="center">The open-source managed agent platform</h1>
  10. <p align="center">The open-source, self-hostable alternative to Claude Managed Agents and OpenAI's Agents API.</p>
  11. <p align="center">
  12. <a href="LICENSE"><img alt="License: Apache 2.0" src="https://img.shields.io/github/license/omnara-ai/omnara"></a>
  13. <a href="https://www.npmjs.com/package/@omnara/sdk"><img alt="npm: @omnara/sdk" src="https://img.shields.io/npm/v/@omnara/sdk?label=%40omnara%2Fsdk"></a>
  14. <a href="https://discord.gg/Dc46sYk6e3"><img alt="Discord" src="https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white"></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://www.omnara.com">Website</a> ·
  18. <a href="https://docs.omnara.com/quickstart">Quickstart</a> ·
  19. <a href="https://docs.omnara.com/introduction">Docs</a> ·
  20. <a href="https://docs.omnara.com/api/overview">API</a> ·
  21. <a href="https://docs.omnara.com/changelog">Changelog</a> ·
  22. <a href="https://discord.gg/Dc46sYk6e3">Discord</a>
  23. </p>
  24. Omnara is an open-source managed agent platform. Use the API to run AI agents
  25. on any model and any machine, with tools, secrets, permissions, and streaming
  26. built in. Self-host it for free under Apache 2.0, or use
  27. [Omnara Cloud](https://app.omnara.com).
  28. ## Quickstart
  29. ### Omnara Cloud
  30. Sign in at [app.omnara.com](https://app.omnara.com). Your first project comes
  31. with a model provider (`omnara-openrouter`) and a pool of managed sandboxes
  32. (`default-pool`), so this config runs as is. Save it as `agent.yaml`:
  33. ```yaml
  34. version: v1
  35. instruction: |
  36. You are an engineering assistant. Use your machine to run commands.
  37. model:
  38. provider_config: omnara-openrouter
  39. name: anthropic/claude-fable-5.2
  40. machine_sources:
  41. - machine_pool_name: default-pool
  42. ```
  43. Launch it with the CLI (Node.js 22 or newer). If you're not logged in, the
  44. first command opens your browser to sign in.
  45. ```sh
  46. npx omnara agents launch --file agent.yaml \
  47. --name "Machine assistant" \
  48. --message "Report this machine's operating system and free disk space."
  49. ```
  50. Chat with the agent in your terminal with `npx omnara agents chat <agent-id>`,
  51. or open it in the dashboard to watch its tool calls and reply.
  52. <details>
  53. <summary>Launch it from your code with the TypeScript SDK</summary>
  54. Create an API key in the dashboard and export it as `OMNARA_TOKEN`, install the
  55. SDK with `npm install @omnara/sdk`, and use the org and project IDs that
  56. `npx omnara config` prints:
  57. ```ts
  58. import { readFile } from 'node:fs/promises'
  59. import { bearerToken, createOmnaraClient, openAgentEventStream, sdk } from '@omnara/sdk'
  60. const client = createOmnaraClient({ auth: bearerToken(process.env.OMNARA_TOKEN!) })
  61. const path = { orgID: 'org_...', projectID: 'proj_...' }
  62. const config = await sdk.createAgentConfig({
  63. client,
  64. path,
  65. body: { source: await readFile('agent.yaml', 'utf8'), source_format: 'yaml' },
  66. })
  67. const launched = await sdk.createAgent({
  68. client,
  69. path,
  70. body: { config: config.data.id, message: "Report this machine's free disk space." },
  71. })
  72. const agentID = launched.data.agent.id
  73. for await (const event of openAgentEventStream({ client, path: { ...path, agentID } })) {
  74. console.log(event)
  75. }
  76. ```
  77. The [quickstart](https://docs.omnara.com/quickstart) shows the same flow with
  78. the REST API.
  79. </details>
  80. To have your coding agent do the setup, give it this prompt:
  81. ```text
  82. Help me set up Omnara by following https://www.omnara.com/SKILL.md
  83. ```
  84. ### Self-host
  85. Requires Docker with Compose.
  86. ```sh
  87. git clone https://github.com/omnara-ai/omnara.git
  88. cd omnara
  89. docker compose -f compose.yaml --profile app up -d
  90. ```
  91. Open [http://localhost:8000](http://localhost:8000) and sign up. Local
  92. development prints the verification link in `docker compose logs api`, so no
  93. email provider is needed. To build from source instead of using published
  94. images, run `docker compose --profile app up -d --build`.
  95. A new instance has no models or machines yet. In the console, add a model
  96. provider and a model, connect this computer under **Machines**, and share both
  97. with your project. Sandboxes also work once your instance has a
  98. [public URL](https://docs.omnara.com/self-hosting/deployment#exposing-the-deployment-publicly).
  99. Point the CLI at your instance and log in:
  100. ```sh
  101. npx omnara config --api-url http://localhost:8000/api/v1 --issuer-url http://localhost:8000
  102. npx omnara login
  103. ```
  104. In `agent.yaml`, use your provider and model names, and replace the
  105. `machine_pool_name` entry with `machine_name: <your machine>`. Then launch it
  106. with the same command as above.
  107. This Compose setup uses local development defaults, such as built-in
  108. encryption keys and email links printed to the logs. For production, set your
  109. own keys and follow the
  110. [self-hosting guide](https://docs.omnara.com/self-hosting/deployment) and the
  111. [configuration reference](https://docs.omnara.com/self-hosting/configuration).
  112. ## How it works
  113. Your product talks to Omnara, and Omnara runs each agent with the model,
  114. tools, and machines in its config.
  115. ```mermaid
  116. flowchart TB
  117. subgraph yours["Your side"]
  118. users(["Your users"]) --> app["Your app<br/>REST API · TypeScript SDK"]
  119. team["Your team<br/>CLI · dashboard<br/>Slack · Discord · GitHub"]
  120. end
  121. subgraph omnara["Omnara"]
  122. api["API<br/>launch · input<br/>event stream · approvals"] <--> pg[("Postgres<br/>each agent's event log")] <--> worker["Workers<br/>run the agent loop"]
  123. end
  124. subgraph plug[" "]
  125. models["Models<br/>OpenAI · Anthropic<br/>OpenRouter · self-hosted"]
  126. tools["Tools<br/>built-in · skills<br/>MCP · custom"]
  127. machines["Machines<br/>sandboxes or your own<br/>laptop, VM, container"]
  128. end
  129. app --> api
  130. team --> api
  131. worker --> models
  132. worker --> tools
  133. worker --> machines
  134. classDef side fill:none,stroke:#8b949e,stroke-width:1px
  135. classDef core fill:#506FCF,stroke:#3D5BB5,stroke-width:1px,color:#ffffff
  136. classDef store fill:#3D5BB5,stroke:#2E4794,stroke-width:1px,color:#ffffff
  137. classDef plugin fill:none,stroke:#85A0E6,stroke-width:1.5px
  138. class users,app,team side
  139. class api,worker core
  140. class pg store
  141. class models,tools,machines plugin
  142. style yours fill:none,stroke:#8b949e,stroke-dasharray:4 3
  143. style omnara fill:#506FCF14,stroke:#506FCF,stroke-width:1.5px
  144. style plug fill:none,stroke:#85A0E6,stroke-dasharray:4 3
  145. linkStyle default stroke:#8b949e,stroke-width:1.5px
  146. ```
  147. - **API.** Your app, the CLI, and the dashboard all use the same REST API to
  148. launch agents, send messages, and answer approvals. Events stream back as
  149. they happen.
  150. - **Postgres.** Every step of every agent is saved here. That record is the
  151. agent's state, so any worker can pick an agent back up after a crash or
  152. restart.
  153. - **Workers.** Stateless processes that build the model context, call the
  154. model, and run tools. An agent only uses a worker while it's taking a turn,
  155. so one worker can serve many agents. Add workers to handle more turns at
  156. once.
  157. - **Machines.** Each machine runs the `omnarad` daemon, which connects out to
  158. Omnara, so agents can run commands there without any inbound ports.
  159. Omnara also uses Redis, blob storage for attachments and tool outputs, and a
  160. memory filesystem. The
  161. [architecture docs](https://docs.omnara.com/self-hosting/architecture) cover the details.
  162. ## Features
  163. ### Build agents
  164. - **[Any model](https://docs.omnara.com/organization/model-providers).** Bring
  165. your own keys for OpenAI, Anthropic, OpenRouter, Amazon Bedrock, LiteLLM,
  166. Ollama, or any compatible endpoint, including models you host yourself.
  167. - **[Tools](https://docs.omnara.com/tools/built-in).** Built-in tools for shell
  168. commands, files, web search and fetch, and asking a person a question, plus
  169. [MCP servers](https://docs.omnara.com/tools/mcp) and
  170. [custom tools](https://docs.omnara.com/tools/custom) that run in your own
  171. systems.
  172. - **[Skills](https://docs.omnara.com/tools/skills).** Package instructions and
  173. files once, attach them to any agent, and the agent loads them when it needs
  174. them.
  175. - **[Memory](https://docs.omnara.com/agents/configuration#memory-stores).**
  176. Memory stores give agents files that persist between conversations and can
  177. be shared with other agents, with read or read-write access per agent.
  178. - **[Subagents](https://docs.omnara.com/agents/configuration#subagents).** An agent
  179. can start subagents with a fresh context, check their progress, and send them
  180. new instructions. Each subagent is a full agent you can inspect.
  181. ### Run them anywhere
  182. - **[Machines](https://docs.omnara.com/machines/overview).** Machines are tools
  183. the agent uses. Install the Omnara daemon on any macOS or Linux laptop, VM, or
  184. container and your agents can run commands and edit files there, with no inbound ports or
  185. SSH keys. Or use sandboxes from twelve providers (Agent37, Arker, Blaxel, boxd, CreateOS,
  186. Daytona, E2B, Freestyle, Modal, Superserve, Tenki, Unikraft). An agent can use several machines
  187. at once (for example, a set of GPU servers) and move between them. If your
  188. laptop goes offline, the agent can continue in a sandbox and sync its work
  189. back with git.
  190. - **[Durable state](https://docs.omnara.com/agents/failure-handling).** Every step is
  191. saved, so agents pick up where they left off after crashes, restarts, and
  192. machine disconnects, and crash recovery doesn't rerun tools.
  193. - **[Live config changes](https://docs.omnara.com/events/sending-input#change-the-config-mid-conversation).**
  194. Change a running agent's model, tools, permissions, or instructions through
  195. the API. The change applies at its next model call, without restarting the
  196. conversation or redeploying.
  197. - **[Schedules](https://docs.omnara.com/api-reference/endpoints/configs-and-profiles/create-cron-trigger).**
  198. Cron triggers with time zones can message an existing agent, launch a new one
  199. from a profile, or
  200. [start a new Slack or Discord thread](https://docs.omnara.com/integrations/overview#start-a-new-thread-on-a-schedule).
  201. ### Connect them
  202. - **[Slack, Discord, and GitHub](https://docs.omnara.com/integrations/overview).**
  203. Mention the bot in Slack or Discord to start an agent in a thread, where it
  204. replies, asks questions, and requests approvals. On GitHub, an agent can start
  205. when a pull request opens or someone mentions it, then read the diff,
  206. comment, and submit reviews. To connect another service, build a
  207. [custom integration](https://docs.omnara.com/integrations/custom-integrations)
  208. on the same public API.
  209. - **[Streaming](https://docs.omnara.com/events/streaming) and
  210. [webhooks](https://docs.omnara.com/events/webhooks).** Stream every event as
  211. it happens or receive it as a webhook, and send new messages while the agent
  212. works.
  213. - **[Permissions](https://docs.omnara.com/tools/permissions).** Each tool can
  214. run immediately, ask a person first, or be blocked. The platform enforces the
  215. setting, and the agent waits until someone approves or denies the call.
  216. - **[API, SDK, and CLI](https://docs.omnara.com/api/overview).** A REST API
  217. defined in [`api/openapi/openapi.yaml`](api/openapi/openapi.yaml), a
  218. TypeScript SDK ([`@omnara/sdk`](https://www.npmjs.com/package/@omnara/sdk)),
  219. a CLI ([`omnara`](https://www.npmjs.com/package/omnara)), and an MCP server.
  220. ### Control them
  221. - **[Role-based access control](https://docs.omnara.com/organization/members)
  222. and [secrets](https://docs.omnara.com/organization/secrets).** Organization
  223. and project roles for users and API keys. Credentials for
  224. models, machines, and MCP servers are stored once and shared with each
  225. project explicitly.
  226. - **[Multi-tenant](https://docs.omnara.com/concepts).** One deployment serves
  227. many organizations, each with its own members, projects, secrets, model
  228. providers, and machines. Self-hosted operators can give every new
  229. organization default models and sandboxes, as Omnara Cloud does.
  230. - **Your data.** Self-hosted deployments keep every agent's history in your own
  231. Postgres, where you can query it for analytics, evals, and training datasets.
  232. ## Omnara vs Claude Managed Agents and OpenAI's Agents API
  233. [Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
  234. and OpenAI's [Agents API](https://developers.openai.com/api/docs/guides/agents-api/overview)
  235. are proprietary hosted services that run one company's models on that
  236. company's cloud, with your agent history stored by the vendor. Omnara does the
  237. same job as an open-source platform you can run anywhere, with any model, and
  238. keep every agent's history in your own Postgres.
  239. | | Omnara | Claude Managed Agents | OpenAI's Agents API |
  240. | --- | --- | --- | --- |
  241. | Source | Open source (Apache 2.0) | Closed | Open-source harness (Codex). The hosted service is OpenAI's. |
  242. | Models | Any compatible model | Claude | OpenAI |
  243. | Agent loop | Omnara's, works with any model | Anthropic's, built for Claude | Codex, run and updated by OpenAI |
  244. | Where the platform runs | Omnara Cloud, or your own cloud account or data center | Anthropic's cloud | OpenAI's cloud |
  245. | Where agents run | Sandboxes from many providers, or your own machines | Anthropic sandboxes, or your own sandboxes | OpenAI sandboxes, partner sandboxes, or your own machines |
  246. | Operations | Your choice: we run it on Omnara Cloud, we deploy and manage it in your own cloud (BYOC) or on premises, or you self-host it. | Managed by Anthropic. You run the sandbox side if you self-host sandboxes. | Managed by OpenAI. You run the environment if you bring your own. |
  247. | Agent history | Stored by Omnara on Omnara Cloud and queryable through the API. In your own Postgres when self-hosted. | Stored by Anthropic, readable and deletable through the API. Not currently eligible for Zero Data Retention or HIPAA BAA coverage. | Stored by OpenAI. No Zero Data Retention support. US data residency only. |
  248. | Pricing | Free to self-host. On Omnara Cloud, free with your own keys and machines, or pay as you go for our models and sandboxes. | Claude token rates plus $0.08 per active session-hour | OpenAI model rates, plus standard rates for OpenAI tools and hosted sandboxes |
  249. For production agents, choose Omnara. Of the three, it's the only one that's
  250. fully open source, runs any model, and can be self-hosted in full, and Omnara
  251. Cloud has no platform fee. A lab's service makes sense if you'll stay on that
  252. company's models and are fine with it holding your agents' history.
  253. ## Where Omnara fits
  254. | If you use | It's good for | Omnara adds |
  255. | --- | --- | --- |
  256. | Workflow builders, such as n8n or Zapier | Predictable, step-by-step automations | Open-ended agents that run code on machines and keep state for days |
  257. | Agent frameworks, such as Mastra, LangChain, or the OpenAI Agents SDK | Agent logic in your app's code | Hosting, state, machines, permissions, and integrations, with agents created and changed through an API instead of a redeploy |
  258. | Agent harnesses, such as Claude Code, the Claude Agent SDK, Codex, OpenCode, or Pi | One agent loop in a terminal or on one machine | Cloud agents that run as a service, across machines and users, started from your app, Slack, GitHub, or a schedule |
  259. | Managed agent platforms, such as Claude Managed Agents or the Agents API | Hosted agents on one company's models | The same model of hosted agents, open source, on any model, and self-hostable |
  260. ## Examples
  261. Each of these is an `agent.yaml` plus a `SKILL.md` in [`examples/`](examples),
  262. and you can deploy any of them with one prompt to your coding agent.
  263. - [In-app guide](examples/in-app-guide) shows your users how to do things in
  264. your web app, with a cursor on the page they are on.
  265. - [Slack coding agent](examples/slack-coding-agent) fixes issues you mention in
  266. Slack, Discord, or a GitHub pull request and opens a PR.
  267. - [PR review agent](examples/pr-review-agent) reviews your GitHub pull requests
  268. against a checkout of the repository and leaves inline findings.
  269. - [PR video agent](examples/pr-video-agent) records a short video of a pull
  270. request's change working in your app and posts it on the pull request.
  271. - [Dependency roll-up agent](examples/dependency-rollup-agent) rolls your
  272. Dependabot pull requests into one pull request a day that passes CI.
  273. - [SRE agent](examples/sre-agent) investigates production problems such as a
  274. 5xx spike.
  275. - [Browser agent](examples/browser-agent) works in a real browser on
  276. long-running tasks.
  277. - [PostHog analytics agent](examples/posthog-analytics-agent) compares
  278. yesterday's product usage with the 7-day average and reports what changed.
  279. - [Reddit](examples/reddit-signal-agent), [X](examples/x-signal-agent), and
  280. [LinkedIn](examples/linkedin-signal-agent) signal agents summarize the last
  281. 24 hours of posts about a topic you pick.
  282. - [Video generation agent](examples/video-generation-agent) makes short videos
  283. from a brief.
  284. There are also code samples for a [CLI chat app](examples/cli-agent) built on
  285. the TypeScript SDK, [custom tools over webhooks](examples/custom-tool-webhook),
  286. and a [SharePoint filesystem mount](examples/sharepoint-mount).
  287. ## Use Omnara from your coding agent
  288. **MCP server.** Connect Claude Code, Codex, Cursor, or any MCP client that
  289. supports OAuth to `https://app.omnara.com/mcp` to launch and manage Omnara
  290. agents. You sign in through the browser, so there are no tokens to paste. In
  291. Claude, add it from the
  292. [connectors directory](https://claude.ai/directory/app-omnara-com). Omnara is
  293. also listed in the official MCP Registry as `com.omnara/omnara`.
  294. ```sh
  295. claude mcp add --transport http omnara https://app.omnara.com/mcp
  296. codex mcp add omnara --url https://app.omnara.com/mcp
  297. ```
  298. Then sign in with `/mcp` in Claude Code or `codex mcp login omnara` in Codex.
  299. See [Connecting MCP clients](https://docs.omnara.com/api/authentication#connecting-mcp-clients).
  300. **CLI.** [`omnara`](https://www.npmjs.com/package/omnara) manages agents,
  301. profiles, machines, model providers, secrets, skills, and cron triggers from
  302. your terminal or your coding agent's shell. Run `npx omnara --help` to start.
  303. **Setup skill.** [`skills/setup-omnara-agent`](skills/setup-omnara-agent/SKILL.md),
  304. also served at [omnara.com/SKILL.md](https://www.omnara.com/SKILL.md), walks a
  305. coding agent through setting up Omnara for your project.
  306. **Docs for LLMs.** [docs.omnara.com/llms.txt](https://docs.omnara.com/llms.txt).
  307. ## FAQ
  308. **What is Omnara?** The open-source managed agent platform for running AI
  309. agents in production on any model and any machine, hosted on Omnara Cloud or
  310. self-hosted.
  311. **How is Omnara different from Claude Managed Agents and OpenAI's Agents API?**
  312. Those are proprietary services that run one company's models and store your agents'
  313. history on that company's cloud. Omnara is open source under Apache 2.0, works
  314. with any model on your own keys, runs on any machine, and can be self-hosted in
  315. full, so the agent loop and its history stay on your infrastructure.
  316. **How much does it cost?** Nothing to self-host. Omnara Cloud has no platform
  317. fee. You can bring your own model keys and machines for free, or pay as you go
  318. for our models at provider token rates and our sandboxes by active time and
  319. retained storage. See [pricing](https://www.omnara.com/pricing).
  320. **Can I self-host it?** Yes. Run it with Docker Compose locally, then follow
  321. the [self-hosting guide](https://docs.omnara.com/self-hosting/deployment) for
  322. production. Or we can deploy and manage it for you in your own cloud (BYOC) or
  323. on premises: [book a call with the founders](https://cal.com/ishaan-sehgal-8kc22w/chat-with-omnara). The API, CLI, SDK, and config format
  324. are the same on Omnara Cloud and self-hosted deployments.
  325. **Which models work?** Any model behind an OpenAI Responses, OpenAI Chat
  326. Completions, or Anthropic Messages compatible endpoint, including OpenAI,
  327. Anthropic, OpenRouter, Amazon Bedrock, LiteLLM, and Ollama.
  328. ## Development
  329. Source development requires the Go version declared in [`go.mod`](go.mod),
  330. Node.js 24 or newer with Corepack, ripgrep, and Docker with Compose. Run the
  331. fast repository gate with `make verify`. See [CONTRIBUTING.md](CONTRIBUTING.md)
  332. for the full test suite, generated-code workflows, and pull request
  333. expectations.
  334. ## Community
  335. [Discord](https://discord.gg/Dc46sYk6e3) ·
  336. [GitHub Issues](https://github.com/omnara-ai/omnara/issues) ·
  337. [X](https://x.com/omnaraai) ·
  338. [Security](SECURITY.md)
  339. ## License
  340. [Apache License 2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.