teamai-cli 0.22.0 → 0.23.0-beta.1

package/README.md

@@ -1,8 +1,8 @@
 <p align="center">
-  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli" width="430">
+  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli">
 </p>
 
-# TeamAI — The team harness for AI agents
+# TeamAI — Make Every Team AI Native
 
 > [English](README.md) | [简体中文](README.zh-CN.md)
 
@@ -11,9 +11,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/teamai-cli.svg)](https://www.npmjs.com/package/teamai-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-Make every AI coding agent work by the best harness.
-
-Git-native management of skills, rules, MCP, env vars, knowledge base, and more — across Claude Code / Codex / CodeBuddy / WorkBuddy / OpenCode and more.
+TeamAI manages your team's skills, rules, MCP, and knowledge across Claude Code, Codex, CodeBuddy, WorkBuddy, OpenCode, Cursor, and other AI agents.
 
 ## Quick Start
 
@@ -46,15 +44,25 @@ Once initialized, every AI session automatically pulls the latest skills / rules
 
 > **Full usage guide:** [docs/usage-guide.md](docs/usage-guide.md) ([中文版](docs/usage-guide.zh-CN.md)) — covers everything from team creation to day-to-day use.
 
+## Product architecture
+
+**Team Execution × Team Context × Team Improvement**:
+
+| Layer | Job | In this CLI today |
+|-------|-----|-------------------|
+| **Team Execution** | Make every agent work the team's way | `init` / `pull` / `push`, skills, rules, agents, hooks, MCP, env |
+| **Team Context** | Make every agent understand the team | recall, learnings, codebase graph, teamwiki... |
+| **Team Improvement** | Make every execution improve the team | friction-based share-learnings, sessions, digest, dashboard... |
+
 ## Overview
 
 <table>
   <thead>
     <tr>
       <th rowspan="2">Agent</th>
-      <th colspan="7">Harness</th>
-      <th colspan="3">Knowledge Base</th>
-      <th colspan="3">Analytics</th>
+      <th colspan="7">Team Execution</th>
+      <th colspan="3">Team Context</th>
+      <th colspan="3">Team Improvement</th>
     </tr>
     <tr>
       <th>skills</th><th>rules</th><th>docs</th><th>env</th><th>agents</th><th>hooks</th><th>mcp</th>
@@ -87,18 +95,9 @@ Team-wide settings an admin configures once and delivers to every member on `tea
 | **Tags** | `teamai tags` | Tag skills / rules so members subscribe to just the tags they need. |
 | **Sources** | `teamai source` | Subscribe to additional skill repos — other teams' public repos, or shared/public repos within your own org; subscribed skills sync automatically on pull. |
 
-### Analytics
+## Team Execution
 
-Insight into how the team actually uses its AI tools:
-
-| Capability | Command | What it shows |
-|------------|---------|---------------|
-| **Usage** | `teamai digest` | Weekly team digest — token usage, conversation volume, and intervention rate. |
-| **Sessions** | `teamai session save` | Privacy-scrubbed per-session summaries (tool sequence, prompt turns, interventions) that feed the digest's Session Highlights. |
-| **Dashboard** | `teamai dashboard` | Web dashboard showing team members' live coding-session status, intervention count, and token usage. |
-| **KB Health** | `teamai dashboard` → KB Health | Built-in dashboard page reporting knowledge-base usage & health — coverage by type, top recalled entries, silent entries, recall trend, author contributions, and a maintenance console. |
-
-## Harness Management & Distribution
+> One Team. One Harness. Every Agent.
 
 TeamAI keeps skills, rules, docs, and hooks in a shared git repo and distributes them to every member's local AI tools through a "push → review & merge → pull" flow — with support for subscribing to other teams' or shared repos' Harness.
 
@@ -163,7 +162,23 @@ teamai source remove other-team
 The add/remove change takes effect locally right away, and subscribed skills sync on the next
 `teamai pull`. Run `teamai push` when you want to share the `teamai.yaml` change with teammates.
 
-## Knowledge Base
+### Team Packages
+
+Share and restore the team's npm packages and Claude Code plugins:
+
+```bash
+teamai install typescript
+teamai install typescript@5.9.2 --npm
+teamai install code-review@claude-plugins-official
+teamai push       # Share the declarations
+teamai install    # Install everything declared by the team
+```
+
+See the [Usage Guide](docs/usage-guide.md#team-packages) for the complete workflow and configuration.
+
+## Team Context
+
+> Every agent understands how the team works.
 
 Beyond distributing the Harness, TeamAI organizes accumulated team experience and code structure into a searchable knowledge base that the AI recalls automatically when needed.
 
@@ -223,6 +238,19 @@ Edges come from two tracks that run together, with AST results taking precedence
 
 The WASM parser is a pure-JavaScript dependency — no native toolchain is required. If it fails to load for any reason, extraction falls back to the heuristic track and records an `AST_UNAVAILABLE` gap. Set `TEAMAI_SKIP_AST=1` to force heuristic-only extraction.
 
+## Team Improvement
+
+> Every execution makes the entire team smarter.
+
+Insight into how the team actually uses its AI tools, and a starting point for turning session friction into shared skills, rules, and knowledge:
+
+| Capability | Command | What it shows |
+|------------|---------|---------------|
+| **Usage** | `teamai digest` | Weekly team digest — token usage, conversation volume, and intervention rate. |
+| **Sessions** | `teamai session save` | Privacy-scrubbed per-session summaries (tool sequence, prompt turns, interventions) that feed the digest's Session Highlights. |
+| **Dashboard** | `teamai dashboard` | Web dashboard showing team members' live coding-session status, intervention count, and token usage. |
+| **KB Health** | `teamai dashboard` → KB Health | Built-in dashboard page reporting knowledge-base usage & health — coverage by type, top recalled entries, silent entries, recall trend, author contributions, and a maintenance console. |
+
 ## Commands
 
 | Command | Description |
@@ -230,6 +258,7 @@ The WASM parser is a pure-JavaScript dependency — no native toolchain is requi
 | `teamai init` | Initialize: OAuth login, link repo, register member, inject hooks |
 | `teamai pull` | Pull team resources and inject into local AI tools |
 | `teamai push` | Push local resources to a branch and open a Merge Request |
+| `teamai install [target]` | Install declared npm packages and Claude plugins; with a target, also update `teamai.yaml` |
 | `teamai status` | Show local vs team repo diff |
 | `teamai contribute` | Share session experience to team repo |
 | `teamai recall <query>` | Search the team knowledge base (BM25 + graph-boost) |

package/README.zh-CN.md

@@ -1,8 +1,8 @@
 <p align="center">
-  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli" width="430">
+  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli">
 </p>
 
-# TeamAI — The team harness for AI agents
+# TeamAI — Make Every Team AI Native
 
 > [English](README.md) | [简体中文](README.zh-CN.md)
 
@@ -11,9 +11,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/teamai-cli.svg)](https://www.npmjs.com/package/teamai-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-面向 AI 智能体的团队 Harness 管理和分发工具。
-
-通过 Git 统一管理 skills、rules、mcp、环境变量、知识库等 Harness，驾驭 Claude Code / Codex / CodeBuddy / WorkBuddy / OpenCode 等多种 AI 工具。
+TeamAI 统一管理团队的 Skills、Rules、MCP 和知识，驾驭 Claude Code、Codex、CodeBuddy、WorkBuddy、OpenCode、Cursor 等 AI Agents。
 
 ## 快速开始
 
@@ -46,15 +44,25 @@ teamai init https://github.com/yourorg/yourrepo --scope user
 
 > **完整使用指南**：[docs/usage-guide.zh-CN.md](docs/usage-guide.zh-CN.md)（[English](docs/usage-guide.md)）— 涵盖从团队创建到日常使用的全流程。
 
+## 产品架构
+
+**Team Execution × Team Context × Team Improvement**：
+
+| 层 | 要解决的问题 | 当前 CLI 中的体现 |
+|----|--------------|-------------------|
+| **Team Execution** | 让每个 Agent 按团队的方式工作 | `init` / `pull` / `push`，skills、rules、agents、hooks、MCP、env |
+| **Team Context** | 让每个 Agent 理解整个团队 | recall、learnings、代码知识图谱、teamwiki... |
+| **Team Improvement** | 让每一次执行都成为团队能力的积累 | 基于摩擦信号的经验分享、sessions、digest、dashboard... |
+
 ## 功能概览
 
 <table>
   <thead>
     <tr>
       <th rowspan="2">Agent</th>
-      <th colspan="7">Harness</th>
-      <th colspan="3">知识库</th>
-      <th colspan="3">使用分析</th>
+      <th colspan="7">Team Execution</th>
+      <th colspan="3">Team Context</th>
+      <th colspan="3">Team Improvement</th>
     </tr>
     <tr>
       <th>skills</th><th>rules</th><th>docs</th><th>env</th><th>agents</th><th>hooks</th><th>mcp</th>
@@ -87,18 +95,9 @@ teamai init https://github.com/yourorg/yourrepo --scope user
 | **标签（Tags）** | `teamai tags` | 给 skills / rules 打标签，成员只订阅自己需要的标签。 |
 | **订阅源（Sources）** | `teamai source` | 订阅额外的 skill 仓库——其他团队的公开仓库，或本团队内的公共/共享仓库；已订阅的 skills 会在 pull 时自动同步。 |
 
-### 使用分析
+## Team Execution
 
-洞察团队实际如何使用 AI 工具：
-
-| 能力 | 命令 | 呈现内容 |
-|------|------|----------|
-| **用量（Usage）** | `teamai digest` | 团队周报——token 用量、会话量、干预率。 |
-| **会话（Sessions）** | `teamai session save` | 脱敏的单会话摘要（工具序列、对话轮次、干预次数），喂给周报的 Session Highlights。 |
-| **看板（Dashboard）** | `teamai dashboard` | Web 看板，实时展示成员的编码会话状态、干预次数和 token 用量。 |
-| **知识库健康（KB Health）** | `teamai dashboard` → KB Health | 内置于看板的报告页面，展示知识库使用情况与健康状态——各类型覆盖率、高频召回条目、沉默条目、召回趋势、作者贡献及维护控制台。 |
-
-## Harness 管理和分发
+> One Team. One Harness. Every Agent.
 
 TeamAI 把 skills、rules、docs、hooks 统一存放在共享 Git 仓库，通过「push → 评审合并 → pull」的流程分发到每位成员的本地 AI 工具，并支持订阅其他团队或公共仓库的 Harness。
 
@@ -163,7 +162,23 @@ teamai source remove other-team
 添加/移除会立即在本机生效，订阅的 skills 会在下一次 `teamai pull` 时同步。需要将
 `teamai.yaml` 的改动分享给团队成员时，再运行 `teamai push`。
 
-## 知识库
+### 团队包
+
+共享并一键恢复团队的 npm 包和 Claude Code 插件：
+
+```bash
+teamai install typescript
+teamai install typescript@5.9.2 --npm
+teamai install code-review@claude-plugins-official
+teamai push       # 分享团队声明
+teamai install    # 安装团队声明的全部包
+```
+
+完整工作流和配置见[使用指南](docs/usage-guide.zh-CN.md#团队包)。
+
+## Team Context
+
+> Every agent understands how the team works.
 
 除了分发 Harness，TeamAI 还把团队沉淀的经验和代码结构组织成可检索的知识库，让 AI 在需要时自动召回。
 
@@ -223,6 +238,19 @@ teamai codebase --lint                      # 健康检查
 
 WASM 解析器是纯 JavaScript 依赖，无需任何原生编译工具链。若因任何原因加载失败，提取会降级到启发式轨并记录一条 `AST_UNAVAILABLE` gap。设置 `TEAMAI_SKIP_AST=1` 可强制仅使用启发式提取。
 
+## Team Improvement
+
+> Every execution makes the entire team smarter.
+
+洞察团队实际如何使用 AI 工具，也是把 session 中的摩擦转化为共享 Skill、Rule 和知识的起点：
+
+| 能力 | 命令 | 呈现内容 |
+|------|------|----------|
+| **用量（Usage）** | `teamai digest` | 团队周报——token 用量、会话量、干预率。 |
+| **会话（Sessions）** | `teamai session save` | 脱敏的单会话摘要（工具序列、对话轮次、干预次数），喂给周报的 Session Highlights。 |
+| **看板（Dashboard）** | `teamai dashboard` | Web 看板，实时展示成员的编码会话状态、干预次数和 token 用量。 |
+| **知识库健康（KB Health）** | `teamai dashboard` → KB Health | 内置于看板的报告页面，展示知识库使用情况与健康状态——各类型覆盖率、高频召回条目、沉默条目、召回趋势、作者贡献及维护控制台。 |
+
 ## 命令一览
 
 | 命令 | 说明 |
@@ -230,6 +258,7 @@ WASM 解析器是纯 JavaScript 依赖，无需任何原生编译工具链。若
 | `teamai init` | 初始化：OAuth 登录、关联仓库、注册成员、注入 hooks |
 | `teamai pull` | 拉取团队资源并注入到本地 AI 工具 |
 | `teamai push` | 推送本地资源到分支并创建合并请求 |
+| `teamai install [target]` | 安装团队 npm 包和 Claude 插件；带 target 时同步更新声明 |
 | `teamai status` | 显示本地与团队仓库的差异 |
 | `teamai contribute` | 将 session 经验分享到团队仓库 |
 | `teamai recall <query>` | 搜索团队知识库（BM25 + 图谱增强） |