English Français العربية

io.github.zseta/progi

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP-native workflow engine: teach agents your processes once, they execute them consistently.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package progi
Claude Code 
claude mcp add progi -e 'PROGI_DB_PATH=<PROGI_DB_PATH>' -- uvx progi==0.3.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "progi": {
            "command": "uvx",
            "args": [
                "progi==0.3.2"
            ],
            "env": {
                "PROGI_DB_PATH": "<PROGI_DB_PATH>"
            }
        }
    }
}

متغيرات البيئة

  • PROGI_DB_PATH Custom path for the Progi SQLite database file

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Progi - MCP-native Workflow Engine
  2. Get started
  3. How it works
  4. MCP Tools
  5. Configuration

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.

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 in Progi Monitoring 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
ToolDescription
create_taskCreate a new task under a given workflow (status todo); returns a preview of its first step
list_tasksList tasks, optionally filtered by status and/or workflow
start_or_continue_taskMain work-loop entry point — starts or resumes a task and returns the current step's playbook, input data, and output spec
update_progress_notesOverwrite a task's progress notes (mid-step save point)
finish_stepMark the current step complete, store its output, and advance to the next step (or mark done)
Workflow authoring
ToolDescription
get_process_skeleton_promptReturn the Pass 1 system prompt for turning a plain-language description into a structured workflow skeleton
get_playbook_authoring_promptReturn the Pass 2 system prompt for authoring a step's playbook (injects workflow context)
save_workflowPersist a new workflow, its steps, and playbooks
list_workflowsReturn all workflows with their ordered steps

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

VariableDefaultPurpose
PROGI_DB_PATHOS data dir (platformdirs)SQLite file location
PROGI_WEB_HOST127.0.0.1Web UI bind host
PROGI_WEB_PORT8000Web UI port
PROGI_NO_WEB0Set 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

الأسئلة الشائعة

ما هو io.github.zseta/progi؟

MCP-native workflow engine: teach agents your processes once, they execute them consistently.

كيف أثبّت io.github.zseta/progi؟

يعمل على جهازك. في Claude Code: claude mcp add progi -e 'PROGI_DB_PATH=<PROGI_DB_PATH>' -- uvx progi==0.3.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.zseta/progi إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.zseta/progi مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.zseta/progi؟

ينشره zseta. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.