# konduktor

where humans and agents build products together

Install: `curl -fsSL https://konduktor.yakko.dev/install.sh | bash`

[view install.sh](/install.sh) | [full installation docs](https://konduktor-docs.yakko.dev)

## Not just an orchestrator, really

In some ways, **konduktor** is an agent orchestrator.

Set it up on your machine or a VPS, fire off tasks, and get PRs back.

But **konduktor**'s goal isn't to enable us to generate AI slop faster, but rather to explore how humans and agents can build high-quality products together.

This sounds like BS, but I mean it.

Here are **konduktor**'s driving principles:

**1. Human-in-the-loop**

**konduktor** let's you fire off background agents and even schedule agents to run throughout the day or while you sleep.

But agents follow your workflow, ask you questions asynchronously before proceeding with certain tasks, and you have full observability + tooling to review their work efficiently.

**2. Spec is king**

Agents are getting better at taking loose requirements and building reasonable implementations, but not only do great specs help them, they help _you_.

The more you think deeply about challenges and product direction, the better your product will be. **konduktor** encourages you to think and plan, not just do.

**3. Opinionated but configurable**

**konduktor** provides some opinionated primitives that help structure your work, like a task board and a projects feature to manage complex work with a lot of moving parts.

These let you get moving fast, but being open-source and running on your machine means you can always peak under the hood and configure things the way you want them.

## What does that mean in practice?

In practice, those principles translate to the following features today:

* **Background agents**: Create a task, run in the background, get a PR back. Resume the session, inspect logs, add metadata, etc. Full end-to-end experience.
* **Scheduled agents**: Create agents that run throughout the day or overnight. Mine currently challenge my specs, hunt bugs, do first-pass reviews, and come up with ideas.
* **Projects**: Manage work for complex features with a spec and defined project phases. Tasks in a phase can be completed in parallel (by you, agents, or a combination of both) and phases get unblocked when all tasks from the previous phase are complete. Scheduled agents are great at managing projects and starting work autonomously once tasks are unblocked.
* **Asynchronous questions**: The questions API let's agents ask you clarifying questions about your tasks, forcing you to think and spec things better, and enabling them to automatically start work once they have enough context. The questions experience is really nice both in the UI and the CLI, and I start my day by answering questions.
* **Kanban board**: Classic feature from standard orchestrators. Oversee work from a Kanban board that both you and your agents can manage.
* **Product docs**: Write your vision, plans, PRDs, etc. inside **konduktor**. Choose what's just for you and what's required reading for your agents.
* **CLI**: Anything in **konduktor** can be managed from the CLI, making it so that you don't need to leave the terminal if you don't want to, and that whatever coding agent you use can leverage **konduktor** as a source of truth and easily coordinate work. Whenever I'm happy with a spec after being challenged by Claude Code, it creates a project for me with well-defined phases and fires off the first tasks.
* **GitHub integration**: Merged PRs get moved to "Done" automatically. Merge conflicts get resolved as soon as they occur.

## Where should I run it?

**konduktor** runs on a machine you own, be it your laptop or a VPS. You're strongly recommended to deploy this on a remote machine behind a domain so that you can benefit from GitHub webhooks, run agents overnight (without any hassle), and let the agents operate more freely away from your personal stuff.

## Get started

See the full [installation docs](https://konduktor-docs.yakko.dev).