teamai-cli 0.25.0-beta.0 → 0.25.0-beta.2

package/CHANGELOG.md

@@ -6,7 +6,9 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### ✨ Features
 
+- `teamai remove` accepts `--force` to skip its confirmation prompt, spelled the same way as `teamai uninstall --force`. Without a TTY the prompt answers itself with no, so this is the only way to remove a resource from a script or a test (for [#591](https://github.com/Tencent/teamai-cli/issues/591)).
 - MCP servers in `mcp/mcp.yaml` and hooks in `hooks/hooks.yaml` accept an optional `roles:` list and ship only to members holding one of those roles; a role change removes the previous role's entries on the next pull, and `teamai mcp list` / `teamai hooks list` show the restriction (for [#563](https://github.com/Tencent/teamai-cli/issues/563)).
+- Agents can be scoped by role or project: `agents/<namespace>/` ships only to members whose `roles.yaml` / `projects.yaml` entry lists that namespace under a new optional `agents:` key, and a role change removes the previous namespaces' agents on the next pull (for [#563](https://github.com/Tencent/teamai-cli/issues/563)).
 - First-class Kiro support: skills, steering rules, JSON subagents with CLI `agentSpawn` session-start hooks, and MCP sync to `.kiro/` (for [#500](https://github.com/Tencent/teamai-cli/issues/500)).
 - Multi-project management: `role` and `project` together resolve resource namespaces, and project-private learnings are isolated ([#426](https://github.com/Tencent/teamai-cli/pull/426), for [#375](https://github.com/Tencent/teamai-cli/issues/375)).
 - Data partitions auto-migrate a legacy `.teamai`, resume interrupted migrations, smoke-check the clone, and keep a git-ignored backup ([#439](https://github.com/Tencent/teamai-cli/pull/439), for [#374](https://github.com/Tencent/teamai-cli/issues/374)).
@@ -14,13 +16,20 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### 🐛 Bug Fixes
 
+- `teamai tags subscribe` and `teamai tags unsubscribe` now invalidate the pull revision cache, as `teamai skill exclude` already does, so the next `teamai pull` applies the new subscriptions instead of reporting "Already synced" when the team repo has not changed.
+- `teamai pull` now deletes a tombstoned agent under all three render extensions, so the Codex `.toml` and Kiro `.json` copies of a removed agent no longer survive on other machines. The cleanup also runs when the team repo rev is unchanged, so an upgrade reaches machines that already pulled the tombstone with an older CLI. `teamai remove agents <name>` also honours `enabledAgents` and no longer deletes from excluded tools. Fixes [#576](https://github.com/Tencent/teamai-cli/issues/576).
+- `teamai remove rules <name>` and `teamai remove skills <name>` now honour `enabledAgents` and leave excluded tools untouched, matching the whitelist `teamai pull` already applies when it cleans up a tombstoned resource. Fixes [#590](https://github.com/Tencent/teamai-cli/issues/590).
+- `teamai pull` and `teamai mcp inject` no longer write team MCP servers into installed tools outside `enabledAgents` or listed in `disabledAgents`, the same gate skills, rules, agents and hooks already use. Servers injected before the upgrade are left in place, and `teamai uninstall` still removes them.
+- `teamai import --cache-status` and `--cache-gc` now expose their existing JSON output through the CLI `--json` option.
 - Course-correction matching normalizes prompts and keywords to Unicode NFC, so composed and decomposed accents match. Stored prompt summaries and the 60-second correction window are unchanged. Fixes [#573](https://github.com/Tencent/teamai-cli/issues/573).
 - Course-correction detection matches keywords in space-separated scripts as whole words, so Spanish "segundo" no longer counts as `undo` (for [#564](https://github.com/Tencent/teamai-cli/issues/564)).
+- `teamai doctor` no longer assumes TGit before initialization and now exits with code 1 when any diagnostic check fails.
 - MCP `requires` is resolved from `PATH` (including Windows `PATHEXT`), so `teamai mcp inject` no longer skips servers such as `uvx` on Windows ([#540](https://github.com/Tencent/teamai-cli/pull/540), for [#539](https://github.com/Tencent/teamai-cli/issues/539)).
 - The GitHub and CNB providers resolve their CLI to a launchable absolute path and start it through cross-spawn, so on Windows they no longer answer "installed" while every call fails silently ([#520](https://github.com/Tencent/teamai-cli/pull/520)).
 - `enabledAgents` now also gates CLI builtin deploy, CLAUDE.md-class injects, and last-pull skip-sync targets, so an already-installed tool outside the whitelist is not written to ([#510](https://github.com/Tencent/teamai-cli/issues/510)).
 - `teamai status` counts rule files in subdirectories recursively ([#437](https://github.com/Tencent/teamai-cli/pull/437)).
 - Codex Stop-phase contribution hints are deferred to the next prompt, so the host no longer rejects `additionalContext` ([#441](https://github.com/Tencent/teamai-cli/pull/441)).
+- Agent version detection launches the agent CLI through cross-spawn, so on Windows an npm-installed agent CLI such as `codebuddy`, `claude` or `openclaw` (a `.cmd` shim) reports its version instead of an empty `agent_version`.
 
 ### 📝 Documentation
 

package/README.ja.md

@@ -0,0 +1,278 @@
+<p align="center">
+  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli">
+</p>
+
+# TeamAI — Make Every Team AI Native
+
+> [English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [ไทย](README.th.md)
+
+[![CI](https://github.com/Tencent/teamai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Tencent/teamai-cli/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/teamai-cli.svg)](https://www.npmjs.com/package/teamai-cli)
+[![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)
+
+TeamAI は、チームの Skills、Rules、MCP、ナレッジを Claude Code、Codex、CodeBuddy、WorkBuddy、OpenCode、Cursor などの AI Agents 横断で管理します。
+
+## コントリビューター
+
+TeamAI に貢献してくださったみなさんに感謝します。
+
+<a href="https://trendshift.io/repositories/123184?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-123184" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/123184" alt="Tencent%2Fteamai-cli | Trendshift" width="250" height="55"/></a>
+
+<a href="https://github.com/Tencent/teamai-cli/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Tencent/teamai-cli" alt="Contributors" />
+</a>
+
+[contrib.rocks](https://contrib.rocks) で生成しています。
+
+## クイックスタート
+
+### インストール
+
+```bash
+npm install -g teamai-cli
+```
+
+### チーム管理者 / 個人利用
+
+Git ホスト（GitHub、GitLab、GitCode、CNB、TGit、またはプライベート Git サービス）に共有リポジトリを作成し、**チームメンバーに書き込み権限を付与**してから、`teamai init https://github.com/yourorg/yourrepo` を実行します。
+
+> **まだチームリポジトリがない場合は？** 本番向けの skills、rules、review agents が入ったテンプレートから始められます。[teamai-hub](https://github.com/teamai-hub) org を開き、**Fork** してから、新しいリポジトリに対して `teamai init` を実行してください。
+
+### チームメンバー
+
+```bash
+# Choose one, depending on where you want resources installed
+
+# Project-scope init (default, resources installed under the project directory)
+cd /path/to/my-project
+teamai init https://github.com/yourorg/yourrepo
+
+# Or, user-scope init (resources installed under ~/)
+teamai init https://github.com/yourorg/yourrepo --scope user
+```
+
+初期化後は、管理者が公開した最新の skills / rules などの Harness 更新が、AI セッション開始時に自動で取り込まれます。手動同期は不要です。
+
+> **完全な利用ガイド:** [docs/usage-guide.md](docs/usage-guide.md)（[中文版](docs/usage-guide.zh-CN.md)）— チーム作成から日常利用までをカバーします。
+
+## プロダクトアーキテクチャ
+
+**Team Execution × Team Context (beta) × Team Improvement (beta)**:
+
+| レイヤー | 役割 | 本 CLI での現状 |
+|----------|------|-----------------|
+| **Team Execution** | どの Agent もチームのやり方で動かす | `init` / `pull` / `push`、skills、rules、agents、hooks、MCP、env |
+| **Team Context** (beta) | どの Agent もチームを理解する | recall、learnings、codebase graph、teamwiki... |
+| **Team Improvement** (beta) | 毎回の実行がチームを強くする | 摩擦ベースの share-learnings、sessions、digest、dashboard... |
+
+## 概要
+
+<table>
+  <thead>
+    <tr>
+      <th rowspan="2">Agent</th>
+      <th colspan="7">Team Execution</th>
+      <th colspan="3">Team Context (beta)</th>
+      <th colspan="3">Team Improvement (beta)</th>
+    </tr>
+    <tr>
+      <th>skills</th><th>rules</th><th>docs</th><th>env</th><th>agents</th><th>hooks</th><th>mcp</th>
+      <th>learnings</th><th>codebase</th><th>teamwiki</th>
+      <th>usage</th><th>sessions</th><th>dashboard</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>Claude Code</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Codex</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Cursor</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>CodeBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>WorkBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>OpenCode</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>OpenClaw</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>Hermes</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>DeepSeek Harness</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>Qoder</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Kiro</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>ZCode</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+  </tbody>
+</table>
+
+**Git プロバイダー** — GitHub · GitLab · GitCode · CNB · TGit · プライベート Git サービス。
+
+### 配布コントロール
+
+管理者が一度設定すれば、`teamai pull` 時に全メンバーへ届くチーム共通の設定です。
+
+| 機能 | コマンド | 内容 |
+|------|----------|------|
+| **Projects** | `teamai projects` | 作業ディレクトリを 1 つ以上の論理プロジェクトに紐づけ、そのプロジェクトの skills、ナレッジ、隔離された learnings を同期します。Roles とは直交します。 |
+| **Roles** | `teamai roles` | ロール → 名前空間の対応を定義し、各メンバーが自分のロール向け skills だけを同期するようにします。 |
+| **Tags** | `teamai tags` | skills / rules にタグを付け、メンバーは必要なタグだけを購読します。 |
+| **Sources** | `teamai source` | 追加の skill リポジトリを購読します。他チームの公開リポジトリや、自組織内の共有/公開リポジトリが対象です。購読した skills は pull 時に自動同期されます。 |
+
+learnings の隔離: リポジトリ直下の `learnings/` は全員で共有、`learnings/<project-id>/` はプロジェクト専用です。詳細は [usage guide](docs/usage-guide.md#multi-project-project-as-a-dimension-orthogonal-to-role) を参照してください。
+
+## Team Execution
+
+> One Team. One Harness. Every Agent.
+
+TeamAI は skills、rules、docs、hooks を共有 Git リポジトリに置き、「push → レビューしてマージ → pull」の流れで各メンバーのローカル AI ツールへ配布します。他チームや共有リポジトリの Harness 購読にも対応します。
+
+### 仕組み
+
+```
+teamai push → create branch + MR → reviewer approves + merges
+                                         ↓
+              SessionStart hook → teamai pull → synced to local AI tools
+```
+
+### 共有されるもの
+
+各リソースはすべての Agent に届けられます。
+
+| リソース | チームリポジトリ内 | 備考 |
+|----------|-------------------|------|
+| **Skills** | `skills/<name>/SKILL.md` | |
+| **Rules** | `rules/*.md` | |
+| **Docs** | `docs/` | プロジェクトの基礎ドキュメント。デフォルトでは全件読み込みません（progressive disclosure） |
+| **Agents** | `agents/<name>.yaml` | |
+| **Culture** | `culture.md` | チームのミッション、価値観、働き方の原則。各 Agent の CLAUDE.md / AGENTS.md に注入され、すべてのセッションに引き継がれます |
+| **CLAUDE.md** | `claudemd/*.md` | |
+| **Env** | `env/` | チーム共通の環境変数とスイッチ。secrets は置かないでください |
+| **Hooks** | `hooks/hooks.yaml` | 各 hook に `roles:` を付け、該当ロールを持つメンバーにだけ届けることができます |
+| **MCP** | `mcp/mcp.yaml` | 各 server に `roles:` を付け、該当ロールを持つメンバーにだけ届けることができます |
+| **Packages** | `teamai.yaml` | 現時点では npm パッケージと Claude Code plugins のみ |
+| **Models** | — | まだすべての provider には未対応です |
+
+ファイル形式と一連のワークフローは [Usage Guide](docs/usage-guide.md) を参照してください。
+
+## Team Context (beta)
+
+> Every agent understands how the team works.
+
+Harness の配布に加え、TeamAI は蓄積したチーム経験とコード構造を検索可能なナレッジベースに整理し、必要に応じて AI が自動で recall します。
+
+### 経験の自動共有
+
+セッション終了時、Stop hook は **friction**（摩擦）でスコアします。これは「覚えておく価値がある」兆候です。AI を中断・訂正した、ツール呼び出しを拒否した、失敗したツールを AI が何度も再試行した、などです。長くても順調なセッション（ツール呼び出しは多いが摩擦がない）では発火しません。本当に問題と向き合ったセッションだけが対象です。スコアが十分高いと、AI は次のように提案します。
+
+```
+[teamai] This session may contain a problem worth documenting: you interrupted the AI twice, the AI retried failing tools 8 times.
+
+Task: Fix duplicate project-level Hook injection
+
+Consider running /teamai-share-learnings to summarize what you learned and share it with your team.
+```
+
+ヒントには、発火のきっかけになった非ゼロの friction シグナルが入ります。取得できる場合は、最初のタスクをマスクした 1 行要約も付きます。`/teamai-share-learnings` skill はセッションを要約し、learning ドキュメントをチームリポジトリへ直接 push します。各セッションへの提示は最大 1 回です。チームは `teamai.yaml` の `sharing.contributeHint.enabled: false` でヒントだけをオフにできます（メンバー側はローカル設定の `contributeHintEnabled`）。Stop hook のほかの処理はそのまま残ります。
+
+### Team Knowledge Recall
+
+タスクの前に、蓄積したチームナレッジを AI が自動検索できるようにします。この機能は **デフォルトオフ** で、明示的に有効化する必要があります。チームは `teamai.yaml` で `sharing.recall.enabled: true` をデフォルトにでき、メンバーはローカルで上書きできます。
+
+```bash
+teamai recall enable     # on: deploy the teamai-recall subagent + inject guidance rules
+teamai recall disable    # off: remove the subagent and rules
+teamai recall status     # show effective state (team default + user override)
+```
+
+**検索は subagent 経由**です。有効化後、`teamai pull` は組み込みの `teamai-recall` subagent を各 AI ツールの `agents/` に配備します。AI はタスク前にこれを呼び出します。subagent がキーワードを抽出し、検索を実行し、ヒットしたソースファイルを読んで、チームナレッジの構造化サマリーを返します。先に関連性の事前チェック（`teamai recall --check`）を行い、タスクがチームナレッジと無関係なら検索自体をスキップします。内部では `teamai recall` コマンドをシェル実行しており、手動でも同じコマンドを使えます。
+
+```bash
+$ teamai recall "port conflict"
+[1/2] MR review caught a port-conflict bug ★1 [user]
+Author: member-a | Score: 18.5 | Tags: troubleshooting, networking
+
+[2/2] Deployment configuration best practices [project]
+Author: member-b | Score: 12.0 | Tags: deploy, config
+Matched: conflict | Missing: port
+```
+
+### Codebase Knowledge Graph
+
+`teamai import` はソースリポジトリを解析し、`teamwiki/` 配下の構造化グラフにします。構造を意識した検索が可能になります。
+
+```bash
+teamai import --from-repo https://github.com/org/repo
+teamai import --from-org myorg              # batch import all repos
+teamai codebase --extract /path/to/repo     # local extract into teamwiki/
+teamai codebase --deep-enrich --project my-service --output /path/to/repo # generate deep knowledge docs
+teamai codebase --reconcile --output /path/to/repo # map product docs to code pages
+teamai codebase --lint --output /path/to/repo # check the locally extracted graph
+```
+
+extract は、AI enrichment をスキップした場合や成果が空でも、`teamwiki/evidence/code/<project>/_manifest.json` を書き出すので、`--deep-enrich` から始められます。
+
+グラフにはコンポーネント、インターフェース、設定、リポジトリ間の import エッジが入ります。`teamai recall` はこれを graph-boost の再ランキングに使います。
+recall のヒットが codebase ページ由来のときは、結果に関連ソースパスを列挙する `Sources:` 行が付きます。Agent はリポジトリを最初から探索し直さず、コード変更の起点にできます。
+
+エッジは 2 本のトラックが同時に走り、重複時は AST 側が優先されます。
+
+- **AST track**（TypeScript/JavaScript、Python、Go）: WASM の [tree-sitter](https://tree-sitter.github.io/) パーサーが `import`/`require`、呼び出し箇所、TS の `implements` 句を、ファイル間の正確な `DEPENDS_ON` / `REFERENCES` / `IMPLEMENTS` エッジに解決します（タグは `code-ast`、信頼度の重み付き）。
+- **Heuristic track**（Java/Rust を含む全言語）: 正規表現ベースの抽出（タグは `code-heuristic`）。AST track が対象にしない言語もカバーします。
+
+WASM パーサーは純粋な JavaScript 依存で、ネイティブのツールチェーンは不要です。何らかの理由で読み込めない場合、抽出は heuristic track にフォールバックし、`AST_UNAVAILABLE` の gap を記録します。`TEAMAI_SKIP_AST=1` を設定すると、heuristic のみの抽出を強制できます。
+
+## Team Improvement (beta)
+
+> Every execution makes the entire team smarter.
+
+### Maintenance
+
+skills とナレッジが増えたら、チームが使わなくなったものを整理します。`teamai recall maintenance` は信頼度の低い learnings をアーカイブし、古い skills、rules、docs をクリーンアップまたは更新候補として印付けします。
+
+```bash
+teamai recall maintenance --prune --dry-run      # preview
+teamai recall maintenance --prune --archive      # archive unused learnings
+teamai recall maintenance --update-quality       # draft updates for stale skills / docs
+```
+
+チームが AI ツールを実際にどう使っているかの洞察と、セッションの摩擦を共有の skills、rules、ナレッジへ変える出発点です。
+
+| 機能 | コマンド | 表示内容 |
+|------|----------|----------|
+| **Usage** | `teamai digest` | チームの週次 digest — 直近 7 日の成功率、prompt、アクティブ時間、推定コスト、cache、訂正の傾向と、累計値。 |
+| **Sessions** | `teamai session save` | プライバシーを除去したセッション要約（ツール列、prompt ターン、介入）。digest の Session Highlights の入力になります。 |
+| **Dashboard** | `teamai dashboard` | ライブセッションと、直近 7 日をその前の 7 日と比較したローカルトレンドを示す Web dashboard。 |
+| **KB Health** | `teamai dashboard` → KB Health | 組み込みの dashboard ページ。ナレッジベースの利用と健全性（タイプ別カバレッジ、よく recall されるエントリ、沈黙エントリ、recall トレンド、作者の貢献、メンテナンスコンソール）を報告します。 |
+
+## コマンド
+
+| コマンド | 説明 |
+|----------|------|
+| `teamai init` | 初期化: OAuth ログイン、リポジトリ連携、メンバー登録、hooks 注入 |
+| `teamai pull` | チームリソースを取得し、ローカル AI ツールへ注入 |
+| `teamai push` | ローカルリソースをブランチへ push し、Merge Request を開く |
+| `teamai packages [install] [target]` | 宣言済みの npm パッケージと Claude plugins をインストール。target 指定時は `teamai.yaml` も更新。引数なしの `teamai packages` はすべてインストール、`teamai packages install <target>` は 1 件追加 |
+| `teamai status` | ローカルとチームリポジトリの差分とリソース件数を表示。名前空間付き skills と入れ子の docs も含む |
+| `teamai contribute` | セッション経験をチームリポジトリへ共有 |
+| `teamai recall <query>` | チームナレッジベースを検索（BM25 + graph-boost） |
+| `teamai recall enable/disable/status` | recall のオン/オフ、または状態確認 |
+| `teamai recall promote [learningId]` | 信頼度の高い learning を正式ナレッジ（skills/rules/docs）へ昇格 |
+| `teamai recall maintenance` | ナレッジベースの健全性を維持: 低信頼度 learnings の整理、信頼度スコアの書き戻し、古いエントリの印付け |
+| `teamai import` | ナレッジを import（`--dir`、`--from-repo`、`--from-org`、`--from-repo-list`、`--from-mr`） |
+| `teamai codebase --extract [path]` | コード事実を抽出し、`teamwiki/` 配下にローカルグラフを構築 |
+| `teamai codebase --deep-enrich` | 抽出した evidence から深いナレッジドキュメントを生成 |
+| `teamai codebase --reconcile` | プロダクトドキュメントと抽出したコードナレッジを突き合わせ |
+| `teamai codebase --lint` | Knowledge graph の健全性チェック |
+| `teamai ci extract-mr --url <url>` | CI: MR からナレッジを抽出、コメント投稿、マージ後に書き込み |
+| `teamai members` | チームメンバー一覧 |
+| `teamai projects` | 作業ディレクトリを 1 つ以上の論理プロジェクトに紐づけ |
+| `teamai roles` | チームの roles と名前空間を管理 |
+| `teamai tags` | タグベースの skill/rule フィルタを管理 |
+| `teamai skill exclude add/remove/list` | ローカル同期から除外する skills を管理（[usage guide](docs/usage-guide.md#excluding-skills-you-dont-need)） |
+| `teamai source` | skill 購読ソースを管理（他チーム、または自組織の共有リポジトリ） |
+| `teamai remove <type> <name>` | リソースを削除し、MR を開く |
+| `teamai session save` | プライバシー除去済みのセッション要約を月次ログへ記録（`--push` は `digest` へ供給） |
+| `teamai digest` | チーム利用の週次 digest を生成 |
+| `teamai doctor` | 設定の問題を診断（`--json` で JSON 出力、CI・hook・agent 向け）|
+| `teamai uninstall` | すべての teamai リソースと hooks を削除 |
+
+## ライセンス
+
+[MIT](LICENSE)
+
+## コントリビュート
+
+PR を歓迎します。先に [CONTRIBUTING.md](.github/CONTRIBUTING.md) を読んでください。

package/README.ko.md

@@ -0,0 +1,278 @@
+<p align="center">
+  <img src="assets/teamai-cli-logo.svg" alt="teamai-cli">
+</p>
+
+# TeamAI — Make Every Team AI Native
+
+> [English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [ไทย](README.th.md)
+
+[![CI](https://github.com/Tencent/teamai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Tencent/teamai-cli/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/teamai-cli.svg)](https://www.npmjs.com/package/teamai-cli)
+[![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)
+
+TeamAI는 팀의 Skills, Rules, MCP, 지식을 Claude Code, Codex, CodeBuddy, WorkBuddy, OpenCode, Cursor 등 AI Agents 전반에서 관리합니다.
+
+## 기여자
+
+TeamAI에 기여해 주신 모든 분께 감사합니다!
+
+<a href="https://trendshift.io/repositories/123184?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-123184" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/123184" alt="Tencent%2Fteamai-cli | Trendshift" width="250" height="55"/></a>
+
+<a href="https://github.com/Tencent/teamai-cli/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=Tencent/teamai-cli" alt="Contributors" />
+</a>
+
+[contrib.rocks](https://contrib.rocks)로 생성했습니다.
+
+## 빠른 시작
+
+### 설치
+
+```bash
+npm install -g teamai-cli
+```
+
+### 팀 관리자 / 개인 사용자
+
+Git 호스트(GitHub, GitLab, GitCode, CNB, TGit 또는 비공개 Git 서비스)에 공유 경험 저장소를 만들고, **팀원에게 쓰기 권한을 부여한 뒤** `teamai init https://github.com/yourorg/yourrepo`를 실행하세요.
+
+> **아직 팀 저장소가 없나요?** 프로덕션에 바로 쓸 수 있는 Skills, Rules, review agents가 미리 들어 있는 템플릿으로 시작하세요. [teamai-hub](https://github.com/teamai-hub) org를 둘러본 뒤 **Fork**하고, 새로 만든 저장소에 `teamai init`을 실행하면 됩니다.
+
+### 팀원
+
+```bash
+# Choose one, depending on where you want resources installed
+
+# Project-scope init (default, resources installed under the project directory)
+cd /path/to/my-project
+teamai init https://github.com/yourorg/yourrepo
+
+# Or, user-scope init (resources installed under ~/)
+teamai init https://github.com/yourorg/yourrepo --scope user
+```
+
+초기화가 끝나면 관리자가 배포한 최신 Skills / Rules 및 기타 Harness 업데이트가 매 AI 세션에서 자동으로 반영됩니다. 수동 동기화는 필요 없습니다.
+
+> **전체 사용 가이드:** [docs/usage-guide.md](docs/usage-guide.md) ([中文版](docs/usage-guide.zh-CN.md)) — 팀 생성부터 일상 사용까지 모두 다룹니다.
+
+## 제품 아키텍처
+
+**Team Execution × Team Context (beta) × Team Improvement (beta)**:
+
+| 계층 | 역할 | 현재 CLI에서 |
+|-------|-----|-------------------|
+| **Team Execution** | 모든 Agent가 팀의 방식대로 일하게 합니다 | `init` / `pull` / `push`, skills, rules, agents, hooks, MCP, env |
+| **Team Context** (beta) | 모든 Agent가 팀을 이해하게 합니다 | recall, learnings, codebase graph, teamwiki... |
+| **Team Improvement** (beta) | 모든 실행이 팀을 더 강하게 만듭니다 | 마찰 기반 share-learnings, sessions, digest, dashboard... |
+
+## 개요
+
+<table>
+  <thead>
+    <tr>
+      <th rowspan="2">Agent</th>
+      <th colspan="7">Team Execution</th>
+      <th colspan="3">Team Context (beta)</th>
+      <th colspan="3">Team Improvement (beta)</th>
+    </tr>
+    <tr>
+      <th>skills</th><th>rules</th><th>docs</th><th>env</th><th>agents</th><th>hooks</th><th>mcp</th>
+      <th>learnings</th><th>codebase</th><th>teamwiki</th>
+      <th>usage</th><th>sessions</th><th>dashboard</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>Claude Code</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Codex</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Cursor</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>CodeBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>WorkBuddy</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>OpenCode</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>OpenClaw</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>Hermes</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>DeepSeek Harness</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">—</td><td align="center">—</td><td align="center">—</td></tr>
+    <tr><td>Qoder</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>Kiro</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+    <tr><td>ZCode</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">—</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td><td align="center">✓</td></tr>
+  </tbody>
+</table>
+
+**Git providers** — GitHub · GitLab · GitCode · CNB · TGit · 비공개 Git 서비스.
+
+### 배포 제어
+
+관리자가 한 번 설정하면 `teamai pull` 때 모든 멤버에게 전달되는 팀 전역 설정입니다.
+
+| 기능 | 명령 | 하는 일 |
+|------------|---------|--------------|
+| **Projects** | `teamai projects` | 작업 디렉터리를 하나 이상의 논리 프로젝트에 묶어, 해당 프로젝트의 Skills, 지식, 격리된 learnings를 동기화합니다. Roles와는 별개의 차원입니다. |
+| **Roles** | `teamai roles` | role → namespace 매핑을 정의해, 각 멤버가 자신의 role에 해당하는 Skills만 동기화하게 합니다. |
+| **Tags** | `teamai tags` | Skills / Rules에 태그를 달아, 멤버가 필요한 태그만 구독하게 합니다. |
+| **Sources** | `teamai source` | 추가 skill 저장소를 구독합니다 — 다른 팀의 공개 저장소, 또는 우리 org 안의 공유/공개 저장소. 구독한 Skills는 pull 때 자동 동기화됩니다. |
+
+Learnings 격리: 저장소 루트의 `learnings/`는 전원과 공유되고, `learnings/<project-id>/`는 프로젝트 전용입니다. [usage guide](docs/usage-guide.md#multi-project-project-as-a-dimension-orthogonal-to-role)를 참고하세요.
+
+## Team Execution
+
+> One Team. One Harness. Every Agent.
+
+TeamAI는 Skills, Rules, docs, hooks를 공유 Git 저장소에 두고, "push → review & merge → pull" 흐름으로 각 멤버의 로컬 AI 도구에 배포합니다. 다른 팀이나 공유 저장소의 Harness 구독도 지원합니다.
+
+### 작동 방식
+
+```
+teamai push → create branch + MR → reviewer approves + merges
+                                         ↓
+              SessionStart hook → teamai pull → synced to local AI tools
+```
+
+### 공유되는 항목
+
+각 리소스는 모든 Agent에 전달됩니다.
+
+| 리소스 | 팀 저장소 위치 | 참고 |
+|----------|------------------|-------|
+| **Skills** | `skills/<name>/SKILL.md` | |
+| **Rules** | `rules/*.md` | |
+| **Docs** | `docs/` | 프로젝트 기반 문서. 기본값으로 전부 로드되지는 않습니다(progressive disclosure) |
+| **Agents** | `agents/<name>.yaml` | |
+| **Culture** | `culture.md` | 팀의 미션, 가치, 일하는 원칙 — 각 Agent의 CLAUDE.md / AGENTS.md에 주입되어 모든 세션이 이를 이어받습니다 |
+| **CLAUDE.md** | `claudemd/*.md` | |
+| **Env** | `env/` | 팀 단위 공유 환경 변수와 스위치. 시크릿은 넣지 마세요 |
+| **Hooks** | `hooks/hooks.yaml` | 각 hook에 `roles:`를 달면 해당 role을 가진 멤버에게만 전달됩니다 |
+| **MCP** | `mcp/mcp.yaml` | 각 server에 `roles:`를 달면 해당 role을 가진 멤버에게만 전달됩니다 |
+| **Packages** | `teamai.yaml` | 현재는 npm 패키지와 Claude Code 플러그인만 지원 |
+| **Models** | — | 아직 모든 provider에 구현되지 않았습니다 |
+
+파일 형식과 전체 워크플로는 [Usage Guide](docs/usage-guide.md)를 참고하세요.
+
+## Team Context (beta)
+
+> Every agent understands how the team works.
+
+Harness를 배포하는 것을 넘어, TeamAI는 쌓인 팀 경험과 코드 구조를 검색 가능한 지식 베이스로 정리하고, AI가 필요할 때 자동으로 불러오게 합니다.
+
+### 경험 자동 공유
+
+세션이 끝나면 Stop hook이 **friction**(마찰)으로 점수를 매깁니다. 세션에서 기억할 만한 일이 있었음을 나타내는 신호입니다. 예를 들어 AI를 중단하거나 고쳤거나, 도구 호출을 거절했거나, AI가 실패한 도구를 여러 번 재시도한 경우입니다. 도구 호출은 많지만 마찰이 없는 길고 평범한 세션은 트리거되지 않고, 실제로 문제를 붙잡고 씨름한 세션만 해당합니다. 점수가 충분하면 AI가 이렇게 제안합니다.
+
+```
+[teamai] This session may contain a problem worth documenting: you interrupted the AI twice, the AI retried failing tools 8 times.
+
+Task: Fix duplicate project-level Hook injection
+
+Consider running /teamai-share-learnings to summarize what you learned and share it with your team.
+```
+
+힌트에는 트리거가 된 0이 아닌 friction 신호가 나오고, 가능하면 첫 번째 작업을 마스킹한 한 줄 요약도 붙습니다. `/teamai-share-learnings` skill은 세션을 요약해 learning 문서를 팀 저장소에 바로 push합니다. 세션당 힌트는 최대 한 번입니다. 팀은 `teamai.yaml`에서 `sharing.contributeHint.enabled: false`로 힌트만 끌 수 있고(멤버는 로컬 설정의 `contributeHintEnabled`), Stop hook의 나머지 기능은 그대로 둡니다.
+
+### 팀 지식 Recall
+
+작업 전에 AI가 쌓인 팀 지식을 자동으로 검색하게 합니다. 이 기능은 **기본값이 꺼짐**이며, 명시적으로 켜야 합니다. 팀은 `teamai.yaml`에서 `sharing.recall.enabled: true`를 기본값으로 둘 수 있고, 멤버는 로컬에서 덮어쓸 수 있습니다.
+
+```bash
+teamai recall enable     # on: deploy the teamai-recall subagent + inject guidance rules
+teamai recall disable    # off: remove the subagent and rules
+teamai recall status     # show effective state (team default + user override)
+```
+
+**검색은 subagent로 실행됩니다**: 켜면 `teamai pull`이 내장 `teamai-recall` subagent를 각 AI 도구의 `agents/` 디렉터리에 배포합니다. AI는 작업 전에 이를 호출하고, subagent가 키워드를 뽑고, 검색을 돌리고, 맞은 원본 파일을 읽은 뒤 팀 지식의 구조화된 요약을 돌려줍니다. subagent는 먼저 관련성 사전 검사(`teamai recall --check`)를 하고, 작업이 팀 지식과 무관하면 검색을 아예 건너뜁니다. 내부적으로는 `teamai recall` 명령을 호출하며, 직접 실행할 수도 있습니다.
+
+```bash
+$ teamai recall "port conflict"
+[1/2] MR review caught a port-conflict bug ★1 [user]
+Author: member-a | Score: 18.5 | Tags: troubleshooting, networking
+
+[2/2] Deployment configuration best practices [project]
+Author: member-b | Score: 12.0 | Tags: deploy, config
+Matched: conflict | Missing: port
+```
+
+### 코드베이스 지식 그래프
+
+`teamai import`는 소스 저장소를 `teamwiki/` 아래의 구조화된 그래프로 파싱해, 구조를 아는 검색을 가능하게 합니다.
+
+```bash
+teamai import --from-repo https://github.com/org/repo
+teamai import --from-org myorg              # batch import all repos
+teamai codebase --extract /path/to/repo     # local extract into teamwiki/
+teamai codebase --deep-enrich --project my-service --output /path/to/repo # generate deep knowledge docs
+teamai codebase --reconcile --output /path/to/repo # map product docs to code pages
+teamai codebase --lint --output /path/to/repo # check the locally extracted graph
+```
+
+Extract는 AI enrichment를 건너뛰거나 결과가 없어도 `teamwiki/evidence/code/<project>/_manifest.json`을 쓰므로 `--deep-enrich`를 이어서 시작할 수 있습니다.
+
+그래프는 컴포넌트, 인터페이스, 설정, 저장소 간 import 엣지를 저장합니다. `teamai recall`은 이를 그래프 부스팅 재랭킹에 사용합니다.
+recall 결과가 codebase 페이지에서 온 경우, 결과에는 관련 소스 파일 경로를 나열하는 `Sources:` 줄이 포함됩니다. Agent가 저장소를 다시 탐색하지 않고 코드 변경의 출발점을 바로 잡을 수 있습니다.
+
+엣지는 함께 도는 두 트랙에서 나오며, 겹치면 AST 결과가 우선합니다.
+
+- **AST track** (TypeScript/JavaScript, Python, Go): WASM [tree-sitter](https://tree-sitter.github.io/) 파서가 `import`/`require`, 호출 지점, TS `implements` 절을 파일 간 정확한 `DEPENDS_ON` / `REFERENCES` / `IMPLEMENTS` 엣지로 해석합니다(`code-ast` 태그, confidence 가중치).
+- **Heuristic track** (Java/Rust를 포함한 모든 언어): 정규식 기반 추출(`code-heuristic` 태그). AST track이 다루지 않는 언어도 커버합니다.
+
+WASM 파서는 순수 JavaScript 의존성이라 네이티브 툴체인이 필요 없습니다. 어떤 이유로든 로드에 실패하면 추출은 heuristic track으로 떨어지고 `AST_UNAVAILABLE` gap을 기록합니다. `TEAMAI_SKIP_AST=1`을 설정하면 heuristic 전용 추출을 강제합니다.
+
+## Team Improvement (beta)
+
+> Every execution makes the entire team smarter.
+
+### Maintenance
+
+Skills와 지식이 쌓이면, 팀이 더 이상 쓰지 않는 것을 정리하세요. `teamai recall maintenance`는 신뢰도가 낮은 learnings를 아카이브하고, 낡은 Skills, Rules, docs를 정리 또는 업데이트 대상으로 표시합니다.
+
+```bash
+teamai recall maintenance --prune --dry-run      # preview
+teamai recall maintenance --prune --archive      # archive unused learnings
+teamai recall maintenance --update-quality       # draft updates for stale skills / docs
+```
+
+팀이 AI 도구를 실제로 어떻게 쓰는지 보고, 세션 friction을 공유 Skills, Rules, 지식으로 바꾸는 출발점입니다.
+
+| 기능 | 명령 | 보여주는 것 |
+|------------|---------|---------------|
+| **Usage** | `teamai digest` | 주간 팀 digest — 7일간의 성공률, prompt, 활성 시간, 추정 비용, cache, 수정 추세와 누적 합계. |
+| **Sessions** | `teamai session save` | 개인정보를 제거한 세션별 요약(도구 순서, prompt 턴, 개입)으로 digest의 Session Highlights에 들어갑니다. |
+| **Dashboard** | `teamai dashboard` | 실시간 세션과, 직전 7일 대비 로컬 7일 추세를 보여주는 웹 dashboard. |
+| **KB Health** | `teamai dashboard` → KB Health | 지식 베이스 사용량과 건강 상태를 보여주는 내장 dashboard 페이지 — 유형별 커버리지, 상위 recall 항목, 침묵 항목, recall 추세, 작성자 기여, maintenance 콘솔. |
+
+## 명령어
+
+| 명령 | 설명 |
+|---------|-------------|
+| `teamai init` | 초기화: OAuth 로그인, 저장소 연결, 멤버 등록, hooks 주입 |
+| `teamai pull` | 팀 리소스를 가져와 로컬 AI 도구에 주입 |
+| `teamai push` | 로컬 리소스를 브랜치에 push하고 Merge Request를 엽니다 |
+| `teamai packages [install] [target]` | 선언된 npm 패키지와 Claude 플러그인을 설치합니다. target이 있으면 `teamai.yaml`도 갱신합니다. 인자 없는 `teamai packages`는 전부를 설치하고, `teamai packages install <target>`은 하나를 추가합니다 |
+| `teamai status` | 로컬과 팀 저장소의 diff 및 리소스 개수(네임스페이스 Skills, 중첩 docs 포함)를 표시 |
+| `teamai contribute` | 세션 경험을 팀 저장소에 공유 |
+| `teamai recall <query>` | 팀 지식 베이스 검색 (BM25 + graph-boost) |
+| `teamai recall enable/disable/status` | recall 상태를 켜거나 끄거나 확인 |
+| `teamai recall promote [learningId]` | 신뢰도가 높은 learning을 정식 지식(skills/rules/docs)으로 승격 |
+| `teamai recall maintenance` | 지식 베이스 건강 유지: 신뢰도가 낮은 learnings 정리, confidence 점수 되쓰기, 낡은 항목 표시 |
+| `teamai import` | 지식 가져오기 (`--dir`, `--from-repo`, `--from-org`, `--from-repo-list`, `--from-mr`) |
+| `teamai codebase --extract [path]` | 코드 사실을 추출하고 `teamwiki/` 아래 로컬 그래프를 구축 |
+| `teamai codebase --deep-enrich` | 추출된 evidence로 심층 지식 문서 생성 |
+| `teamai codebase --reconcile` | 제품 문서를 추출된 코드 지식과 맞추기 |
+| `teamai codebase --lint` | 지식 그래프 건강 검사 |
+| `teamai ci extract-mr --url <url>` | CI: MR에서 지식 추출, 댓글 게시, 머지 후 기록 |
+| `teamai members` | 팀 멤버 목록 |
+| `teamai projects` | 작업 디렉터리를 하나 이상의 논리 프로젝트에 연결 |
+| `teamai roles` | 팀 roles와 namespaces 관리 |
+| `teamai tags` | 태그 기반 skill/rule 필터 관리 |
+| `teamai skill exclude add/remove/list` | 로컬 동기화에서 제외할 Skills 관리 ([usage guide](docs/usage-guide.md#excluding-skills-you-dont-need)) |
+| `teamai source` | skill 구독 소스 관리(다른 팀 또는 org의 공유 저장소) |
+| `teamai remove <type> <name>` | 리소스를 제거하고 MR을 엽니다 |
+| `teamai session save` | 개인정보를 제거한 세션 요약을 월별 로그에 기록 (`--push`는 `digest`에 공급) |
+| `teamai digest` | 주간 팀 사용 digest 생성 |
+| `teamai doctor` | 구성 문제 진단 (`--json`으로 JSON 출력, CI·hook·agent용) |
+| `teamai uninstall` | 모든 teamai 리소스와 hooks 제거 |
+
+## 라이선스
+
+[MIT](LICENSE)
+
+## 기여하기
+
+PR을 환영합니다! 먼저 [CONTRIBUTING.md](.github/CONTRIBUTING.md)를 읽어 주세요.