nx9161/agent-progress-bar
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Universal open-source progress bar for AI agents: live 0-100% bar, countdown, and stage ticker via an MCP connector.
概要
An open-source (MIT), agent-agnostic progress layer: a live demo website, a progress-reporting protocol, an MCP-server "connector", an embeddable widget, and a live layer — a local event sink plus a localhost dashboard — so (ChatGPT, DeepSeek, Kimi, Claude, Gemini) can show the same live module: a 0–100% bar, a % counter, a countdown, and a stage ticker. This project does not and cannot inject a progress bar into ChatGPT, Claude, Gemini, DeepSeek, Kimi, or any other app. "Works with all AI agents" means: an open, adoptable layer that agent builders and agent harnesses wire in voluntarily. Anyone promising "a progress bar inside ChatGPT" is selling a fantasy. - A published protocol (PROTOCOL.md + protocol/schema.json) any agent can speak. - An MCP server any MCP-compatible agent connects to and reports progress through. - A local event sink: every progress report is appended to a JSONL log on your machine — no network, no accounts (see "Live layer" and "Privacy").
README
以下は原文 README の抜粋です。原文を見る。
Universal Agent Progress Bar (UAPB)
An open-source (MIT), agent-agnostic progress layer: a live demo website, a progress-reporting protocol, an MCP-server “connector”, an embeddable widget, and a live layer — a local event sink plus a localhost dashboard — so any AI agent with visible thinking (ChatGPT, DeepSeek, Kimi, Claude, Gemini) can show the same live module: a 0–100% bar, a % counter, a countdown, and a stage ticker.
Live Demo
https://nx9161.github.io/agent-progress-bar/
The hard truth — read this first
We cannot modify any third-party client’s UI. This project does not and cannot inject a progress bar into ChatGPT, Claude, Gemini, DeepSeek, Kimi, or any other app. “Works with all AI agents” means: an open, adoptable layer that agent builders and agent harnesses wire in voluntarily. Anyone promising “a progress bar inside ChatGPT” is selling a fantasy.
What it IS
- A published protocol (
PROTOCOL.md+protocol/schema.json) any agent can speak. - An MCP server any MCP-compatible agent connects to and reports progress through.
- A local event sink: every progress report is appended to a JSONL log on your machine — no network, no accounts (see “Live layer” and “Privacy”).
- A localhost dashboard (
agent-progress dashboard) that renders the event stream live, gated by a per-launch token. - An unofficial dashboard plugin for Hermes (open-source, MIT; see “Hermes plugin”).
- A `` web component + iframe wrapper any page can embed.
- A concept demo showing the proposed UX (simulated run — no AI connected).
What it is NOT
- Not a plugin, extension, or patch for any closed chat client. This project now ships an unofficial dashboard plugin for Hermes — but Hermes is open-source (MIT), and the plugin is installed by the user into their own Hermes copy; it is not injected into any closed client. The hard truth above still applies to ChatGPT, Claude, Gemini, DeepSeek, Kimi, and every other closed app: nobody can inject a progress bar into those.
- Not affiliated with or endorsed by OpenAI, Anthropic, Google, DeepSeek, Moonshot AI, or Nous Research.
- Not a backend service (the live layer is local-only; see non-goals).
Experimental. Progress percentages and time estimates are heuristics, not guarantees. Not warranted for production agent orchestration or any time-critical use. Use at your own risk.
No telemetry, no accounts, no data leaves your machine. The MCP server
keeps reports in memory with a 30-minute TTL and appends them to a local
JSONL event log (~/.agent-progress/events-YYYY-MM-DD.jsonl, files 0600,
7-day retention) — it never phones home.
Quickstarts
1. Try the concept demo (everyone)
Open the self-contained demo page — no build step, no server:
インストール
npx -y agent-progress-mcp設定
{
"mcpServers": {
"agent-progress": {
"command": "npx",
"args": ["-y", "agent-progress-mcp"],
"env": { "PROGRESS_TTL_MS": "1800000", "LOG_LEVEL": "info" }
}
}
}