NA

nx9161/agent-progress-bar

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

0 stars 0 forks 质量 79 趋势 20MIT

通用开源的AI代理进度条:实时0-100%进度条、倒计时和通过MCP连接器的阶段滚动条。

概览

一个开源(MIT)、与代理无关的进度层:一个实时演示网站、一个进度报告协议、一个MCP服务器“连接器”、一个可嵌入的小部件,以及一个实时层——一个本地事件汇和一个本地主机仪表盘——这样(ChatGPT、DeepSeek、Kimi、Claude、Gemini)可以显示相同的实时模块:0–100%条、百分比计数器、倒计时和阶段跑马灯。 该项目不会也不能向ChatGPT、Claude、Gemini、DeepSeek、Kimi或其他任何应用注入进度条。“支持所有AI代理”意味着:一个开放的、可采纳的层,代理构建者和代理自愿连接进度。任何承诺“ChatGPT内部有进度条”的人都是在卖幻想。 - 发布协议(PROTOCOL.md + 协议/schema.json),任何代理都能使用。- 任何兼容MCP的代理连接并报告进度的MCP服务器。- 本地事件汇报:每次进度报告都附加到你机器上的JSONL日志中——无网络,无账户(参见“Live 层”和“隐私”)。

概述(AI 翻译)

一个开源(MIT)、与代理无关的进度层:一个实时演示网站,一个 进度报告协议,MCP服务器“连接器”,可嵌入 小部件,以及一个实时层——本地事件汇和本地主机仪表盘—— 所以任何具有可见思维的AI代理(ChatGPT、DeepSeek、Kimi, Claude, Gemini)可以显示相同的活性模块:0–100%条,一个百分比计数器,一个 倒计时,还有舞台跑马灯。

现场演示

https://nx9161.github.io/agent-progress-bar/

残酷的真相——先读这篇

我们无法修改任何第三方客户端的用户界面。 本项目不允许 无法向ChatGPT、Claude、Gemini、DeepSeek、Kimi或 任何其他应用。“适用于所有AI代理”意味着:一个开放的、可被采纳的层 特工建造者和特工自愿绑定线路。任何承诺的人 “ChatGPT里的进度条”是在卖幻想。

这是什么

  • 发布协议(PROTOCOL.md + protocol/schema.json),任何代理都能说话。
  • 任何兼容MCP代理连接并报告进度的MCP服务器。
  • 本地事件汇入:每个进度报告都附加到JSONL日志中 你的电脑——没有网络,没有账户(参见“Live 层”和“隐私”)。

本页由 AI 翻译,技术细节请以原文为准。

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:

在 GitHub 查看完整 README

安装

npx -y agent-progress-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "agent-progress": { "command": "npx", "args": ["-y", "agent-progress-mcp"], "env": { "PROGRESS_TTL_MS": "1800000", "LOG_LEVEL": "info" } } } }