gentic) that you deploy on a private server or VM. Once running, it continuously polls the Gentic API for issues whose status has been moved to Todo, claims one at a time, clones the associated GitHub repository into a local work directory, and drives an AI coding agent — Claude Code or Codex — through the Agent Client Protocol. When the agent finishes, it commits its changes and opens a pull request against your repository automatically. You never need to manually invoke an AI tool for individual issues; the worker handles the full cycle from poll to PR.
How it works
When you move an issue from Draft to Todo in the Gentic web app, the API setsrun_status = 'queued'. On its next poll cycle, the agent worker claims that issue, creates a fresh clone of its configured repository, and runs the issue’s assigned agent provider. The worker streams assistant output back into the issue transcript in real time and marks the run completed once the agent goes quiet. If you send a follow-up message to an issue whose run has already ended, the API re-queues it and the worker resumes the same Agent Client Protocol session — preserving the full conversation context.
Deployment options
You can deploy the agent worker in two ways. Choose the option that fits your server environment best.Standalone Binary
Download a prebuilt, self-contained binary from GitHub Releases. No Node.js, pnpm, or
node_modules required on the target machine. Recommended for production servers.From Source (Node.js)
Clone the repository, install dependencies with pnpm, and run the worker with
pnpm --filter @gentic/gentic start. Best for development or environments where you already manage a Node.js toolchain.Prerequisites
Review these requirements before installing the agent worker. Which prerequisites apply to you depends on your chosen deployment method.Node.js 20+ & pnpm 11.9.0+
Required only when running from source. Not needed when using the standalone binary.
Bun (build-time only)
Required only if you want to compile the standalone binary yourself from source. Not needed on the target machine that runs the binary.
Git & SSH access
The worker clones repos over SSH by default. Add an SSH deploy key or machine user key to every repository Gentic will access.
AI agent credentials
Claude Code credentials must be present in the worker environment. Codex must be installed and authenticated separately; set
CODEX_PATH if it is not on PATH.Security note
Run the agent worker on a private server or VM. It is a background polling process — not a web server. Do not expose it as a public HTTP endpoint. Keep yourGENTIC_API_KEY and SSH credentials secret and limit access to the machine accordingly.
Next steps
Installation
Install the standalone binary or run from source, and set up Git authentication.
Configuration
Configure your API key, API URL, and other environment variables.
Service Management
Start, stop, and restart the worker as a managed system service.