Progress Watch
Report progress from any script or agent and get notified when it finishes.
What can you do with 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
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}"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on 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.
Frequently asked questions
What is Progress Watch?
Report progress from any script or agent and get notified when it finishes.
How do I install Progress Watch?
It runs as a remote server. In Claude Code: claude mcp add --transport http progress-watch 'https://progress.watch/mcp/{space_uuid}'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Progress Watch need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Progress Watch open source?
Yes. Its code is on GitHub under the AGPL-3.0 license.
Who maintains Progress Watch?
It is published by progress-watch. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.