Progressor

Progressor

AI が何を作っているか、ステップごとに、自動更新されるページで確認できます。

AI コーディングアシスタントに作りたいものを伝えると、Progressor は作業を 目標 と ステップ に分けて計画させ、作業中は計画を最新の状態に保ち、計画から外れる必要があるときはその旨を伝えさせます。ブラウザーのダッシュボードで、AI が今何をしているか、どこまで進んだか、停止しているかどうかを確認できます。すべて AI が管理するので、あなたが何かする必要はありません。

Claude Code、Claude Desktop、Copilot を搭載した VS Code、Cursor、Windsurf、Codex などのように、MCP（AI アプリにツールを追加する標準規格）に対応したあらゆるアプリで使えます。

進捗は決して失われません

AI とのチャットは記憶を忘れてしまいます。長いチャットは記憶が圧縮され、新しいチャットは何も覚えていない状態で始まり、別のアプリや AI ツールに切り替えると、通常はプロジェクトのことを最初から説明し直さなければなりません。Progressor を使えば、こうしたことがあっても進捗は失われません。

• すべてプロジェクトに保存されます。 目標、各ステップとその進捗状況、寄り道とその理由、作業中に決めたこと、メモ、ルール、そしてプロジェクトの 重要なコンテキスト（プロジェクトの概要と重要な事実）は、チャットではなくプロジェクトフォルダー内のプレーンなファイルに保存されます。
• 新しいチャットは前回の続きから始まります。 新しいチャットも、記憶が圧縮された後のチャットも、毎回計画を読み込んでから始まります。何も最初から説明する必要はありません。「続けて」 と伝えるだけです。
• アプリや AI ツールを自由に切り替えられます。 計画はアプリではなく、プロジェクトに紐づいています。Claude Code で始めて、Cursor や VS Code で続けると、次の AI も正確に進捗を把握できます。
• あなたにも AI にも状況が明確です。 AI が読むのと同じ計画をダッシュボードで確認できるので、完了したこと、進行中のこと、あなたの対応を待っていることがいつでもわかります。

セットアップ

Node.js 22 以降が必要です。作業中のプロジェクトで、AI とのチャットに次の内容を貼り付けてください。

Set up Progressor (https://github.com/racstan/progressor-mcp) for this project:
1. Run `node --version`. If it is older than 22, stop and tell me how to install Node.
2. Run `npm install -g progressor-mcp`.
3. If you are Claude Code, run `progressor-mcp init --yes` in this folder. Otherwise, add
   the "progressor" MCP server to this app's settings as the guide for this app shows
   (https://github.com/racstan/progressor-mcp/blob/main/docs/apps.md), then run
   `progressor-mcp init --yes --no-server` in this folder.
4. Tell me to restart the app, and to approve the "progressor" server if it asks.
   After the restart, call get_status and tell me in plain words that Progressor is
   ready, with the dashboard link.

あとは AI がすべて行います。各プロジェクトでセットアップせずに Progressor を使うには、アプリの全プロジェクト共通の設定に一度だけ追加してください（アプリごとの設定方法）。自分で設定する場合は、使い始めるで手順を確認できます。また、アプリのセットアップには、各アプリに必要な設定が記載されています。

あとは AI に話しかけるだけです

いつもと同じように、作りたいものを伝えてください。たとえば、「Google サインイン付きのログインページを追加して。」 と伝えます。AI が作業を目標として計画し、ステップを表示して、作業を始めます。コマンドを覚える必要はありません。AI に何かを促したいときは、多くのアプリの / メニューで次の操作を使えます。

• /progressor:next：作業を中断したところから続ける
• /progressor:status：現在の状況を数行で確認する
• /progressor:plan：一緒に新しい計画を立てる

動作を確認する

AI のアプリを開いた状態で http://localhost:4747 を開きます（リンクは AI が教えてくれます）。次の情報が表示されます。

• AI が何をしているか：AI が作業中 · 7 ステップ中 3 番目 · 最終更新 2 分前、またはチャットが閉じている場合は AI は停止中。
• マップ形式の計画：各ステップが一本の線上の停留所として表示され、完了するとチェックマークが付きます。AI が何かに対処するため計画から外れた場合は、理由とともに寄り道が枝分かれして表示されます。
• 目標：プロジェクトで計画しているすべての内容と、それぞれの進捗状況が表示されます。
• 所要時間：AI が各ステップの所要時間を見積もり、ページにはおおよそのスケジュールが表示されます。現在：2 人のヘルパーが作業中、同時に最大 2 人 · 次の作業：ログアウトの追加 · ログインは約 3 時間で完了（未見積もりのステップが 2 つ）。各ステップには、見積もりの横に実際にかかった時間が表示されます。AI に 「ヘルパーは同時に最大 2 人まで」 と伝えると、その上限が守られるため、お使いのコンピューターやチェック処理が追いつきます。
• あなたの対応待ちの項目：AI があなたに何かを試すよう求めると、目標が琥珀色になり、あなたの対応待ち と表示されます。ヘルパーエージェントに割り当てられたステップ、チェック済みのステップ、リリース済みのステップもそれぞれ表示され、各目標には途中で下された決定が一覧表示されます。

あるプロジェクトの作業を、別のプロジェクトに記録できます。 あるプロジェクトのチャットで別のプロジェクトの作業（たとえば、アプリで使っているライブラリのリリース）を行った場合、別のプロジェクトでチャットを開かなくても、そのプロジェクトの計画に作業を記録できます。そうした変更には 更新元 タグが付き、そのプロジェクトの AI にも通知されます。

すべてのプロジェクトを 1 つのダッシュボードで管理できます。 すべてのプロジェクトを確認するために、プロジェクトごとに Progressor を用意する必要はありません。どのプロジェクトでも、どのアプリでも、Progressor を使う AI チャットが 1 つでも実行中であれば、同じページに利用したすべてのプロジェクトが表示されます。サイドバーの上部で切り替えるか、🗂 すべてのプロジェクトを選択して並べて表示できます。各プロジェクトの計画はそれぞれのフォルダーに保存されるため、別々のプロジェクトのチャットが、別々のアプリであっても互いに干渉することはありません。

ページでできるのは確認のみです。計画は AI に話しかけて変更します。詳しくはダッシュボードガイドをご覧ください。

問題が起きた場合

ほとんどの問題は AI に尋ねることで解決できます。トラブルシューティングには、よくある問題と、それぞれ AI に貼り付けられる一文が記載されています。それでも解決しない場合は、問題を報告するか、ダッシュボードの ❓ ヘルプを使ってください。お使いのバージョンとシステム情報が自動入力されます。

ドキュメント

• はじめに：セットアップを順を追って説明します
• アプリのセットアップ：Claude Code、Claude Desktop、VS Code、Cursor、Windsurf、Codex など
• Progressor の使い方：目標、ステップ、寄り道、AI への伝え方
• ダッシュボード：ページのすべての項目
• よくある質問とトラブルシューティング
• 更新と削除
• リファレンス：コマンド、AI のツール、設定、ファイル形式について知りたい方向け
• コントリビューション：Progressor 自体の開発について

フィードバック

Progressor はまだ新しいプロジェクトです。皆さんが遭遇することが、今後の開発に活かされます。アイデアやフィードバックをお寄せください。一言だけでも役立ちます。または未解決の課題をご覧ください。

サポート

Progressor は無料のオープンソースです。役に立った場合は、コーヒーをおごることで支援できます。このリンクはダッシュボードの ⚙️ 設定にもあります。

ライセンス

Copyright (C) 2026 Rachit Asthana

Progressor はフリーソフトウェアです。Free Software Foundation が公開する GNU General Public License の条項に従い、再配布および改変できます。ライセンスのバージョンは 3、またはそれ以降の任意のバージョンを選択できます。本ソフトウェアは有用であることを期待して配布されますが、商品性や特定目的への適合性を含め、いかなる保証もありません。全文については LICENSE をご覧ください。