openmachine

<div align="center"> # Open Machine ### One MCP. Every machine. Real execution. **An open-source runtime that lets your existing AI agent operate your machines.** <a href="openmachine/skills/overview/SKILL.md"><img src="https://img.shields.io/badge/MCP-Compatible-5C4EE5?style=flat-square" alt="MCP compatible"></a> <a href="https://www.npmjs.com/package/openmachine"><img src="https://img.shields.io/npm/v/openmachine?style=flat-square" alt="npm version"></a> <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.12%2B-3776AB?style=flat-square&amp;logo=python&amp;logoColor=white" alt="Python 3.12+"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-43A047?style=flat-square" alt="MIT License"></a> <a href="https://discord.gg/TAxEWV7fgZ"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&amp;logo=discord&amp;logoColor=white" alt="Join Discord"></a> <a href="https://x.com/OpenMachineAI"><img src="https://img.shields.io/badge/X-Follow-181717?style=flat-square&amp;logo=x&amp;logoColor=white" alt="Follow on X"></a> <img src="assets/openmachine-banner.png" width="1200" alt="Open Machine — Your AI. Your machines. Connect any AI to your context, and get things done on your machines." /> </div> https://github.com/user-attachments/assets/f22519e6-e3ad-405c-a725-9ce53a642bcc **Open Machine (OM Core)** connects your existing AI Agents to your machines through a local-first MCP runtime. Your AI plans the work; OM provides permission-controlled tools to carry it out and return results. [Documentation](https://openmachinelabs.github.io/openmachine/) · [Getting started](docs/getting-started/installation.md) · [GitHub Issues](https://github.com/OpenMachineLabs/openmachine/issues) · [Contributing](CONTRIBUTING.md) · [Code of Conduct](CODE_OF_CONDUCT.md) ## What you can do | Capability | Guide | | --- | --- | | Local machines and context | [Inspect the intended project and environment](docs/features/local-machine.md) before acting. | | Workspace files and worktrees | [Read, search and apply guarded edits](docs/features/workspace.md) in the intended tree. | | Native commands and terminals | [Run commands, retrieve original results and verify cleanup](docs/features/execution.md). | | Remote Linux over SSH | [Prepare workers, pin identity and operate remote projects](docs/features/ssh.md). | | Persistent tasks | [Keep goals, stages and evidence; continue original work explicitly](docs/features/tasks.md). | | GitHub | [Use scoped repositories, Issues, PRs, reviews, Projects and Releases](docs/features/github.md). | | Browser subtasks | [Delegate a bounded web task](docs/features/browser.md) through a compatible, authorized native Codex installation. | | Skills | [Discover packaged operating guides and reviewed external Skill roots](docs/features/skills.md). | | Service and runtime | [Manage the macOS service, retained updates and compatible rollback](docs/features/service.md). | Tasks preserve progress and observe admitted work; they **do not automatically wake ChatGPT or execute the next stage after a chat disconnects**. Optional integrations have separate prerequisites. See [current limitations](docs/introduction/limitations.md). ## Quick start **macOS Apple Silicon (macOS 13+, Node.js 20+)** ```bash npm install -g openmachine@latest openmachine ``` On first run, choose an existing project folder containing a readable file (such as `README.md`). Open Machine sets up Core and starts a managed macOS user service. Check it with `openmachine status`. For other macOS and Linux setups, [build Core from source](docs/getting-started/installation.md) (Python 3.12+, compatible SQLite, and Git). Windows is not supported. To use ChatGPT, [connect it separately](docs/getting-started/connect-chatgpt.md) and [verify the connection](docs/getting-started/verification.md). The npm installer does not set up an MCP tunnel or approve client tools. Command execution and workspace writes are **disabled by default**. The npm `openmachine` command manages setup and service status; `openmachine core ...` runs the underlying Python CLI. See the [npm setup guide](docs/getting-started/npm-macos.md). This is an early-development release, not a stable 1.x release. **Updating?** Updating the npm package does not automatically update the running Core service. See [Updates](docs/getting-started/updates.md). <div align="center"> <table aria-label="Open Machine community"> <tr> <td align="center" width="520"> <a href="https://discord.gg/TAxEWV7fgZ"> <img src="https://img.shields.io/badge/Discord-Join%20the%20Community-5865F2?style=for-the-badge&amp;logo=discord&amp;logoColor=white" height="42" alt="Join the Open Machine Discord community" /><br /> <strong>Join the Open Machine Community</strong> </a><br /> _{Discord · Q&amp;A · Show and Tell} </td> </tr> </table> </div> ## How it works <p align="center"> <img src="assets/openmachine-workflow.png" alt="You request a task in an AI Agent, which plans and uses OM Core to perform authorized actions on your machines. Results return to the AI Agent. Gmail, Slack, GitHub, and Personal Context are shown as context sources above OM, with context updates flowing back."> </p> Your request flows from **AI Agent → OM Core → your machines**, and execution results return to your AI. OM exposes the approved tools; it does not replace your AI agent. The **Personal Context layer and automatic context updates** in the diagram illustrate planned functionality for bringing data from sources such as Gmail and Slack into OM and keeping it up to date as tasks are completed. ## Documentation The [user documentation](https://openmachinelabs.github.io/openmachine/) covers every important released Core capability. Start with [requirements](docs/introduction/requirements.md), [installation](docs/getting-started/installation.md), [configuration](docs/getting-started/configuration.md) and [layer-by-layer verification](docs/getting-started/verification.md). For existing installations, use [updates](docs/getting-started/updates.md), the [configuration reference](docs/configuration/reference.md) and [troubleshooting](docs/troubleshooting.md). The [CLI](docs/reference/cli.md) and [MCP tools](docs/reference/tools.md) references link to detailed operating contracts without duplicating them. The [operating Skill](openmachine/skills/overview/SKILL.md) and [Skills directory](openmachine/skills/README.md) remain the technical starting points for AI agents. A source checkout, published release, running runtime and approved client catalog can differ; read the running version's guide before acting. ## Security Open Machine is a trusted, single-operator native runtime, **not an OS sandbox** or multi-tenant executor. Native commands can access resources beyond read-only tool scopes. Keep the listener private, grant access deliberately, and remember that files and logs returned to an AI client may leave your machine. Cancellation and software rollback do not undo completed effects. Read [Security and data](docs/configuration/security.md) before enabling execution or remote access; never put secrets in prompts, command arguments or committed configuration. Report vulnerabilities privately via the [Security Policy](SECURITY.md). ## Contributors Thanks to everyone who contributes to Open Machine. <a href="https://github.com/OpenMachineLabs/openmachine/graphs/contributors"> <img src="https://contrib.rocks/image?repo=OpenMachineLabs/openmachine&amp;max=1000&amp;columns=12" alt="Open Machine GitHub contributors" /> </a> [View GitHub contributors](https://github.com/OpenMachineLabs/openmachine/graphs/contributors) · [Contribute to Open Machine](CONTRIBUTING.md) · [Maintainer guide](MAINTAINERS.md) ## License [MIT](LICENSE) © 2026 OpenMachineLabs.