Skip to main content

Progi - MCP-native Workflow Engine

Progi teaches your agent how you like to get things done. So you can do your best work without re-explaining your process or losing context between sessions.

License: MIT PyPI MCP


Get started

Add Progi to your MCP client config (GH Copilot / Cursor / Claude Code / etc):

{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": ["progi"]
    }
  }
}

Progi Monitoring starts automatically at http://127.0.0.1:8000.

If you want to start Monitoring on a different port:

{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": ["progi"],
      "env": {
        "PROGI_WEB_PORT": "8080"
      }
    }
  }
}

How it works

1. Describe your workflow

"Hey Progi, help me create workflow for creating integrations, reviewing code, and publishing PRs."

Describe your process in plain language. You can be detailed or just provide a rough idea. Progi stores it as a structured workflow with per-step playbooks.

2. Run tasks, stay in the loop

"Hey Progi, start a new task, we need to review a new docs PR in the repo." Your agent loads the workflow, works through each step using your playbooks, and loops you in at critical checkpoints to review output.

3. Monitor progress

Progi Monitoring gives you a live view of every running and completed task — status, progress, and the full output history across all your workflows.

4. Optimize as you go

Tweak playbooks between runs. Because workflows live in a database and survive context resets, every future task picks up your changes automatically — your process gets sharper with each iteration.


MCP Tools

Work loop

Tool Description
create_task Create a new task under a given workflow (status todo); returns a preview of its first step
list_tasks List tasks, optionally filtered by status and/or workflow
start_or_continue_task Main work-loop entry point — starts or resumes a task and returns the current step's playbook, input data, and output spec
update_progress_notes Overwrite a task's progress notes (mid-step save point)
submit_output Mark the current step complete, store its output, and advance to the next step (or mark done)

Workflow authoring

Tool Description
get_process_skeleton_prompt Return the Pass 1 system prompt for turning a plain-language description into a structured workflow skeleton
get_playbook_authoring_prompt Return the Pass 2 system prompt for authoring a step's playbook (injects workflow context)
save_workflow Persist a new workflow, its steps, and playbooks
list_workflows Return all workflows with their ordered steps
update_playbook Replace the playbook content for a step

Authoring is two passes: Pass 1 turns a plain-language description into a structured skeleton; Pass 2 authors each step's playbook. save_workflow persists both.


Configuration

Variable Default Purpose
PROGI_DB_PATH OS data dir (platformdirs) SQLite file location
PROGI_WEB_HOST 127.0.0.1 Web UI bind host
PROGI_WEB_PORT 8000 Web UI port
PROGI_NO_WEB 0 Set to 1 to disable the web UI

Run modes: uvx progi (MCP + web UI), uvx progi --no-web (MCP only), uvx progi-web (web UI only).

Use an absolute path for PROGI_DB_PATH

Metadata

Release files for progi 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for progi 0.3.2
File Size Uploaded Provenance Actions
progi-0.3.2.tar.gz 1.1 MB With provenance Details for progi-0.3.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for progi 0.3.2
File Interpreter ABI Platform Actions
progi-0.3.2-py3-none-any.whl Python 3 none any Details for progi-0.3.2-py3-none-any.whl

Total release size: 2.1 MB

Release files / progi-0.3.2.tar.gz

Download URL progi-0.3.2.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
b1f73fc14220795fbf2373b6da7653bbf24a7a33672c9df942cb8fcee9385d3f
BLAKE2b-256 checksum
How to use checksums
b88842799d0a4156d187e6946831a74b5bbb7a0fae94f59e948b139c01dbe8f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 16, 2026.

Transparency log

Release files / progi-0.3.2-py3-none-any.whl

Download URL progi-0.3.2-py3-none-any.whl
Size 994.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f12a2d8e1a53f5847bbe49e3aad6ac5c35a322d1ebc9bf1ab7cf7c9b316ae06c
BLAKE2b-256 checksum
How to use checksums
0bf47cef4b9a03f62cf83c2772139c95120d4fe1827c4fbc864c1fd622bbff28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 16, 2026.

Transparency log

Security for progi 0.3.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for progi-0.3.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page