About Omg.dev
Omg.dev is an MCP server published by BennyKok in the Agents category: omg.dev — Remote control for claude, codex, cursor, opencode, pi, grok, jcode with mobile client.
The repository has 554 stars and 41 forks, with the last commit yesterday. Recent commit activity is the strongest signal that reported issues will get attention.
Install
From source
git clone https://github.com/BennyKok/omg.devThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (56)
computer_clickClick an element. Prefer
Parameters not published.
computer_navigatePoint the browser on the desktop at a URL and wait for it to load. Returns the final URL and page title. The tab is brought to the front, so a person watching the screen sees the page you opened.
Parameters not published.
computer_pastePaste text into whatever currently has focus. Unlike computer_type this goes through the real desktop clipboard with a trusted Ctrl+V, so paste handlers fire — use it for long text and for fields that react to paste, such as verification-code inputs that split the digits. Click the field first. The text stays on the desktop clipboard afterwards.
Parameters not published.
computer_pressPress a named key, for example Enter, Tab, Escape, Backspace or an arrow key. Use this to submit a form or move focus after computer_type.
Parameters not published.
computer_readThe visible text of the current page. Cheaper and more reliable than a screenshot when you need content rather than layout; take a screenshot when you need to see how something looks or where it sits.
Parameters not published.
computer_screenshotA PNG of the current page, returned as an image you can look at. Use when layout, rendering or the position of an element matters.
Parameters not published.
computer_startBring up the shared desktop: a virtual display, a window manager, the screen stream, and a browser. Idempotent — starting an already-running computer returns its current status rather than a second desktop.
Parameters not published.
computer_statusWhether the shared desktop is running, its screen size, and which session currently holds it. Also reports missing system packages and the exact command that installs them. Call this before any other computer tool.
Parameters not published.
computer_stopShut the desktop down and free its resources. Anything open on the screen is lost, so prefer leaving it running if a person may still be watching.
Parameters not published.
computer_typeType into whatever currently has focus. Click the field first. This inserts text directly rather than simulating individual keystrokes, so use computer_press for Enter, Tab and other named keys.
Parameters not published.
Show all 56 tools
omg_ask_userAsk the human a question when a decision genuinely needs their call (irreversible or risky actions, ambiguous intent, competing trade-offs). Fire-and-forget: raises a push notification and returns immediately with the question id. Do NOT wait, poll, or block — the user may answer hours later. Their answer is pushed back into this session as a new user message starting with [ask-user answer <id>].
Parameters not published.
omg_browser_login_statusCheck this session
Parameters not published.
omg_capabilitiesBootstrap the omg.dev product workflow. Returns the current capability contract, when to use each omg.dev feature, and whether this long-lived session launched with an older capability version. Call this when deciding how to present completed work or when an expected omg.dev tool seems unavailable.
Parameters not published.
omg_close_sessionClose an omg.dev runtime session that is clearly finished. Omit sessionId to close your own session when the user or your task asks for it: it closes after your current turn ends, so write your final reply in this turn. A message from the user before then keeps it open. Bot conversations cannot close themselves. To close another session, resolve its exact id with omg_list_sessions first.
Parameters not published.
omg_compose_auto_agentTurn one freeform description of something to watch into a complete auto agent draft (name, cron schedule, and an expanded prompt), grounded in the given repo when supplied. This does NOT save it — review the draft, then persist it with omg_save_auto_agent. Prefer this over hand-writing a prompt and schedule.
Parameters not published.
omg_create_owned_botCreate one persistent bot for the same assigned user as the calling bot. The server derives ownership and execution workspace from the authenticated runtime session and enforces a hard limit of 10 bots per user. Agent, model, and thinking level use the existing catalogs. The new bot inherits the caller
Parameters not published.
omg_create_projectCreate and register a new project folder with Git and a committed README. Returns repo.cwd for building. When the calling chat has no project, it moves into the new project after the current turn ends (sessionMove.status is after_turn); until then, use repo.cwd explicitly. Existing folders are never overwritten. Inspect omg_list_repos after an uncertain response before retrying.
Parameters not published.
omg_create_subagentCreate a managed runtime child session using omg.dev subagent. ${OMG_SUBAGENT_PRIORITY} Use this when the user explicitly asks to use a subagent, spawn another agent, or have another agent work on a task. The child is instructed to report progress and exactly one terminal state back to this parent session.
Parameters not published.
omg_delegate_backend_taskCreate an omg.dev subagent for backend, server, API, database, infrastructure, and correctness-focused implementation work. ${OMG_SUBAGENT_PRIORITY} Defaults to the codex harness and wraps the delegated prompt with the omg.dev sub-agent operating contract. See omg_list_models delegationGuidance.backend for prompt-shaping guidance.
Parameters not published.
omg_delegate_design_taskCreate an omg.dev subagent for design, frontend UX, visual polish, layout, styling, accessibility, and interaction-state work. ${OMG_SUBAGENT_PRIORITY} Defaults to the claude harness and wraps the delegated prompt with the omg.dev sub-agent operating contract. See omg_list_models delegationGuidance.design for prompt-shaping guidance.
Parameters not published.
omg_delegate_to_agentDelegate work to another coding agent by creating an omg.dev subagent child session. ${OMG_SUBAGENT_PRIORITY} Prefer this tool over sending a normal message whenever the user says to use another agent, ask Claude/Codex/OpenCode/Grok/Cursor, spin up an agent, or have a subagent do something. For design/frontend polish use omg_delegate_design_task. For backend/server/API work use omg_delegate_backen
Parameters not published.
omg_delete_artifactPermanently delete an artifact owned by this omg.dev session. HTML refresh schedules and active refresh processes are stopped before the artifact is removed.
Parameters not published.
omg_delete_auto_agentPermanently delete a scheduled auto agent. To pause one instead, call omg_save_auto_agent with its id and enabled:false — deletion is not reversible.
Parameters not published.
omg_display_fileGive the user a local file in the omg.dev session transcript: a PDF, an audio clip, a CSV, a log, an archive, or any other document. The transcript shows a named card with its size and a download button; the file is downloaded, not rendered in place. Use omg_display_image for screenshots and omg_display_video for recordings, which do render inline.
Parameters not published.
omg_display_imageDisplay a local image file, such as a screenshot captured while testing, in the omg.dev session transcript. This call is the only way an image reaches the user: a markdown image link or a file path in your reply does not render. Call it once per image before your reply refers to the image. Do not run it in parallel with a long command; the image appears only when the call finishes. Leave sessionId
Parameters not published.
omg_display_videoDisplay a local video file, such as a screen recording captured while testing, inline in the omg.dev session transcript.
Parameters not published.
omg_find_sessionsFind durable omg.dev sessions, including ended sessions no longer present in tmux or the process table. Filters compose, results are newest-first, and text searches titles plus normalized transcript content.
Parameters not published.
omg_get_session_messagesRead recent or full normalized transcript messages for a session.
Parameters not published.
omg_get_session_treeReturn runtime sessions grouped by parent/child relationship.
Parameters not published.
omg_inputAsk the human only when an irreversible, external, or ambiguous decision genuinely requires their answer. Do not use this to check in, report progress, confirm the next step, ask what to do next, or approve work already in scope: do that work and report it. When you do need their choice, give 2-4 short options. It is fire-and-forget: raises a push notification and returns immediately with a questi
Parameters not published.
omg_list_auto_agentsList the scheduled auto agents on this box, with their cron schedule, backend, enabled state, and last run. Use this before editing or running one so you can pass its exact id.
Parameters not published.
omg_list_findingsRead what the auto agents have reported. Findings carry their reasoning, a severity, and an occurrence count for repeats. Defaults to open findings only.
Parameters not published.
omg_list_modelsList provider/model options that MCP can use when delegating work to omg.dev sub-agents.
Parameters not published.
omg_list_my_routinesList the scheduled routines this bot owns — name, cron schedule, enabled state, last fired.
Parameters not published.
omg_list_owned_botsList this persistent bot
Parameters not published.
omg_list_reposList repositories omg.dev can launch sessions in.
Parameters not published.
omg_list_sessionsList live omg.dev runtime sessions, optionally filtered to children of a parent session.
Parameters not published.
omg_list_subagentsList child sessions, optionally for one parent session.
Parameters not published.
omg_list_threadsList the team chat threads on this machine, newest first: id, title, project and the last message. A person references one as [#Title](omg:thread_<id>).
Parameters not published.
omg_publish_artifactPublish a self-contained HTML artifact (report, data view, live dashboard) into the omg.dev session transcript. Re-publishing with the same id updates one card in place. Optionally attach an executable server-side refresh script inside the owning session cwd; omg.dev invokes the path with explicit argv (never a shell), validates complete HTML output, and preserves the last good version on failure.
Parameters not published.
omg_read_threadRead a team chat thread: its people and its messages, oldest first. A reply carries replyTo, the id of the message it answers.
Parameters not published.
omg_refresh_artifactRun the owning HTML artifact
Parameters not published.
omg_reparent_sessionMove an existing session under a different parent session, or detach it to a root. The child must be omg-managed; the move is rejected if it would create a cycle. The new parent receives a queued notice after the move. Check parentNotified and notificationError for delivery failures.
Parameters not published.
omg_request_browser_loginAsk the user to sign in to a website in the omg iOS app and approve transfer to this Computer
Parameters not published.
omg_request_secretAsk the user for one secret (an API key, token or internal URL) through a password field in omg.dev. The value is saved to the .env file in cwd and you get a message with the key name only. Call it once per key, then end your turn and wait for the [env-set KEY] message. Never ask the user to paste a key in chat, and never echo a secret value back.
Parameters not published.
omg_run_auto_agentTrigger one immediate run of an auto agent, outside its schedule. Returns as soon as the run is dispatched — it is fire-and-forget, so do not poll. Any finding it produces shows up via omg_list_findings.
Parameters not published.
omg_save_auto_agentCreate a scheduled auto agent, or update an existing one by passing its id. Saving is an upsert: omit id to create, pass the id from omg_list_auto_agents to edit in place. The agent runs headless on its cron schedule and reports at most one finding per run.
Parameters not published.
omg_schedule_routineCreate a recurring check that nudges you, in this same conversation, on a cron schedule.
Parameters not published.
omg_send_message_to_peerDurably enqueue one message to a same-owner persistent bot from omg_list_owned_bots. The server derives sender bot identity and assigned user from the authenticated live runtime session. Use replyToMessageId only for an explicit reply to a peer message you received; the server preserves its correlation and enforces reply depth. Model output is never forwarded and no automatic reply occurs.
Parameters not published.
omg_send_session_messageSteer or queue a message to an existing omg.dev session.
Parameters not published.
omg_send_thread_messagePost a message to a team chat thread as omg: in the thread, or in the replies of one message (replyTo). Everyone in the thread is notified. Attach local pictures, videos or files with mediaPaths. Write like a teammate in a chat: short and plain.
Parameters not published.
omg_send_to_originSend text and/or session-owned image/video artifacts back to the channel that launched this omg.dev session. The channel adapter owns final delivery (for example iMessage via Blooio); omg.dev never receives phone numbers or transport credentials.
Parameters not published.
omg_shipPost a verified result in the omg.dev Shipped feed. Publishing is not a lifecycle event: the source session stays live for chat or follow-up. A Shipped post does not itself prove production deployment; when deployment was requested, verify it before you claim it. Never use this for planning, partial, blocked, or still-unverified work. Write it like a launch tweet: a punchy headline + at most 1-2 s
Parameters not published.
omg_unschedule_routinePermanently delete one of your own scheduled routines. Only available inside a bot conversation.
Parameters not published.
omg_update_findingMove a finding through its lifecycle. Mark
Parameters not published.
omg_update_selfUpdate only the calling persistent bot
Parameters not published.
Ask AI
✦
Ask AI about Omg.dev
Powered by Claude
Ask about Omg.dev — answers draw on its README.
Security checks
Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
Releases
v0.6.361v0.6.361 · 6 Nov 2026Full Changelog: https://github.com/BennyKok/omg.dev/compare/v0.6.360...v0.6.361
v0.6.359v0.6.359 · 6 Nov 2026What's Changed fix(snapfork): install nested bun projects in the base so forks share them by @BennyKok in https://github.com/BennyKok/omg.dev/pull/497 docs(librarian): refresh STATE.md (2026-11-05) by @BennyKok in…
v0.6.358v0.6.358 · 5 Nov 2026What's Changed docs(librarian): refresh STATE.md (2026-11-04) by @BennyKok in https://github.com/BennyKok/omg.dev/pull/495 security: remove a production host address and the tailnet name by @BennyKok in…
v0.6.357v0.6.357 · 5 Nov 2026What's Changed docs(librarian): refresh STATE.md (2026-11-01) by @BennyKok in https://github.com/BennyKok/omg.dev/pull/487 docs(librarian): refresh STATE.md (2026-11-03) by @BennyKok in https://github.com/BennyKok/omg.dev/pull/492…
v0.6.356v0.6.356 · 1 Nov 2026Full Changelog: https://github.com/BennyKok/omg.dev/compare/v0.6.355...v0.6.356
README
omg.dev
Build your ideas on the go.
Give your agents a task from your phone. Get a notification when the result is ready. Your laptop can stay closed.
Open-source harness for Claude Code, Codex, and other coding agents. Install it yourself for free.
Free or hosted
| Self-host | Hosted on omg.dev | |
|---|---|---|
| Price | Free (MIT) | Free plan to try. Paid plans from $19/mo. |
| Runs on | Your Mac or Linux machine | A cloud computer we run for you |
| You manage | Install and updates | Nothing |
| Start | Install below | app.omg.dev · Pricing |
Both use the agent subscription you already pay for, such as Claude or ChatGPT.
Install on your computer
bun install --global @omg-dev/cli && omg computer setup
Open http://localhost:8766.
Debian, Ubuntu, or macOS. No omg.dev account. On Linux, a normal user with
sudo. Do not run as root.
Open Settings → Coding agents. Supports Claude Code, Codex, Grok, Cursor, omg agent, OpenCode, fx, Muse, DeepSeek, Devin, Jcode, Copilot, and Pi. Sign in with the agent provider.
Try the macOS desktop preview
Apple Silicon. Ships with its own runtime. No separate CLI install.
Unsigned preview. Control-click the app, choose Open, then Open again. Or System Settings → Privacy & Security → Open Anyway.
Use the hosted version
No local server. Runs in the cloud, opens in the browser. This is a paid service with a free plan. See pricing.
Start with a hosted Computer →
What you get
- Several coding-agent sessions in parallel.
- Transcripts and follow-ups in the web UI.
- Chat, Bots, Schedules, and Notifications in one place.
- Managed sessions keep running when the UI disconnects.
- Your existing agent subscriptions or API keys.
Remote access and security
The local server binds to 127.0.0.1 and has no built-in authentication. Do
not expose it to the public internet.
Phone access through Tailscale:
OMG_TAILSCALE_SERVE=1 omg computer setup
Sign in to Tailscale if setup asks. See remote access and SECURITY.md before you share access.
Manage a local install
omg computer status # check the install
omg computer update # install the latest release
omg doctor # create a sanitized diagnostic report
omg computer uninstall # remove omg.dev and keep sessions and config
Develop from source
git clone https://github.com/BennyKok/omg.dev.git
cd omg.dev
bun install
cp .env.example .env
bun run serve
API is at http://localhost:8766. For the UI, run
cd web && bun run dev in another terminal. bun run serve alone needs a
built web/dist.
Desktop shell: desktop development.
Read CONTRIBUTING.md before a pull request. Help: Discord.
License
README fetched from the repository 2 days ago. The original is authoritative.