
kombinat
π Dead simple, lightweight engine for 24/7 background AI agents. Works with your Claude, Codex or any other subscription. Comes with remote control, UI andβ¦
Install with your AI
Paste into Claude Code, Cursor, or any agent β it reads the repo and wires the tool into your project.
Install and set up kombinat (git-clone project) into my current project. Found on https://claudeers.com/kombinat Repo: https://github.com/Danilqa/kombinat Homepage/docs: https://danilqa.github.io/kombinat/ Detected install method: git-clone β git clone https://github.com/Danilqa/kombinat Category: devtools. Platforms: cli, api, web, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/Danilqa/kombinat
// compatibility
| Platforms | cli, api, web, mobile |
|---|---|
| Operating systems | β |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |
Background AI agents that run routines defined in your repository, 24/7. They run on your machine under launchd with Claude Code, Codex or any other CLI agent, using your normal subscription login.
Ready to use in your organisation or at home.
- Version-controlled by design. Merge a
.mdfile and the change is picked up automatically. - Minimal and lightweight. Run one command on a machine that is on 24/7. Easy for non-engineers to contribute to.
- Your own integrations. Agents use your local environment as is, including skills, MCP, browser control and more.
- Cheap. Works with your existing Claude or Codex subscription. Don't burn your money on tokens.
- Remote control. Debug and monitor your remote machine from your mobile on your commute.
- Battle-tested. Polished on real use cases across engineering, design, product management and GTM.
Ideas:
- Post-release monitoring. Checks Intercom, Sentry, Grafana and the logs for problems in code shipped over the last 3 days, raises an alert and opens PRs with fixes.
- On-call engineer. Investigates production incidents and opens PRs to fix them.
- Flaky E2E test fixer.
- Dead code and feature flag clean-up.
- Picking up bug fixes.
- Monitoring support chats for product signals.
Quickstart:
-
Add Kombinat to the repository that will hold your routines.
pnpm add @danilqa/kombinat # with npm: npm install @danilqa/kombinat -
Add your routines as
.mdfiles in aroutines/folder next topackage.json, see Writing a routine. Changes are picked up on the next check, no restart needed. Agents run with your usual setup, so your global skills, MCP servers andCLAUDE.mdare picked up.my-routines-or-project/ βββ routines/ β βββ fix-e2e-tests.md βββ package.json -
Start from that folder.
pnpm kombinat serve # or: npx kombinat serveIt runs in this terminal. To keep it running in the background and after reboots, stop it and run
pnpm kombinat installinstead, see Setup. -
Monitor and debug runs in the dashboard at http://localhost:7433, or in the terminal with
pnpm kombinat tui, which also works over ssh. See Monitoring. To open them from another machine, see Remote access.
Monitoring
The daemon serves a dashboard at http://localhost:7433.
- Routines.
- Calendar.
- Runs.
- Daemon status.
In the terminal
pnpm kombinat tui shows the same in the terminal. It works over ssh. Press ? for keys.
Remote access
Over SSH
Turn on Remote Login on the Mac that runs Kombinat, in System Settings β General β Sharing. Then, on your laptop:
npx @danilqa/kombinat connect admin@mac-mini # dashboard in the browser
npx @danilqa/kombinat connect admin@mac-mini --tui # dashboard in the terminal
It opens an SSH tunnel to the daemon, then the dashboard. SSH asks for the password if you have no key set up. Ctrl-C disconnects. Instead of admin@mac-mini, use anything ssh accepts: a host from ~/.ssh/config, an IP address or a Tailscale machine name. If the daemon there uses another KOMBINAT_PORT, add --port.
You can also ssh in and run pnpm kombinat tui in the folder Kombinat runs in.
With Tailscale Serve
To open the dashboard from any device in your tailnet, your phone included, run this on the Mac that runs Kombinat:
tailscale serve --bg 7433
The dashboard is then at https://mac-mini.<your-tailnet>.ts.net, and npx @danilqa/kombinat tui --url https://mac-mini.<your-tailnet>.ts.net shows it in the terminal. Serve needs HTTPS certificates in your tailnet, the command asks to turn them on. They put the machine name in public certificate logs. It stays on after a reboot, tailscale serve --https=443 off turns it off. If the Mac has no tailscale command, see Using the Tailscale CLI.
Everyone who can reach the Mac in your tailnet can then read transcripts and start routines. To limit that, allow only some people to reach port 443 of the Mac in your Tailscale access rules.
Routines
The example routines of this repository, one row per file in routines/. Put the same routines:start and routines:end comments in your own README, and pnpm kombinat readme keeps a table like this one up to date.
| Routine | When | What it does |
|---|---|---|
| weather-example-routine | Weekdays at 08:00 | Says if you need an umbrella today |
How it works
- Each routine is a markdown file. The frontmatter sets the schedule and settings, the body is the prompt.
- A small daemon checks every 30 seconds which routines are due and starts their agent. It also serves a dashboard at http://localhost:7433.
- launchd keeps the daemon running and starts it again after a reboot. Runs only happen while the Mac is awake and you are logged in.
- Logs and run history are stored in
~/.kombinat/. - Claude and Codex use your subscription login. API key variables are removed from their environment.
Setup
You need Node 24 and the agents your routines use, logged in: Claude Code (claude auth status) and Codex (codex login). From the folder with routines/ and package.json:
pnpm add @danilqa/kombinat
pnpm kombinat install
This starts the daemon under launchd, in that folder. Open http://localhost:7433. There is one daemon per macOS user, so running install in another folder moves it there.
Commands
Run them from the same folder. With npm, use npx kombinat instead of pnpm kombinat, with Yarn yarn kombinat.
pnpm kombinat list # routines, next run, last status
pnpm kombinat run <name> # run a routine now, in the foreground
pnpm kombinat validate # check all routine files
pnpm kombinat tui # dashboard in the terminal, works over ssh
pnpm kombinat status # daemon and scheduler state
pnpm kombinat readme # update the routines table in README.md
pnpm kombinat uninstall # stop and remove the daemon
Writing a routine
---
name: fix-e2e-tests
description: Finds the failing e2e test and fixes it
schedule: '30 11 * * *'
cwd: ~/projects/app
agent: claude
model: claude-opus-5-5
effort: high
timeoutMinutes: 55
---
1. Open the latest failed e2e run on GitHub ...
namemust match the file name.scheduleis a 5-field cron in local time, ormanualto run only on demand.cwdis where the agent starts.agentisclaude(default),codexorcommand.timeoutMinutesstops the run after this time. Default 55.beforeis an optional shell command that runs first. If it fails or takes more than 3 minutes, the run fails.enabled: falsekeeps the file but stops the schedule.
Changes apply on the next check, no restart needed. Write the prompt so the agent never has to ask a question: nobody will answer.
Agents
| Setting | claude | codex | command |
|---|---|---|---|
model | default claude-opus-5-5 | default from your Codex config | - |
effort | low, medium, high (default), xhigh, max | minimal, low, medium, high, xhigh | - |
permissionMode | auto (default), acceptEdits, dontAsk, bypassPermissions, plan, manual | read-only, workspace-write (default), danger-full-access | - |
maxBudgetUsd | optional | - | - |
command | - | - | required |
clauderunsclaude -p. Anything that needs approval is denied.codexrunscodex exec.permissionModesets its sandbox.commandruns any other CLI, for examplecommand: gemini --yolo. It gets the prompt on stdin, and its output is the result.
A setting the agent does not support fails validation.
Scheduling
- If the Mac was asleep, each routine runs once for its latest missed time, up to 7 days back.
- A routine never runs twice at the same time. If it is still running at its next time, that run is skipped.
- At most 3 routines run at once.
Updating
The daemon runs git pull in the folder every 5 minutes, so merged changes go live on their own. It only pulls when the checkout is on main with no local changes.
To update Kombinat, bump @danilqa/kombinat in package.json, for example with a Renovate or Dependabot PR. When the lockfile changes, the daemon installs dependencies with pnpm, npm or Yarn and restarts. Running routines are not interrupted.
Configuration
| Variable | Default | What |
|---|---|---|
KOMBINAT_PORT | 7433 | dashboard port |
KOMBINAT_STATE_DIR | ~/.kombinat | logs and history |
KOMBINAT_ROUTINES_DIR | ./routines | routine files |
KOMBINAT_MAX_CONCURRENT | 3 | routines that can run at once |
KOMBINAT_TICK_SECONDS | 30 | how often the daemon checks routines |
KOMBINAT_PULL_MINUTES | 5 | auto git pull interval, 0 to disable |
KOMBINAT_PULL_BRANCH | main | branch the daemon pulls |
CLAUDE_BIN | ~/.local/bin/claude | Claude Code binary |
CODEX_BIN | codex | Codex binary |
Set them before pnpm kombinat install. They are saved in the launchd config.
// faq
What is kombinat?
π Dead simple, lightweight engine for 24/7 background AI agents. Works with your Claude, Codex or any other subscription. Comes with remote control, UI and mobile support. It is open-source on GitHub.
Is kombinat free to use?
kombinat is open-source under the MIT license, so it is free to use.
What category does kombinat belong to?
kombinat is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/kombinat)
// retro hit counter
[](https://claudeers.com/kombinat)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursβ¦
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,β¦
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA