Godspeed
by fortun8te
README.md
<p align="center"><img src="assets/app-icons/godspeed-1024.png" width="88" alt="Godspeed's red glass cursor icon"></p>
# Godspeed: macOS computer use MCP
Godspeed lets Codex, Claude Code, and other MCP clients read and control Mac apps and Chrome. It uses macOS Accessibility for native controls, can run batches with a check at the end, and keeps its software cursor separate from your pointer.
<p align="center">
<a href="https://github.com/fortun8te/godspeed/releases/tag/v1.1.12"><strong>Download for Apple Silicon</strong></a>
· <a href="docs/INSTALL.md">Setup guide</a>
· <a href="docs/benchmarks.md">Benchmarks</a>
· <a href="CHANGELOG.md">Changelog</a>
</p>
[](https://github.com/fortun8te/godspeed/releases/download/v1.1.12/godspeed-demo.mp4)
[Watch the 12-second demo](https://github.com/fortun8te/godspeed/releases/download/v1.1.12/godspeed-demo.mp4). It uses live Calculator and TextEdit window captures and a separate capture of the Godspeed cursor. [Remotion source](https://github.com/fortun8te/godspeed/releases/download/v1.1.12/godspeed-remotion-source.zip)
## Install
**Apple Silicon · macOS 14 or later.** The app is a development preview with ad hoc signing. [Permissions and signing guide](docs/INSTALL.md#signing-and-permissions)
```sh
curl -fLO https://github.com/fortun8te/godspeed/releases/download/v1.1.12/install-godspeed.sh && bash install-godspeed.sh
```
1. Open **GODSPEED.app** from `~/Applications` and follow the permission screen.
2. Connect your MCP client and start a fresh session.
```sh
# Codex
codex mcp add godspeed -- "$HOME/.local/bin/godspeed-mcp"
# Claude Code
claude mcp add --scope user godspeed -- "$HOME/.local/bin/godspeed-mcp"
```
3. Ask your agent to read a disposable Calculator window before trying an action.
[Check the connection](docs/INSTALL.md#first-mcp-check) · [Set up Chrome](docs/INSTALL.md#chrome-setup) · [Build from source](docs/INSTALL.md#build-from-source)
## What Godspeed can do
- **Read the current target.** Native tools use macOS Accessibility data. Query by label for a small result, or read the window when you need the surrounding controls. Screenshots and visual targeting are available with Screen Recording permission.
- **Send related steps in one batch.** Bind actions to the observed window or control, then set a visible result to check with `done_when`. A compact reply can keep only the information needed for the next decision. Detailed recovery receipts stay available when input delivery is uncertain.
- **Check before continuing.** Godspeed separates action dispatch from evidence that the action worked. Resume tokens keep unfinished native steps tied to their saved window and preserve the original step numbers across repeated resumes.
- **Give each agent a visible cursor.** The software cursor shows where a client is working. Client names and cursor effects are configurable. The [tool guide](docs/GODSPEED.md#cursor-and-client-names) explains naming, visual feedback, and background limits.
- **Use local decisions when needed.** The optional GSD1 helper exposes Action, Read, and Recover as advisory models through `local_decision`. They share one tuned checkpoint slot. Godspeed’s tool checks still govern dispatch and verification. [Model setup](experiments/LocalHelper/README.md) · [GSD1 adapter weights](https://github.com/fortun8te/godspeed/releases/tag/gsd1-v0.1.0)
## Can it run while my Mac is locked?
The public build requires an awake, unlocked desktop for app controls, Chrome, and screenshots. The MCP server can still answer discovery requests while the Mac is awake and the server is running.
## Examples
| Ask your agent | Godspeed uses |
| --- | --- |
| “Multiply 1234 by 56 in Calculator and verify the display.” | A native batch and a checked result |
| “Read the headings of these public pages in Chrome.” | The browser bridge and a bounded parallel read |
| “Move the selected control to the marked position in this window, then check the result.” | A targeted drag and a separate outcome check |
The default trajectory logs record timings and outcome metadata locally. See the [trace controls](docs/GODSPEED.md#local-traces) for content logging and what to review before sharing a trace.
See [benchmarks](docs/benchmarks.md) for reproducible payload measurements and the public CUA Driver, Codex Computer Use, and Aside comparison. Godspeed’s internal fixtures have a different workload from that public suite.
## Project
[Releases](https://github.com/fortun8te/godspeed/releases) · [Installation](docs/INSTALL.md) · [Tool guide](docs/GODSPEED.md) · [Changelog](CHANGELOG.md) · [Issues](https://github.com/fortun8te/godspeed/issues)
Godspeed’s app source is [MIT-licensed](LICENSE) and based on [Open Computer Use](https://github.com/iFurySt/open-computer-use). GSD1 model weights use the LFM Open License v1.0. [Third-party notices](THIRD_PARTY_NOTICES.md)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues