Progress Watch

Official registry AI and agents

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).

Remote (streamable-http)
Claude Code
claude mcp add --transport http progress-watch 'https://progress.watch/mcp/{space_uuid}'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "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.

Contents
  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.

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.