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»).
claude mcp add --transport http progress-watch 'https://progress.watch/mcp/{space_uuid}'
{
"mcpServers": {
"progress-watch": {
"type": "http",
"url": "https://progress.watch/mcp/{space_uuid}"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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
| Render | DigitalOcean | Railway |
|---|---|---|
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
- Get started
- CLI · Agent skill · MCP · curl
- API Reference
- Self-hosting
- Notifications
- Environment variables
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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.