Snaild.it listens to your repository's webhooks and, on each event, runs codex exec on your machine with a prompt you wrote — so it reviews pull requests, triages issues, and pushes fixes exactly how you tell it to. It acts through the gh CLI as a GitHub App you own, on your Codex subscription: no API keys, no per-token billing, no backend to host.

[!CAUTION] Snaild.it runs codex exec on your machine — an AI agent with write access to the working directory and network access. Use it deliberately:

• A bad (or malicious) prompt can modify your checked-out code or exfiltrate data over the network.
• On a public repo, anyone who opens an issue or PR feeds text into the agent's prompt — a prompt-injection path to your machine. Start with private repos you trust.
• Scope the GitHub App's permissions to the minimum, and don't run it on a machine holding secrets you can't afford to leak.

Quickstart

npx snaildit start

This opens a local dashboard with three steps: create a GitHub App you own, pick which repositories it can touch, and connect Codex. After that it runs your automations from your machine.

Requirements

• Node.js >= 24.15
• A Codex subscription (logged in via the dashboard)
• The gh CLI on your PATH — Snaild.it hands it a short-lived GitHub App token per run (via GH_TOKEN), so you don't authenticate gh yourself.
• macOS or Linux (Windows isn't supported yet)

(cloudflared is downloaded automatically on first run.)

From source

git clone https://github.com/felipelincoln/snaildit
cd snaildit
npm install
npm run build
npm start