Skip to content

Repository files navigation

QualityLayer

QualityLayer

The software factory with you in the loop

Plan each change visually, then let your agents build and verify it.
Work side by side in the App or browser, or use your favourite terminal or IDE.

Stars Star History Downloads PRs Welcome

Install • Features • Docs • Website • Changelog

Download the App for macOS, Windows or Linux.

Join the Inside QualityLayer webinar


Play video: QualityLayer’s seven-step workflow, 5 minutes 20 seconds

▶ Watch the 5:20 walkthrough


Why QualityLayer

“With QualityLayer, developing software with agents finally feels like doing real engineering again.”

An engineer who uses QualityLayer

QualityLayer keeps design decisions and verification visible while your agents work.

You get How it works
Your own agent and plan Claude Code, Codex, Cursor and four more run on the subscription or API key you already have.
A design you can review Comment on diagrams and clickable screens, then approve the Plan before code changes.
Small, tested changes Your agent works in small slices, writes behavior tests before implementation and fixes failures.
An independent check With independent review on, a separate agent checks the running change against your request. Anything it cannot verify stays visible in Review.
Code health checks Find complex functions, deeply nested code and duplication. Code health.
Visible decisions and effort Each step records its decisions and results in your repository, with time and estimated model cost shown in the App.

Getting Started

Prerequisites

  • A coding agent, installed and signed in: Claude Code, Codex, Cursor, Grok, Antigravity, Pi or OpenCode. Other agents connect through the CLI.
  • Your own subscription (Claude or ChatGPT plan, or API key).
  • Git and a repository.

Installation

Download the App and open it. Setup automatically installs the qualitylayer command and connects your agents. On a server, in WSL or in a container:

curl -fsSL https://qualitylayer.dev/install.sh | bash      # macOS, Linux, WSL
irm https://qualitylayer.dev/install.ps1 | iex             # Windows PowerShell

The App updates itself; without it, run qualitylayer update. Installation guide.

Uninstalling

qualitylayer uninstall undoes what the installer changed; your plans stay. On Windows, even when the App is gone:

& ([scriptblock]::Create((irm https://qualitylayer.dev/install.ps1))) -Uninstall
Coming from Pilot Shell 11

Run pilot update or download the App. Active Polar licences work with both products; older purchases may need help moving over. Migration and memory import.

First Steps

In the App or browser, choose + New, then Chat, Feature or Bugfix. Pick your repository and agent, and describe what you need.

Chat is a conversation without workflow steps. You can use artifacts, checks and reviews as needed, then Start the workflow from the same conversation. Chat guide.

For a Feature or Bugfix, choose Plan with QualityLayer, or Existing plan to paste or attach a plan. Describe what you want:

Plan retries for failed webhooks and stop after a few tries.
  1. Answer questions and comment on the Plan.
  2. Approve the Plan. Your agent builds and verifies the change.
  3. Review the result, including any checks that still need you, and approve it.
Where you work How to start
App or browser Choose In the App to keep the agent beside the task.
Your terminal or IDE Choose In my terminal to copy the request, or ask there: “Using QualityLayer, plan retries for failed webhooks.”
Another agent Agents that run shell commands can use the CLI. Supported agents.

To switch agents or environments, stop the run and ask: “Using QL, continue task retry-webhooks.”

QualityLayer runs only when you ask for it. Your first task.

Skills your agent gets

Setup installs six skills. Ask in plain language, naming QualityLayer or QL; your agent picks the right one.

Skill What it does
ql-workflow Plan, build, verify and review a change
ql-artifact Create and revise mockups, diagrams and clickable pages
ql-manage Find tasks and manage memory, sharing, settings and setup
ql-peer Coordinate other agent sessions on your computer
ql-quality Review code complexity, structure and duplication
ql-chat Start or continue a Chat, a conversation without workflow steps

Only ql-workflow starts the planning and build workflow; the others work on their own. More about the skills.


The Workflow

Seven steps take a change from questions to review, with decisions and checks saved as Markdown in your repository. Existing plans start at Plan. You approve the Plan and finished change, authorize pushes and control the merge.

Discuss, Research, Plan, Outline, Implement, Verify, Review and the pull request: you approve at Plan and at Review and merge the pull request; your agent works in between
Step What happens
Discuss Settles what done means and clarifies a bug report
Research Agents read how your code works today; a bug is reproduced and diagnosed here
Plan Diagrams, clickable artifacts and checks, approved by you
Outline The build session splits the approved Plan into small slices
Implement Your agent builds test first, fixes what fails and decides when it is ready
Verify Project checks and, when enabled, an independent agent's review
Review A walkthrough of the change, approved by you
Pull request Failing checks and routine review threads fixed; the task stays open until you merge

Two levels

Engineering starts with a technical plan. Product starts with a product brief. Choose in Settings › Workflow. How they differ.

QualityLayer App

Reviewing a billing decision and its diagram beside Claude Code in the App. Fictional project.
In the App What you can do
Chat or a planned task Talk directly with your agent or follow the seven-step workflow.
Conversation and terminal Read the agent's conversation or its terminal beside the task. Answer questions and pin feedback.
Artifacts Try mockups, diagrams and clickable pages before any code exists.
Checks and code review Read the evidence and file diffs, and comment on any line.
Agent controls and usage Choose your model, effort and permissions; track usage. Settings.
Memory and team Reuse project lessons, ask teammates over Slack and share work.

QualityLayer keeps task files on your computer and encrypts shared tasks first. Your coding agent uses its own provider. Files and privacy.

Explore the App →

Artifacts

Try mockups, diagrams and clickable pages before building. Pin feedback to any spot; your agent updates the artifact. Keep reusable artifacts in your repository. Artifacts guide.

A backend request diagram in QualityLayer’s artifact viewer. Fictional project.

Documentation

Guides for getting started, commands and settings.


Changelog

See the changelog or GitHub Releases.


Contributing

Found a bug or missing a feature? Open an issue.


License

See LICENSE.


Quality by design. The software factory with you in the loop.

Made by Max Ritter

Releases

Used by

Contributors

Languages