[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-kibitzsh--kibitz":3,"tool-kibitzsh--kibitz":64},[4,23,32,40,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":22},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,2,"2026-04-05T10:45:23",[13,14,15,16,17,18,19,20,21],"图像","数据工具","视频","插件","Agent","其他","语言模型","开发框架","音频","ready",{"id":24,"name":25,"github_repo":26,"description_zh":27,"stars":28,"difficulty_score":29,"last_commit_at":30,"category_tags":31,"status":22},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,3,"2026-04-05T11:12:22",[19,17,20,16],{"id":33,"name":34,"github_repo":35,"description_zh":36,"stars":37,"difficulty_score":10,"last_commit_at":38,"category_tags":39,"status":22},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[16,19,17],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":10,"last_commit_at":46,"category_tags":47,"status":22},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",64261,"2026-04-05T11:08:43",[17,16],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":22},193,"meilisearch","meilisearch\u002Fmeilisearch","Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。\n\nMeilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。",56964,"2026-04-05T08:19:14",[13,17,14,20,16,18],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":22},4022,"awesome-claude-skills","ComposioHQ\u002Fawesome-claude-skills","awesome-claude-skills 是一个精心整理的开源资源库，旨在帮助用户挖掘和扩展 Claude AI 的潜力。它不仅仅是一份列表，更提供了实用的“技能（Skills）”模块，让 Claude 从单纯的文本生成助手，进化为能执行复杂工作流的智能代理。\n\n许多用户在使用 AI 时，常受限于其无法直接操作外部软件或处理特定格式文件的痛点。awesome-claude-skills 通过预设的工作流解决了这一问题：它不仅能教会 Claude 专业地处理 Word、PDF 等文档，进行代码开发与数据分析，还能借助 Composio 插件连接 Slack、邮箱及数百种常用应用，实现发送邮件、创建任务等自动化操作。这使得重复性任务变得标准化且可复用，极大提升了工作效率。\n\n无论是希望优化日常办公流程的普通用户、需要处理复杂文档的研究人员，还是寻求将 AI 深度集成到开发管线中的开发者，都能从中找到适合的解决方案。其独特的技术亮点在于“技能”的可定制性与强大的应用连接能力，让用户无需编写复杂代码，即可通过简单的配置让 Claude 具备跨平台执行真实任务的能力。如果你希望让 Claude",51312,"2026-04-05T19:04:23",[17,16],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":80,"owner_email":80,"owner_twitter":80,"owner_website":81,"owner_url":82,"languages":83,"stars":100,"forks":101,"last_commit_at":102,"license":103,"difficulty_score":10,"env_os":104,"env_gpu":105,"env_ram":105,"env_deps":106,"category_tags":112,"github_topics":113,"view_count":29,"oss_zip_url":80,"oss_zip_packed_at":80,"status":22,"created_at":121,"updated_at":122,"faqs":123,"releases":124},893,"kibitzsh\u002Fkibitz","kibitz","Real-time decoded feed of AI agent actions — monitor multiple Claude Code & Codex sessions, see exactly what each agent is doing, and coordinate swarms efficiently","Kibitz 是一款 VS Code 插件兼命令行工具，专为需要同时管理多个 AI 编程助手的开发者设计。它能实时监控 Claude Code 和 Codex 的运行状态，把各个会话的操作转化为易读的实时 commentary，让你一眼看清每个 AI 代理正在做什么。\n\n当你同时开启多个 AI 会话处理不同任务时，Kibitz 解决了\"窗口切来切去、状态全靠猜\"的痛点。通过一个统一的 composer 界面，你可以直接向任意活跃会话派发指令，或快速新建会话，无需在终端和编辑器之间来回跳转。支持 `\u002F1`、`\u002F2` 等快捷指令切换目标，还能设置 `\u002Finterval` 调整摘要频率，让多会话协作变得可控。\n\n核心亮点在于\"跨会话调度\"能力——Kibitz 不是简单的日志查看器，而是能主动介入、发送 prompt 并追踪状态（queued → started → sent → failed）。无论是想批量协调 AI 代理集群，还是精细管理单个长任务，都能胜任。\n\n适合频繁使用 Claude Code、Codex 等终端 AI 工具的中高级开发者，特别是需要并行处理多个代码任务、或团队协作中","Kibitz 是一款 VS Code 插件兼命令行工具，专为需要同时管理多个 AI 编程助手的开发者设计。它能实时监控 Claude Code 和 Codex 的运行状态，把各个会话的操作转化为易读的实时 commentary，让你一眼看清每个 AI 代理正在做什么。\n\n当你同时开启多个 AI 会话处理不同任务时，Kibitz 解决了\"窗口切来切去、状态全靠猜\"的痛点。通过一个统一的 composer 界面，你可以直接向任意活跃会话派发指令，或快速新建会话，无需在终端和编辑器之间来回跳转。支持 `\u002F1`、`\u002F2` 等快捷指令切换目标，还能设置 `\u002Finterval` 调整摘要频率，让多会话协作变得可控。\n\n核心亮点在于\"跨会话调度\"能力——Kibitz 不是简单的日志查看器，而是能主动介入、发送 prompt 并追踪状态（queued → started → sent → failed）。无论是想批量协调 AI 代理集群，还是精细管理单个长任务，都能胜任。\n\n适合频繁使用 Claude Code、Codex 等终端 AI 工具的中高级开发者，特别是需要并行处理多个代码任务、或团队协作中需要统一监控 AI 进度的场景。Windows、macOS 全支持，Linux 也能用。","# Kibitz\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n[![VS Code Marketplace](https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fkibitzsh.kibitz)](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=kibitzsh.kibitz)\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@kibitzsh\u002Fkibitz)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@kibitzsh\u002Fkibitz)\n[![Pages](https:\u002F\u002Fgithub.com\u002Fkibitzsh\u002Fkibitz\u002Factions\u002Fworkflows\u002Fpages.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fkibitzsh\u002Fkibitz\u002Factions\u002Fworkflows\u002Fpages.yml)\n[![Website](https:\u002F\u002Fimg.shields.io\u002Fwebsite?url=https%3A%2F%2Fkibitz.sh)](https:\u002F\u002Fkibitz.sh)\n\nKibitz is a VS Code extension + CLI that watches Claude\u002FCodex sessions, generates live commentary, and lets you dispatch prompts to existing or new sessions from one composer.\n\n## Install\n\n**VS Code Extension** — install from the [VS Code Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=kibitzsh.kibitz) or search `Kibitz` in the Extensions panel.\n\n**CLI — Homebrew (macOS \u002F Linux)**\n```bash\nbrew install kibitzsh\u002Ftap\u002Fkibitz\n```\n\n**CLI — npm**\n```bash\nnpm install -g @kibitzsh\u002Fkibitz\n```\n\n## Compatibility Matrix (Contract)\n\n| Platform | VS Code panel | Terminal CLI |\n| --- | --- | --- |\n| macOS | Supported | Supported |\n| Windows | Supported | Supported |\n| Linux | Best effort | Best effort |\n\n## Core Capabilities\n\n- Live commentary feed for Claude Code and Codex sessions.\n- Cross-session prompt dispatch:\n  - Existing active sessions.\n  - New session on current provider.\n- Slash controls in composer:\n  - `\u002Fhelp`, `\u002Fpause`, `\u002Fresume`, `\u002Fclear`, `\u002Ffocus`, `\u002Fmodel`, `\u002Fpreset`, `\u002Finterval`, `\u002Fupdate`\n  - session targeting like `\u002F1`, `\u002F2`\n- Provider-aware model handling.\n- Strict dispatch status events: `queued`, `started`, `sent`, `failed`.\n\n## Prompt Dispatching\n\nKibitz can send prompts to any active watched session (Claude or Codex), or start a new session on the current provider.\n\n### VS Code Panel\n\n- Target badges always include:\n  - `\u002F1 New session (current provider)`\n  - `\u002F2..N` existing active sessions from the watcher list\n- Starting a new terminal session is one step: select `\u002F1` and send your prompt.\n- Select a target by:\n  - clicking a target badge\n  - typing `\u002FN` (select only)\n  - typing `\u002FN \u003Cprompt>` or `N\u002F \u003Cprompt>` (select + send)\n- Plain text (without target token) sends to the currently selected target.\n- Each send emits explicit status updates: `queued`, `started`, `sent`, `failed`.\n\n### Terminal CLI\n\n- Use `\u002Fsessions` to list active sessions with numeric indexes.\n- Set target with `\u002Ftarget \u003Cindex|agent:sessionId|new-codex|new-claude>`.\n- Set summary cadence with `\u002Finterval \u003C15s|30s|1m|5m|15m|1h>`.\n- Check for updates with `\u002Fupdate`.\n- Starting a new terminal session is one command: `\u002Ftarget new-codex` (or `\u002Ftarget new-claude`), then send plain text.\n- After target selection, plain text sends to that target.\n- Dispatch status is printed for every send: `queued`, `started`, `sent`, `failed`.\n\n### Scope and Limits\n\n- Targeting is limited to active sessions in the watcher window (recent activity).\n- Multi-target broadcast in one send is not implemented.\n\n## Development Setup\n\n### Prerequisites\n\n- Node.js 20+\n- npm 10+\n- VS Code 1.85+\n- At least one provider CLI installed and authenticated:\n  - `codex` \u002F `codex.cmd`\n  - `claude` \u002F `claude.cmd`\n\n### Build\n\n```bash\nnpm ci\nnpm run build\n```\n\n### Deploy to Local VS Code\u002FCursor\n\n```bash\nnpm run deploy:vscode\n```\n\nThis copies `dist\u002F` and `package.json` into your local extensions directory and replaces older Kibitz extension folders.\n\n### Run CLI\n\n```bash\nnpm run build\nnode dist\u002Fcli\u002Findex.js\n```\n\n## Testing\n\n```bash\nnpm run typecheck\nnpm run check:compat\nnpm run test:ui\nnpm run test:download-digest\nnpm run test:all\n```\n\nUseful targeted checks:\n\n```bash\nnpm run test:parsers\nnpm run check:session-names\nnpm run check:model-persistence\n```\n\n## Release Flow\n\n1. Local smoke and package:\n   - `npm run deploy:vscode` (local install to VS Code\u002FCursor)\n   - `npm run package` (builds `.vsix`)\n2. Full guarded release flow:\n   - `npm run cr`\n3. `npm run cr` performs checks\u002Fbuild, bumps version, publishes VS Code Marketplace + npm, verifies versions, updates Homebrew formula, and pushes tags.\n4. For GitHub auto-release on tag push, add repository secrets:\n   - `VSCE_PAT` (VS Marketplace publish PAT)\n   - `NPM_TOKEN` (npm publish token)\n   - `HOMEBREW_TAP_TOKEN` (GitHub token with write access to `kibitzsh\u002Fhomebrew-kibitz`)\n5. For daily download digest email workflow (`.github\u002Fworkflows\u002Frelease-download-digest.yml`), add:\n   - `RESEND_API_KEY` (Resend API key)\n   - `HOMEBREW_TAP_TOKEN` (GitHub token with read access to `kibitzsh\u002Fhomebrew-kibitz` traffic API)\n   - sender is fixed to `stats@kibitz.sh`\n   - recipient is fixed to `vasilytrofimchuk@gmail.com`\n\n## Daily Download Digest Emails\n\n- Workflow: `.github\u002Fworkflows\u002Frelease-download-digest.yml`\n- Script: `scripts\u002Fdownload-digest.js`\n- Schedule: 9:00 AM PT daily (with UTC cron + PT hour guard)\n- Sender: `stats@kibitz.sh`\n- Recipient: `vasilytrofimchuk@gmail.com`\n- Sources:\n  - VS Marketplace `downloadCount` for `kibitzsh.kibitz`\n  - GitHub Releases asset `download_count` for `kibitzsh\u002Fkibitz`\n  - npm range total downloads for `@kibitzsh\u002Fkibitz`\n  - Homebrew tap clone traffic proxy from `kibitzsh\u002Fhomebrew-kibitz` (`\u002Ftraffic\u002Fclones`)\n- State cache file: `.cache\u002Fdownload-digest\u002Fstate.json`\n- Behavior:\n  - first run initializes baseline (no email),\n  - zero-delta days skip email,\n  - positive delta sends digest email.\n- Manual run:\n  - GitHub Actions → `Daily Download Digest` → `Run workflow`\n- Local smoke test (with real send):\n  ```bash\n  RESEND_API_KEY=... \\\n  RESEND_FROM_EMAIL=stats@kibitz.sh \\\n  ALERT_EMAIL_TO=vasilytrofimchuk@gmail.com \\\n  HOMEBREW_TAP_TOKEN=... \\\n  ENFORCE_9AM_PT=0 \\\n  DOWNLOAD_DIGEST_STATE_FILE=\u002Ftmp\u002Fkibitz-digest-test-state.json \\\n  node scripts\u002Fdownload-digest.js\n  ```\n\n## Distribution Channels\n\n## 1) VS Code Extension Marketplace\n\n- Create publisher in VS Marketplace (if not already created).\n- Create Azure DevOps PAT with Marketplace publish scopes.\n- Publish with `npm run publish:vscode` (`VSCE_PAT` required).\n- Recommended:\n  - publish stable versions to Marketplace,\n  - keep `.vsix` artifacts in GitHub Releases for manual install\u002Frollback.\n\n## 2) OpenVSX (for Cursor\u002FVSCodium ecosystems)\n\n- Publish the same extension package to OpenVSX.\n- Keep version parity with Marketplace.\n\n## 3) npm (CLI distribution)\n\n- Keep `bin.kibitz` pointing to `dist\u002Fcli\u002Findex.js`.\n- Publish package to npm.\n- Users can install globally and run `kibitz`.\n\n## 4) Homebrew\n\nTwo common paths:\n\n- Formula that installs from npm:\n  - wraps `npm install -g kibitz`.\n- Tap formula that downloads built tarball\u002Fbinary and installs launcher.\n\nFor VS Code extensions specifically, Homebrew is optional and usually secondary to Marketplace\u002FOpenVSX.\n\n## 5) GitHub Releases\n\n- Upload `.vsix` and changelog per version.\n- Add quick install instructions:\n  - `code --install-extension \u003Cfile>.vsix`\n\n## Recommended Distribution Stack\n\nFor most users, start with:\n\n1. VS Marketplace (primary VS Code install path)\n2. OpenVSX (secondary ecosystem coverage)\n3. npm (CLI users)\n4. GitHub Releases (`.vsix` artifact + release notes)\n\nAdd Homebrew only if your CLI install demand is high and you want one-command setup for macOS\u002FLinux.\n\n## Docs\n\n- [Support matrix details](docs\u002FSUPPORT_MATRIX.md)\n- [Compatibility release checklist](docs\u002FCOMPAT_CHECKLIST.md)\n\n## Legal\n\n- [License (MIT)](LICENSE)\n- [Privacy Policy](PRIVACY.md)\n- [Terms of Use](TERMS.md)\n\n## Cross-Platform Notes\n\nKibitz mirrors proven `room` patterns:\n\n- Login-shell PATH inheritance on macOS.\n- npm global prefix PATH enrichment on Windows.\n- Windows `.cmd` command mapping (`claude.cmd`, `codex.cmd`).\n- Platform-parameterized compatibility tests.\n","# Kibitz\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n[![VS Code Marketplace](https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fkibitzsh.kibitz)](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=kibitzsh.kibitz)\n[![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@kibitzsh\u002Fkibitz)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@kibitzsh\u002Fkibitz)\n[![Pages](https:\u002F\u002Fgithub.com\u002Fkibitzsh\u002Fkibitz\u002Factions\u002Fworkflows\u002Fpages.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fkibitzsh\u002Fkibitz\u002Factions\u002Fworkflows\u002Fpages.yml)\n[![Website](https:\u002F\u002Fimg.shields.io\u002Fwebsite?url=https%3A%2F%2Fkibitz.sh)](https:\u002F\u002Fkibitz.sh)\n\nKibitz 是一个 VS Code 扩展 + CLI（命令行界面）工具，用于监视 Claude\u002FCodex 会话，生成实时评论，并允许你从一个 composer（编辑器）向现有或新会话发送提示词。\n\n## 安装\n\n**VS Code 扩展** — 从 [VS Code Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=kibitzsh.kibitz) 安装，或在扩展面板中搜索 `Kibitz`。\n\n**CLI — Homebrew（macOS \u002F Linux）**\n```bash\nbrew install kibitzsh\u002Ftap\u002Fkibitz\n```\n\n**CLI — npm**\n```bash\nnpm install -g @kibitzsh\u002Fkibitz\n```\n\n## 兼容性矩阵（合约）\n\n| 平台 | VS Code 面板 | 终端 CLI |\n| --- | --- | --- |\n| macOS | 支持 | 支持 |\n| Windows | 支持 | 支持 |\n| Linux | 尽力支持 | 尽力支持 |\n\n## 核心功能\n\n- 为 Claude Code 和 Codex 会话提供实时评论流。\n- 跨会话提示词分发：\n  - 现有活动会话。\n  - 当前提供商的新会话。\n- Composer 中的斜杠控制：\n  - `\u002Fhelp`、`\u002Fpause`、`\u002Fresume`、`\u002Fclear`、`\u002Ffocus`、`\u002Fmodel`、`\u002Fpreset`、`\u002Finterval`、`\u002Fupdate`\n  - 会话目标指定如 `\u002F1`、`\u002F2`\n- 提供商感知的模型处理。\n- 严格的分发状态事件：`queued`（已排队）、`started`（已开始）、`sent`（已发送）、`failed`（失败）。\n\n## 提示词分发\n\nKibitz 可以向任何活动的受监视会话（Claude 或 Codex）发送提示词，或在当前提供商上启动新会话。\n\n### VS Code 面板\n\n- 目标徽章始终包含：\n  - `\u002F1 New session (current provider)`（新会话，当前提供商）\n  - `\u002F2..N` 来自监视列表的现有活动会话\n- 启动新终端会话只需一步：选择 `\u002F1` 并发送你的提示词。\n- 通过以下方式选择目标：\n  - 点击目标徽章\n  - 输入 `\u002FN`（仅选择）\n  - 输入 `\u002FN \u003Cprompt>` 或 `N\u002F \u003Cprompt>`（选择 + 发送）\n- 纯文本（无目标令牌）发送到当前选定的目标。\n- 每次发送都会发出明确的状态更新：`queued`、`started`、`sent`、`failed`。\n\n### 终端 CLI\n\n- 使用 `\u002Fsessions` 列出带有数字索引的活动会话。\n- 使用 `\u002Ftarget \u003Cindex|agent:sessionId|new-codex|new-claude>` 设置目标。\n- 使用 `\u002Finterval \u003C15s|30s|1m|5m|15m|1h>` 设置摘要频率。\n- 使用 `\u002Fupdate` 检查更新。\n- 启动新终端会话只需一个命令：`\u002Ftarget new-codex`（或 `\u002Ftarget new-claude`），然后发送纯文本。\n- 选择目标后，纯文本将发送到该目标。\n- 每次发送都会打印分发状态：`queued`、`started`、`sent`、`failed`。\n\n### 范围和限制\n\n- 目标限定于监视窗口中的活动会话（近期活动）。\n- 单次发送的多目标广播功能尚未实现。\n\n## 开发环境设置\n\n### 前置要求\n\n- Node.js 20+\n- npm 10+\n- VS Code 1.85+\n- 至少安装并认证一个提供商 CLI：\n  - `codex` \u002F `codex.cmd`\n  - `claude` \u002F `claude.cmd`\n\n### 构建\n\n```bash\nnpm ci\nnpm run build\n```\n\n### 部署到本地 VS Code\u002FCursor\n\n```bash\nnpm run deploy:vscode\n```\n\n此命令将 `dist\u002F` 和 `package.json` 复制到你的本地扩展目录，并替换旧的 Kibitz 扩展文件夹。\n\n### 运行 CLI\n\n```bash\nnpm run build\nnode dist\u002Fcli\u002Findex.js\n```\n\n## 测试\n\n```bash\nnpm run typecheck\nnpm run check:compat\nnpm run test:ui\nnpm run test:download-digest\nnpm run test:all\n```\n\n有用的针对性检查：\n\n```bash\nnpm run test:parsers\nnpm run check:session-names\nnpm run check:model-persistence\n```\n\n## 发布流程\n\n1. 本地冒烟测试和打包：\n   - `npm run deploy:vscode`（本地安装到 VS Code\u002FCursor）\n   - `npm run package`（构建 `.vsix`）\n2. 完整的受保护发布流程：\n   - `npm run cr`\n3. `npm run cr` 执行检查\u002F构建、版本升级、发布到 VS Code Marketplace 和 npm、验证版本、更新 Homebrew 公式，并推送标签。\n4. 如需在标签推送时自动触发 GitHub 发布，请添加仓库密钥：\n   - `VSCE_PAT`（VS Marketplace 发布 PAT，个人访问令牌）\n   - `NPM_TOKEN`（npm 发布令牌）\n   - `HOMEBREW_TAP_TOKEN`（具有 `kibitzsh\u002Fhomebrew-kibitz` 写入权限的 GitHub 令牌）\n5. 如需每日下载摘要邮件工作流（`.github\u002Fworkflows\u002Frelease-download-digest.yml`），请添加：\n   - `RESEND_API_KEY`（Resend API 密钥）\n   - `HOMEBREW_TAP_TOKEN`（具有 `kibitzsh\u002Fhomebrew-kibitz` 流量 API 读取权限的 GitHub 令牌）\n   - 发件人固定为 `stats@kibitz.sh`\n   - 收件人固定为 `vasilytrofimchuk@gmail.com`\n\n## 每日下载摘要邮件\n\n- 工作流：`.github\u002Fworkflows\u002Frelease-download-digest.yml`\n- 脚本：`scripts\u002Fdownload-digest.js`\n- 计划：每日太平洋时间上午 9:00（UTC cron + PT 小时守卫）\n- 发件人：`stats@kibitz.sh`\n- 收件人：`vasilytrofimchuk@gmail.com`\n- 数据来源：\n  - VS Marketplace `downloadCount`（下载计数）for `kibitzsh.kibitz`\n  - GitHub Releases 资源 `download_count`（下载计数）for `kibitzsh\u002Fkibitz`\n  - npm 范围总下载量 for `@kibitzsh\u002Fkibitz`\n  - Homebrew tap 克隆流量代理 from `kibitzsh\u002Fhomebrew-kibitz` (`\u002Ftraffic\u002Fclones`)\n- 状态缓存文件：`.cache\u002Fdownload-digest\u002Fstate.json`\n- 行为：\n  - 首次运行初始化基线（不发送邮件），\n  - 零增量日期跳过邮件，\n  - 正增量发送摘要邮件。\n- 手动运行：\n  - GitHub Actions → `Daily Download Digest` → `Run workflow`\n- 本地冒烟测试（真实发送）：\n  ```bash\n  RESEND_API_KEY=... \\\n  RESEND_FROM_EMAIL=stats@kibitz.sh \\\n  ALERT_EMAIL_TO=vasilytrofimchuk@gmail.com \\\n  HOMEBREW_TAP_TOKEN=... \\\n  ENFORCE_9AM_PT=0 \\\n  DOWNLOAD_DIGEST_STATE_FILE=\u002Ftmp\u002Fkibitz-digest-test-state.json \\\n  node scripts\u002Fdownload-digest.js\n  ```\n\n## 分发渠道\n\n## 1) VS Code 扩展市场\n\n- 在 VS Marketplace 创建发布者（如尚未创建）。\n- 创建具有 Marketplace 发布范围的 Azure DevOps PAT（个人访问令牌）。\n- 使用 `npm run publish:vscode` 发布（需要 `VSCE_PAT`）。\n- 建议：\n  - 向 Marketplace 发布稳定版本，\n  - 在 GitHub Releases 中保留 `.vsix` 工件以供手动安装\u002F回滚。\n\n## 2) OpenVSX（适用于 Cursor\u002FVSCodium 生态系统）\n\n- 将相同的扩展包发布到 OpenVSX。\n- 与 Marketplace 保持版本一致。\n\n## 3) npm（CLI 分发）\n\n- 保持 `bin.kibitz` 指向 `dist\u002Fcli\u002Findex.js`。\n- 将包发布到 npm。\n- 用户可以全局安装并运行 `kibitz`。\n\n## 4) Homebrew\n\n两种常见路径：\n\n- 从 npm 安装的公式：\n  - 包装 `npm install -g kibitz`。\n- 下载构建好的 tarball\u002F二进制文件并安装启动器的 tap 公式。\n\n对于 VS Code 扩展，Homebrew 是可选的，通常次于 Marketplace\u002FOpenVSX。\n\n## 5) GitHub Releases\n\n- 每个版本上传 `.vsix` 和变更日志。\n- 添加快速安装说明：\n  - `code --install-extension \u003Cfile>.vsix`\n\n## 推荐分发渠道栈\n\n对于大多数用户，建议按以下顺序选择：\n\n1. VS Marketplace（VS Code 主要安装途径）\n2. OpenVSX（次要生态系统覆盖）\n3. npm（CLI 用户）\n4. GitHub Releases（`.vsix` 构建产物 + 发布说明）\n\n仅当您的 CLI 安装需求较高，且希望在 macOS\u002FLinux 上一键完成设置时，再添加 Homebrew。\n\n## 文档\n\n- [支持矩阵详情](docs\u002FSUPPORT_MATRIX.md)\n- [兼容性发布检查清单](docs\u002FCOMPAT_CHECKLIST.md)\n\n## 法律信息\n\n- [许可证 (MIT)](LICENSE)\n- [隐私政策](PRIVACY.md)\n- [使用条款](TERMS.md)\n\n## 跨平台说明\n\nKibitz 借鉴了经过验证的 `room` 模式：\n\n- macOS 上继承登录 shell 的 PATH 环境变量。\n- Windows 上增强 npm 全局前缀的 PATH 环境变量。\n- Windows `.cmd` 命令映射（`claude.cmd`、`codex.cmd`）。\n- 平台参数化的兼容性测试。","# Kibitz 快速上手指南\n\n## 环境准备\n\n### 系统要求\n\n| 平台 | VS Code 面板 | 终端 CLI |\n|:---|:---|:---|\n| macOS | ✅ 支持 | ✅ 支持 |\n| Windows | ✅ 支持 | ✅ 支持 |\n| Linux | ⚠️ 尽力支持 | ⚠️ 尽力支持 |\n\n### 前置依赖\n\n- **Node.js** 20+\n- **npm** 10+\n- **VS Code** 1.85+\n- **AI 工具 CLI**（至少安装并登录一个）：\n  - `claude` \u002F `claude.cmd`（Claude Code）\n  - `codex` \u002F `codex.cmd`（OpenAI Codex）\n\n---\n\n## 安装步骤\n\n### 方式一：VS Code 扩展（推荐）\n\n1. 打开 VS Code，进入扩展面板（`Ctrl+Shift+X` \u002F `Cmd+Shift+X`）\n2. 搜索 `Kibitz` 并安装\n3. 或访问 [VS Code Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=kibitzsh.kibitz) 在线安装\n\n### 方式二：CLI 命令行工具\n\n**macOS \u002F Linux（Homebrew）**\n```bash\nbrew install kibitzsh\u002Ftap\u002Fkibitz\n```\n\n**npm（跨平台）**\n```bash\nnpm install -g @kibitzsh\u002Fkibitz\n```\n\n---\n\n## 基本使用\n\n### VS Code 面板操作\n\n**启动新会话并发送提示**\n1. 打开 Kibitz 面板\n2. 点击 `\u002F1 New session (current provider)` 或输入 `\u002F1`\n3. 直接输入提示内容发送\n\n**向现有会话发送提示**\n- 点击目标会话徽章（如 `\u002F2`、`\u002F3`）\n- 或输入 `\u002F2 \u003C你的提示>` 快速选择并发送\n\n**常用快捷指令**\n| 指令 | 功能 |\n|:---|:---|\n| `\u002Fhelp` | 显示帮助 |\n| `\u002Fpause` \u002F `\u002Fresume` | 暂停\u002F恢复监听 |\n| `\u002Fclear` | 清空面板 |\n| `\u002Ffocus` | 聚焦当前会话 |\n| `\u002Fmodel \u003C模型名>` | 切换模型 |\n| `\u002Finterval \u003C15s\\|30s\\|1m\\|5m\\|15m\\|1h>` | 设置摘要频率 |\n\n### 终端 CLI 操作\n\n**查看活跃会话**\n```bash\n\u002Fsessions\n```\n\n**启动新会话**\n```bash\n\u002Ftarget new-claude    # 启动 Claude 新会话\n\u002Ftarget new-codex     # 启动 Codex 新会话\n```\n\n**切换到现有会话**\n```bash\n\u002Ftarget 2             # 按索引切换\n\u002Ftarget agent:abc123  # 按会话 ID 切换\n```\n\n**设置摘要频率**\n```bash\n\u002Finterval 1m\n```\n\n**发送提示**\n设置目标后，直接输入文本即可发送。\n\n---\n\n## 状态说明\n\n每次发送提示后，系统会返回明确状态：\n- `queued` — 已排队\n- `started` — 已开始处理\n- `sent` — 已发送成功\n- `failed` — 发送失败","某中型软件公司的架构团队正在推进遗留系统重构，3 名高级工程师各自使用 Claude Code 处理不同微服务模块，技术负责人需要统筹进度并确保接口对齐。\n\n### 没有 kibitz 时\n\n- 每人独立在终端运行 Claude Code，负责人只能逐个 SSH 登录或询问\"做到哪了\"，获得的是经过转述的二手信息，实际执行细节丢失\n- 某工程师的会话因网络中断静默失败，2 小时后才发现进度停滞，导致联调计划被迫推迟\n- 发现两个模块的 API 契约冲突时，需要分别进入不同终端粘贴上下文重新提示，协调成本极高\n- 凌晨批量跑自动化迁移脚本时，无法集中监控多个并行会话的实时状态，只能事后翻日志排查问题\n\n### 使用 kibitz 后\n\n- 技术负责人在 VS Code 侧边栏打开 kibitz 面板，3 个活跃会话的实时操作流一目了然：谁在分析代码结构、谁在生成测试用例、谁遇到了权限错误\n- 会话状态异常时面板即时标红，配合 `\u002Fpause` 和 `\u002Fresume` 指令可远程干预，网络中断 30 秒内即可感知并恢复\n- 发现 API 冲突后，直接在 kibitz composer 输入 `\u002F2 请参照 \u002F3 的 UserService 接口定义调整你的实现`，跨会话精准 dispatch，无需切换终端\n- 夜间批量任务通过 CLI 的 `\u002Finterval 1m` 设置汇总频率，所有会话的阶段性摘要自动聚合，早晨复盘时完整时间线已就绪\n\nkibitz 将分散的 AI 代理会话转化为可观测、可调度、可协调的统一控制平面，让多智能体协作从\"黑箱盲操\"变为\"透明指挥\"。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fkibitzsh_kibitz_414aaeb3.png","kibitzsh","Kibitz","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fkibitzsh_5741a533.png","Decode your agents",null,"https:\u002F\u002Fkibitz.sh\u002F","https:\u002F\u002Fgithub.com\u002Fkibitzsh",[84,88,92,96],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",63.8,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",28,{"name":93,"color":94,"percentage":95},"HTML","#e34c26",6.5,{"name":97,"color":98,"percentage":99},"Shell","#89e051",1.7,528,7,"2026-04-04T22:50:03","MIT","macOS, Windows, Linux","未说明",{"notes":107,"python":105,"dependencies":108},"需要预先安装并认证 Claude Code 或 Codex CLI 工具（claude\u002Fcodex）。VS Code 扩展支持 macOS 和 Windows，Linux 为尽力支持。CLI 支持 macOS 和 Windows，Linux 为尽力支持。开发构建需要 Node.js 20+ 和 npm 10+。",[109,110,111],"Node.js>=20","npm>=10","VS Code>=1.85",[16],[114,115,116,117,118,119,120],"claude","claudecode","cli","codex","vscode-extension","macos","windows","2026-03-27T02:49:30.150509","2026-04-06T06:46:05.649154",[],[125],{"id":126,"version":127,"summary_zh":128,"released_at":129},103357,"v0.0.5","Kibitz 0.0.5\\n\\n- Bump extension version to 0.0.5\\n- Add stable VS Code publish script via npx\\n- Add npm OTP support to publish script","2026-03-01T02:05:28"]