Skip to content

neural-chilli/qp

Quickly Please logo

Quickly Please (qp)

CI Release Docs Docs Site Latest Release Language License

qp is a local-first task runner and workflow runtime for humans and agents, driven by one qp.yaml.

Docs: Manual · User Guide (repo)

Quickstart

Install:

go install github.com/neural-chilli/qp/cmd/qp@latest

Initialize in a repo:

qp init
qp list
qp help check
qp check
qp guard

Minimal qp.yaml:

project: my-service
default: check

tasks:
  lint:
    desc: Lint code
    cmd: golangci-lint run

  test:
    desc: Run tests
    cmd: go test ./...

  check:
    desc: Local verification
    run: par(lint, test)

Common Commands

qp list
qp help <task>
qp <task>
qp guard
qp watch guard
qp check --json
qp check --events 2>events.jsonl

Where To Go Next

About

A task runner that makes your repo agent-ready. One YAML file. DAG execution, scoped context, structured output, and generated agent docs - so coding agents know what to run, where to look, and what they broke.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors

Languages