Piyaz

The agentic workspace where people and coding agents work on the same project.

Piyaz is an agentic workspace for project management, where people and coding agents work on the same project. It runs as an MCP server with a web app on top, and it holds your project as a graph, every task wired to what blocks it, with the decisions and the execution history attached. Piyaz keeps that work consistent to the engineering process a real codebase needs, from decomposing an idea to reviewing the code before it merges.

Using Piyaz, several agents can build at the same time; each in its own harness and with no API keys to wire up, while engineers are free to steer them as needed. One agent can implement a task while you refine another or add a new feature.

Drop in an idea or an existing codebase, and Piyaz breaks it into small, concrete tasks on that graph. When an agent picks up a task, it already has the plan, the standards, and the decisions behind the work. No agent starts from a raw read of a task description.

Full setup, guides, and reference can be found at docs.piyaz.ai.

Self-host

Piyaz is free under AGPL-3.0. You run the Piyaz server yourself and register an MCP server in your editor that points at it. You need Bun and Docker for PostgreSQL. Full setup and upgrade steps are in the self-host guide, and per-harness setup is in the docs.

What Piyaz changes for you

Stop explaining the project twice. Every task carries its own context: the plan, the decisions behind it, and how it connects to the rest of the project. Your next session picks up where the last one left off instead of asking you to explain the project again.

Ship a big project without the quality falling off. Piyaz breaks large work into small tasks with clear dependencies and hands each one exactly the context it needs, so the tenth task lands as cleanly as the first.

Put more than one agent on the same project. People and agents across Claude Code, Codex, Cursor, and Antigravity share one view of what's done, what's ready, and what's blocked, so their work doesn't collide or drift.

Start from an idea or from code you already have. Describe something new and Piyaz plans it out, or point it at an existing codebase and it maps the work you've already shipped into a tracked project.

Talk, don't configure. You say what you want in plain language. Piyaz plans the work, tracks it, and keeps the record current. No need for informing your agent with the necessary context manually.

On Claude Code, Composer can take a task the whole way on its own: it researches the task against your codebase, writes the plan, implements it, opens up a pull request, reviews it and fixes what review flags, then moves to the next ready task. You decide what merges.

How it wor

... View full README on GitHub