Skip to content
Back to search

druks

An operating system for companies: AI agents build and run software tailored to your company. Own your software instead of paying for services you barely use. Agents work in sandboxes, a person approves the important steps, and every run is recorded.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/getdruks/druks with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/getdruks/druks'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/getdruks--druks/badge.svg)](/listings/getdruks--druks)

HTML

<a href="/listings/getdruks--druks"><img src="/api/listings/getdruks--druks/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 192 lines · 1 finding marked
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo/web/DruksLockup_Dark.svg">
  4. <img src="docs/assets/logo/web/DruksLockup_Light.svg" alt="Druks" width="240">
  5. </picture>
  6. </p>
  7. <h3 align="center">AI agents work. You make the call.</h3>
  8. <p align="center">
  9. Druks finds the work, does it on the tools you already use,<br>
  10. and brings the important decisions to you. Self-hosted or Druks Cloud.
  11. </p>
  12. <p align="center">
  13. <a href="https://app.druks.ai/sign-in?utm_source=github&utm_medium=readme"><b>Try it now</b></a> ·
  14. <a href="#get-started"><b>Install on your AI</b></a> ·
  15. <a href="https://docs.druks.ai/?utm_source=github&utm_medium=readme">Docs</a>
  16. </p>
  17. <p align="center">
  18. <a href="LICENSE"><img alt="License: FSL-1.1-ALv2" src="https://img.shields.io/badge/license-FSL--1.1--ALv2-blue"></a>
  19. <img alt="Status: pre-1.0" src="https://img.shields.io/badge/status-pre--1.0-orange">
  20. <img alt="Works with Claude Code and Codex" src="https://img.shields.io/badge/works%20with-Claude%20Code%20%C2%B7%20Codex-00677b">
  21. <a href="#contributors"><img alt="All Contributors" src="https://img.shields.io/github/all-contributors/getdruks/druks?color=00677b"></a>
  22. </p>
  23. https://github.com/user-attachments/assets/3aca69c1-aeb6-4fcb-82c9-d4149c469f55
  24. **Druks is a self-hosted or cloud platform where AI agents such as Claude Code and Codex do a company's recurring engineering work, and a person approves each change.**
  25. - **It finds the work.** A schedule, an alert or a button starts it. Nobody writes a prompt.
  26. - **It does the work with your tools.** Claude Code or Codex, with your own Claude or OpenAI account, in a sandbox, on your real repositories. You see the cost after every step.
  27. - **You make the call.** The run stops and asks you: Approve, Change or Stop. You answer in Slack, the dashboard, the Druks chat or Claude Code. It waits up to 14 days and costs nothing while it waits.
  28. ## Get started
  29. Druks Cloud and self-hosted Druks work the same way. You get the same apps and approve in the same places. The only difference is where Druks runs.
  30. **Druks Cloud.** Druks runs on our servers. Nothing to install. [Try it now](https://app.druks.ai/sign-in?utm_source=github&utm_medium=readme).
  31. **Self-hosted.** Druks runs on your laptop or your own server. You need Docker with Compose. Paste this into Claude Code, Codex or any coding agent on the machine:
  32. ```text
  33. Install Druks on this machine with https://druks.ai/install.sh. Read the script, then run it. Then run the steps it prints: build the sandbox images and run druks doctor. If a step fails, stop. Show me the failed step and its output. Do not improvise a fix. When druks doctor passes, open http://127.0.0.1:8001 in my browser.
  34. ```
  35. Or run the installer yourself:
  36. ```bash
  37. curl -fsSL https://druks.ai/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 51 on GitHub
  38. ```
  39. Then build the sandbox images, check the install and open the dashboard:
  40. ```bash
  41. cd ~/druks
  42. docker compose exec web druks sandboxes build
  43. docker compose exec web druks doctor
  44. open http://127.0.0.1:8001 # on Linux: xdg-open
  45. ```
  46. In the dashboard, connect your AI account under **Settings → Providers** and the GitHub App under **Settings → Connections → Services**.
  47. <details>
  48. <summary>Remote installs (exe.dev and other providers)</summary>
  49. Name the provider. The installer lists the values only you know, then exits. Set them in `~/druks/druks.toml` and `~/druks/.env`, and run the same command again.
  50. ```bash
  51. curl -fsSL https://druks.ai/install.sh | DRUKS_PROVIDER=exe bash
  52. ```
  53. The [deployment guide](https://docs.druks.ai/deployment) covers access control, upgrades and rollback.
  54. </details>
  55. ## Why Druks
  56. | If you use… | It helps when… | Druks adds… |
  57. | --- | --- | --- |
  58. | A coding assistant (Claude Code, Codex, Copilot) | A developer sits down and asks | Work that starts by itself, every week, with nobody at the keyboard |
  59. | An agent board | You write a ticket and assign it to an agent | Processes that find the work themselves, like a weekly security sweep |
  60. | A workflow builder | You design each step of the flow | Apps that already work. Build your own only when you want to |
  61. Druks does not replace your coding agent. It puts the agent on a schedule, runs it in a sandbox, and brings you its result as one decision.
  62. ## What a run looks like
  63. <!-- Publish this section when the security sweep app ships. Until then, link to the Software Factory example in docs. -->
  64. The **security sweep** checks one repository every Monday:
  65. 1. It reads the open Dependabot alerts and checks which ones touch code you actually call.
  66. 2. It upgrades the packages in a sandbox and runs your tests.
  67. 3. It asks you: *"Upgrade 3 packages. Closes 7 vulnerabilities, 2 in code you call. Approve?"* After your yes, it opens a pull request.
  68. 4. You get a summary: the pull request, what was fixed, how long it took and what it cost.
  69. The included **Ticket to pull request** app (`software_factory`) takes a ticket, writes and checks the change, and opens a pull request for review.
  70. ## What runs where
  71. When you self-host, this is what happens with your code and your keys:
  72. - **Druks runs on your machine.** The dashboard, Postgres, Redis and the sandbox service run in Docker on your host.
  73. - **By default, each agent call runs in its own Drukbox sandbox,** with the tools and credentials of that step.
  74. - **Your code goes to the AI provider you choose,** through your own Claude or OpenAI account, and back to GitHub as pull requests.
  75. - **Connection secrets are encrypted** in your own database.
  76. - **GitHub access goes through your own GitHub App,** on the repositories you pick.
  77. - **No telemetry.** Druks does not send usage data to us.
  78. - **Apps ask before they act.** The security sweep opens a pull request only after your yes. Every proposal, decision and cost stays in the run history.
  79. Found a security problem? Follow the [security policy](SECURITY.md). Do not open a public issue.
  80. ## How it works
  81. <p align="center">
  82. <img src="docs/assets/readme/how-it-works-light.svg" alt="How Druks works: a trigger starts an app workflow. Each durable step saves its result in Postgres. An agent step runs Claude Code or Codex in an isolated Drukbox sandbox. A gate pauses the workflow until a person or a system answers in Slack, the dashboard, the chat or Claude Code, then it resumes. Events go to the run history, feed, notifications and webhooks." width="880">
  83. </p>
  84. Each process is an **app**. After a restart or deploy, Druks picks up where it left off and does not repeat finished work. [Concepts and guarantees](https://docs.druks.ai/concepts) explains the details.
  85. ## Documentation
  86. | I want to… | Start here |
  87. | --- | --- |
  88. | Install Druks on my machine | [Quickstart](https://docs.druks.ai/quickstart) |
  89. | Run Druks for my team | [Deployment](https://docs.druks.ai/deployment) and [configuration](https://docs.druks.ai/configuration) |
  90. | Automate my own process | [Writing an app](https://docs.druks.ai/writing-an-app), then `uvx --from druks druks create app my-app` |
  91. | Understand restarts and approvals | [Concepts](https://docs.druks.ai/concepts) |
  92. | Fix a problem | [Troubleshooting](https://docs.druks.ai/troubleshooting) |
  93. ## Status
  94. Druks is **pre-1.0**. Breaking changes can happen. `main` and `latest` are edge builds, not stable releases. Run the installer again to upgrade. For a fixed version, see [installing an immutable version](https://docs.druks.ai/releasing#install-an-immutable-version).
  95. ## Community
  96. - **Bugs, questions and ideas:** [open an issue](https://github.com/getdruks/druks/issues)
  97. - **Contributing:** [contribution guide](CONTRIBUTING.md)
  98. ## License
  99. Druks is available under the [Functional Source License](LICENSE) (FSL-1.1-ALv2):
  100. - You can read, run and change all of the code.
  101. - You can self-host Druks for your company's work and build apps on it.
  102. - You cannot sell it as a competing hosted service.
  103. - Each release becomes Apache 2.0 two years after it ships.
  104. The [licensing page](https://docs.druks.ai/licensing) explains the details.
  105. ### Why FSL?
  106. **Why not an MIT or Apache license?** FSL lets everyone read, run and change all of the code, and it stops other companies from selling Druks as a hosted service. Each release still becomes Apache 2.0 after two years.
  107. **Can my company self-host Druks?** Yes. Run it for your own company's work, on your own infrastructure, and change the code.
  108. **Can an agency install Druks for a client?** Yes, in the client's own infrastructure. To host Druks for many clients as a paid service, [contact us](https://druks.ai) about a partner agreement.
  109. **What about older releases?** v0.12.0 and earlier releases stay under the MIT License.
  110. ## Contributors
  111. Thanks goes to these wonderful people:
  112. <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
  113. <!-- prettier-ignore-start -->
  114. <!-- markdownlint-disable -->
  115. <table>
  116. <tbody>
  117. <tr>
  118. <td align="center" valign="top" width="14.28%"><a href="https://github.com/czpython"><img src="https://avatars.githubusercontent.com/u/994951?v=4&size=100" width="100px" height="100px" alt="Paulo Alvarado"/><br /><sub><b>Paulo Alvarado</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=czpython" title="Code">💻</a></td>
  119. <td align="center" valign="top" width="14.28%"><a href="https://github.com/chaosk"><img src="https://avatars.githubusercontent.com/u/99521?v=4&size=100" width="100px" height="100px" alt="Krzysztof Socha"/><br /><sub><b>Krzysztof Socha</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=chaosk" title="Code">💻</a></td>
  120. <td align="center" valign="top" width="14.28%"><a href="https://github.com/p-r-a-v-i-n"><img src="https://avatars.githubusercontent.com/u/91125540?v=4&size=100" width="100px" height="100px" alt="Pravin"/><br /><sub><b>Pravin</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=p-r-a-v-i-n" title="Code">💻</a></td>
  121. <td align="center" valign="top" width="14.28%"><a href="https://github.com/dserbano"><img src="https://avatars.githubusercontent.com/u/32792904?v=4&size=100" width="100px" height="100px" alt="Dan Serbanoiu"/><br /><sub><b>Dan Serbanoiu</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=dserbano" title="Code">💻</a></td>
  122. <td align="center" valign="top" width="14.28%"><a href="https://github.com/RCheesley"><img src="https://avatars.githubusercontent.com/u/2930593?v=4&size=100" width="100px" height="100px" alt="Sīlavāpi Cheesley"/><br /><sub><b>Sīlavāpi Cheesley</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=RCheesley" title="Code">💻</a></td>
  123. <td align="center" valign="top" width="14.28%"><a href="https://github.com/stefanfoulis"><img src="https://avatars.githubusercontent.com/u/14330?v=4&size=100" width="100px" height="100px" alt="Stefan Foulis"/><br /><sub><b>Stefan Foulis</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=stefanfoulis" title="Code">💻</a></td>
  124. <td align="center" valign="top" width="14.28%"><a href="https://github.com/yuripulga"><img src="https://avatars.githubusercontent.com/u/33295524?v=4&size=100" width="100px" height="100px" alt="yuripulga"/><br /><sub><b>yuripulga</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=yuripulga" title="Code">💻</a></td>
  125. </tr>
  126. <tr>
  127. <td align="center" valign="top" width="14.28%"><a href="https://github.com/kakshilshah"><img src="https://avatars.githubusercontent.com/u/6019787?v=4&size=100" width="100px" height="100px" alt="Kakshil Shah"/><br /><sub><b>Kakshil Shah</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=kakshilshah" title="Code">💻</a></td>
  128. <td align="center" valign="top" width="14.28%"><a href="https://github.com/jasoneka"><img src="https://avatars.githubusercontent.com/u/10392346?v=4&size=100" width="100px" height="100px" alt="Andrzej Jasonek"/><br /><sub><b>Andrzej Jasonek</b></sub></a><br /><a href="https://github.com/getdruks/druks/commits?author=jasoneka" title="Code">💻</a></td>
  129. </tr>
  130. </tbody>
  131. </table>
  132. <!-- markdownlint-restore -->
  133. <!-- prettier-ignore-end -->
  134. <!-- ALL-CONTRIBUTORS-LIST:END -->
  135. This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.