# Knecht

> Knecht is a self-hostable orchestration tool that connects to your GitHub repos and uses workflows to boot up complete projects so that agents can fix and test in functional environments.

## Documentation Sets

- [Knecht - Full website content](https://knecht.works/llms-full.txt): The complete content of the Knecht website as a single document.

## Docs

Product documentation.

- [Introduction](https://knecht.works/raw/docs/get-started/introduction.md): What Knecht is and how it fits into your workflow.
- [Concepts](https://knecht.works/raw/docs/get-started/concepts.md): The pieces you meet in the dashboard and how they fit together.
- [Installation](https://knecht.works/raw/docs/get-started/installation.md): Run Knecht on your own infrastructure.
- [Setup](https://knecht.works/raw/docs/get-started/setup.md): Configure your Knecht instance after installation.
- [Maintenance](https://knecht.works/raw/docs/get-started/maintenance.md): Keep a self-hosted instance up to date and backed up.
- [Projects](https://knecht.works/raw/docs/usage/projects.md): Add a project, run it through Knecht, and manage it afterward.
- [Workflows](https://knecht.works/raw/docs/usage/workflows.md): Build, trigger, and test workflows for your projects.
- [Triggers](https://knecht.works/raw/docs/usage/triggers.md): Start workflows from GitHub events, from an issue tracker, or on a schedule.
- [AI Agent](https://knecht.works/raw/docs/usage/agent.md): How the agent works inside your project and how to steer it.
- [GitHub](https://knecht.works/raw/docs/integrations/github.md): Everything you need to know about the GitHub integration. What it can do and how to set it up.
- [Jira](https://knecht.works/raw/docs/integrations/jira.md): Everything you need to know about the Jira integration. What it can do and how to set it up.
- [Plane](https://knecht.works/raw/docs/integrations/plane.md): Everything you need to know about the Plane integration. What it can do and how to set it up.
- [Linear](https://knecht.works/raw/docs/integrations/linear.md): Everything you need to know about the Linear integration. What it can do and how to set it up.
- [Beta Testers](https://knecht.works/raw/docs/resources/beta-testers.md): How to get your instance, set it up, and redeem your OpenCode credit.
- [Troubleshooting](https://knecht.works/raw/docs/resources/troubleshooting.md): Fix the differences a project can show on Knecht compared to your local DDEV setup.

## Legal (EN)

Legal pages

- [Privacy Policy](https://knecht.works/raw/datenschutz.md): Information about the processing of personal data.
- [Legal Notice (Impressum)](https://knecht.works/raw/impressum.md): Information according to § 5 TMG.

## Updates (EN)

Building-in-public update articles.

- [The Agent Gets a Memory per Project](https://knecht.works/raw/updates/agent-memory.md): Until now the agent explored the project again in every run. Now Knecht remembers per project what the agent has learned.
- [Beta Testers Wanted](https://knecht.works/raw/updates/beta-tester.md): We search for a handful of agencies and freelancers that run Knecht on real projects. We cover the hosting, the credit, and the first year.
- [From a Shared Docker Daemon to One Sandbox per Run](https://knecht.works/raw/updates/dashboard-architecture.md): Knecht can boot real DDEV projects from inside a container. What the test showed, and why each run will get its own sandbox.
- [The Docs Are Online](https://knecht.works/raw/updates/docs-online.md): Knecht now has documentation with search, a chat assistant, and feedback on every page. And a Discord server where we collect your reports.
- [GitHub Auth Evolution](https://knecht.works/raw/updates/gh-auth-evolution.md): A deep dive into the GitHub connection of Knecht. Why an OAuth token is not enough, what a GitHub App does differently, and why we had to build the access control ourselves in the end.
- [One Interface for All Integrations](https://knecht.works/raw/updates/integrations-rewrite.md): How we put Knecht's integrations behind one shared interface, so a new tool only brings what is actually different about it.
- [The Landing Page Is Online](https://knecht.works/raw/updates/landingpage.md): Why the landing page comes before the product, and what comes next.
- [Langdock as an AI Provider](https://knecht.works/raw/updates/langdock-provider.md): The agent now also runs through Langdock. One API key covers GPT and Claude models, and every request stays in the EU or in the US.
- [Why Knecht Is Not Open Source](https://knecht.works/raw/updates/license-decision.md): Knecht now has a license, the Functional Source License. This post explains what you can do with the code, why we did not select MIT, and how each version becomes open source after two years.
- [From 5 Seconds to Under 0.5](https://knecht.works/raw/updates/mobile-performance.md): A deep dive into why CSS blur is one of the most expensive effects in the browser, and how a single filter made the landing page slow on mobile.
- [Every Repo Boots, Even Without a DDEV Config](https://knecht.works/raw/updates/repos-without-ddev-config.md): Knecht now builds the environment from the repo files when there is no DDEV config. A dev server becomes the live preview, with hot reload.
- [Back to the Shared Daemon, One Preview for 180 MB](https://knecht.works/raw/updates/sandbox-rollback.md): The sandbox per run worked, and it used 3 GB of RAM per preview. This post explains why we removed it again and how we solve the old problems today.
- [Knecht Now Replies on GitHub](https://knecht.works/raw/updates/sessions-and-mentions.md): Every issue gets its own session with an environment and a conversation, the agent replies and labels directly in the thread, and a mention sends it back to work.
- [What Knecht Does](https://knecht.works/raw/updates/was-macht-knecht.md): About the idea, the motivation, and how Knecht helps.
- [A Terminal and VS Code for Each Run](https://knecht.works/raw/updates/web-terminal-vscode.md): A terminal in the browser, a ready SSH command, and VS Code without a local setup. You can now open each run directly and continue the work.
- [Automate DDEV Projects with Workflows](https://knecht.works/raw/updates/workflow-engine.md): Automation for DDEV projects. Knecht runs Composer updates and tests in a sandbox and opens pull requests. With an AI agent that fixes bugs in the project.

## Legal (DE)

Legal pages, German.

- [Datenschutzerklärung](https://knecht.works/raw/de/datenschutz.md): Informationen zur Verarbeitung personenbezogener Daten.
- [Impressum](https://knecht.works/raw/de/impressum.md): Angaben gemäß § 5 TMG.

## Updates (DE)

Building-in-public update articles, German.

- [Der Agent bekommt ein Gedächtnis pro Projekt](https://knecht.works/raw/de/updates/agent-memory.md): Bisher hat der Agent in jedem Run das Projekt neu erkundet. Jetzt merkt sich Knecht pro Projekt, was der Agent gelernt hat.
- [Beta Tester gesucht](https://knecht.works/raw/de/updates/beta-tester.md): Wir suchen eine Handvoll Agenturen und Freelancer, die Knecht auf echten Projekten einsetzen. Hosting, Guthaben und das erste Jahr übernehmen wir.
- [Vom geteilten Docker Daemon zur Sandbox pro Run](https://knecht.works/raw/de/updates/dashboard-architecture.md): Knecht kann aus einem Container heraus echte DDEV-Projekte booten. Was der Test gezeigt hat und warum jeder Run künftig seine eigene Sandbox bekommt.
- [Die Docs sind online](https://knecht.works/raw/de/updates/docs-online.md): Knecht hat jetzt eine Dokumentation mit Suche, einem Chat-Assistenten und Feedback auf jeder Seite. Und einen Discord-Server, auf dem wir eure Rückmeldungen sammeln.
- [GitHub Auth Evolution](https://knecht.works/raw/de/updates/gh-auth-evolution.md): Ein Deep Dive in Knechts GitHub-Anbindung. Warum ein OAuth-Token nicht reicht, was eine GitHub App anders macht und wieso wir die Zugriffskontrolle am Ende selbst bauen mussten.
- [Eine Schnittstelle für alle Integrationen](https://knecht.works/raw/de/updates/integrations-rewrite.md): Wie wir die Integrationen von Knecht hinter eine gemeinsame Schnittstelle gebracht haben, damit ein neues Tool nur noch mitbringt, was an ihm wirklich anders ist.
- [Landingpage ist Online](https://knecht.works/raw/de/updates/landingpage.md): Warum die Landingpage noch vor dem Produkt kommt und wie es weitergeht.
- [Langdock als AI-Provider](https://knecht.works/raw/de/updates/langdock-provider.md): Der Agent läuft jetzt auch über Langdock. Ein API-Key deckt GPT- und Claude-Modelle ab, und jede Anfrage bleibt in der EU oder in den USA.
- [Warum Knecht nicht Open Source ist](https://knecht.works/raw/de/updates/license-decision.md): Knecht hat jetzt eine Lizenz, die Functional Source License. Was du mit dem Code alles darfst, warum es kein MIT geworden ist und wie jede Version trotzdem irgendwann Open Source wird.
- [Von 5 Sekunden auf unter 0,5](https://knecht.works/raw/de/updates/mobile-performance.md): Ein Deep Dive, warum CSS-Blur einer der teuersten Effekte im Browser ist und wie ein einziger Filter die Landingpage am Handy ausgebremst hat.
- [Jedes Repo bootet, auch ohne DDEV-Config](https://knecht.works/raw/de/updates/repos-without-ddev-config.md): Knecht baut die Umgebung jetzt aus den Repo-Dateien, wenn keine DDEV-Config da ist. Ein Dev-Server wird zur Live-Preview, mit Hot Reload.
- [Zurück zum geteilten Daemon, eine Preview für 180 MB](https://knecht.works/raw/de/updates/sandbox-rollback.md): Die Sandbox pro Run hat funktioniert und kostete 3 GB RAM pro Preview. Warum wir sie wieder ausgebaut haben und wie die alten Probleme heute gelöst sind.
- [Knecht antwortet jetzt auf GitHub](https://knecht.works/raw/de/updates/sessions-and-mentions.md): Jedes Issue bekommt eine eigene Session mit Umgebung und Gespräch, der Agent antwortet und labelt direkt im Thread, und mit einer Mention schickt ihr ihn zurück an die Arbeit.
- [Was macht der Knecht](https://knecht.works/raw/de/updates/was-macht-knecht.md): Über die Ideenfindung, die Motivation und wie Knecht dabei hilft.
- [Ein Terminal und VS Code für jeden Run](https://knecht.works/raw/de/updates/web-terminal-vscode.md): Ein Terminal im Browser, ein fertiger SSH-Befehl und VS Code ohne lokales Setup. Jeder Run lässt sich jetzt direkt öffnen und weiterbearbeiten.
- [DDEV-Projekte automatisieren mit Workflows](https://knecht.works/raw/de/updates/workflow-engine.md): Automatisierung für DDEV-Projekte. Knecht führt Composer-Updates und Tests in einer Sandbox aus und öffnet Pull Requests. Mit AI-Agent, der Bugs im Projekt fixt.