Progress Watch

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

Report progress from any script or agent and get notified when it finishes.

ماذا يمكنك أن تفعل مع Progress Watch؟

  • CLI for shells and CI jobs
  • MCP server and an agent skill for AI agents
  • One HTTP request from anything else, no SDK needed
  • Counts, not just percentages: 1200 / 50000 pages
  • Steps, one level deep
  • Live dashboard in the browser
  • Web Push when something finishes, with nothing to register with Apple or Google
  • No accounts: a space UUID is the credential

التثبيت

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

Remote (streamable-http)
Claude Code
claude mcp add --transport http progress-watch 'https://progress.watch/mcp/{space_uuid}'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "progress-watch": {
            "type": "http",
            "url": "https://progress.watch/mcp/{space_uuid}"
        }
    }
}

التوثيق

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

المحتويات
  1. Progress Watch
  2. ☁️ Hosted
  3. Features
  4. Deploy
  5. Reporting into it
  6. Documentation
  7. Development
  8. License

Progress Watch

Open source progress tracking for anything that runs without you

A nightly crawl, a training run, a migration, a CI pipeline, an AI agent working through a long task — they all run for hours with nobody watching. Progress Watch gives them one place to report to, one place for you to look, and a push notification when they finish.

This repository is the server. The command line client is progresswatch-cli.

☁️ Hosted

| 📖 Documentation

Features

  • CLI for shells and CI jobs
  • MCP server and an agent skill for AI agents
  • One HTTP request from anything else, no SDK needed
  • Counts, not just percentages: 1200 / 50000 pages
  • Steps, one level deep
  • Live dashboard in the browser
  • Web Push when something finishes, with nothing to register with Apple or Google
  • No accounts: a space UUID is the credential
  • Progress stays out of the database, so it never grows
  • SQLite or PostgreSQL

Deploy

RenderDigitalOceanRailway
Docker
docker run --name progresswatch -p 7979:3000 -v progresswatch:/data progresswatch/progresswatch

Then open http://localhost:7979. It uses SQLite by default; set DATABASE_URL to use PostgreSQL.

Docker Compose
services:
  progresswatch:
    image: progresswatch/progresswatch:latest
    container_name: progresswatch
    restart: unless-stopped
    ports:
      - 7979:3000
    volumes:
      - progresswatch:/data

volumes:
  progresswatch:
docker compose up -d

Everything is configured with environment variables.

Reporting into it

npm install -g progresswatch
progresswatch space new "My work"

TASK=$(progresswatch new "Crawl docs")
progresswatch update $TASK --current 1200 --end 50000 --values pages=1200
progresswatch done $TASK

Or wrap a command you cannot change; that reports a start and a finish, not counts:

progresswatch run "python train.py"

Documentation

Development

Ruby 4.0.9 (see .tool-versions), Node 22, and a local Redis.

bundle install
npm install
bin/rails db:prepare
bin/dev

Set PW_PORT to move the server, since foreman overrides PORT. docker compose up runs the published image, not your checkout.

bundle exec rspec
bundle exec rubocop

Run ./bin/shakapacker once before the specs if bin/dev has not built the assets yet. Migrations have to run on both SQLite and PostgreSQL, and CI checks both.

License

Distributed under the AGPL-3.0 license.

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

ما هو Progress Watch؟

Report progress from any script or agent and get notified when it finishes.

كيف أثبّت Progress Watch؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http progress-watch 'https://progress.watch/mcp/{space_uuid}'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Progress Watch إلى مفتاح API؟

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

هل Progress Watch مفتوح المصدر؟

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

من يصون Progress Watch؟

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

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