teamai-cli 0.20.0-beta.1 → 0.20.0-beta.3

package/README.md

@@ -60,15 +60,17 @@ No separate team repo. Run `teamai init .` inside an existing project and its ow
 
 ```bash
 cd /path/to/my-project
-teamai init .          # or: teamai init --self
+teamai init .                        # interactive: pick which AI tools to set up
+teamai init . --agent claude,codex   # non-interactive: Claude Code + Codex
 ```
 
 - **Knowledge** (skills / rules / docs / learnings) is committed to your repo's **main branch** under `.teamai/`, so a plain `git clone` already carries the whole team setup.
 - **Reports** (member registrations, session summaries, votes, usage stats) go to a separate **`teamai-reports` orphan branch** — they never touch main.
+- **You choose which AI tools to set up.** `--agent claude,codex` (repeatable/comma-separated), an interactive picker when omitted, or — in non-interactive contexts — whichever tools you already use under `~/`. teamai creates each selected tool's dir, injects hooks, and commits its settings.
 - **Clone = initialized.** When a teammate clones the repo, the next `teamai` command (or AI session) auto-detects the `mode: self` marker in `.teamai/teamai.yaml` and finishes local setup automatically — no need to re-type repo/role.
 - All of teamai's git operations run in isolated worktrees, so your working tree and current branch are never touched.
 
-After `teamai init .`, commit `.teamai/` (skills, rules, docs, learnings, `teamai.yaml`, `.gitignore`) and `.claude/settings.json` to main so teammates get auto-initialized on clone.
+`teamai init .` commits `.teamai/` (skills, rules, docs, learnings, `teamai.yaml`, `.gitignore`) plus each selected tool's settings (e.g. `.claude/settings.json`, `.codex/hooks.json`) for you; just push main so teammates get auto-initialized on clone.
 
 > **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.
 

package/README.zh-CN.md

@@ -60,15 +60,17 @@ teamai init https://github.com/yourorg/project-repo --inherit-user-scope
 
 ```bash
 cd /path/to/my-project
-teamai init .          # 或：teamai init --self
+teamai init .                        # 交互式：选择要启用哪些 AI 工具
+teamai init . --agent claude,codex   # 非交互:启用 Claude Code + Codex
 ```
 
 - **知识资产**（skills / rules / docs / learnings）提交到仓库 **main 分支**的 `.teamai/` 目录，因此一次普通 `git clone` 就带上了整套团队配置。
 - **上报数据**（成员注册、会话摘要、投票、使用统计）走独立的 **`teamai-reports` 孤儿分支** —— 永不污染 main。
+- **由你选择启用哪些 AI 工具。** `--agent claude,codex`（可重复/逗号分隔）,省略时弹交互选择框,非交互场景则按你本机 `~/` 下已装的工具来建。teamai 为每个所选工具建目录、注入 hooks、并提交其 settings。
 - **克隆即初始化。** 团队成员 clone 仓库后，下一条 `teamai` 命令（或 AI 会话）会自动识别 `.teamai/teamai.yaml` 里的 `mode: self` 标记并自动完成本机初始化 —— 无需手抄 repo/role 参数。
 - teamai 的所有 git 操作都在隔离的 worktree 中进行，绝不触碰你的工作区和当前分支。
 
-执行 `teamai init .` 后，把 `.teamai/`（skills、rules、docs、learnings、`teamai.yaml`、`.gitignore`）和 `.claude/settings.json` 提交到 main，团队成员 clone 后即可自动初始化。
+`teamai init .` 会帮你把 `.teamai/`（skills、rules、docs、learnings、`teamai.yaml`、`.gitignore`）以及每个所选工具的 settings（如 `.claude/settings.json`、`.codex/hooks.json`）提交好;推送 main 后团队成员 clone 即可自动初始化。
 
 > **完整使用指南**：[docs/usage-guide.zh-CN.md](docs/usage-guide.zh-CN.md)（[English](docs/usage-guide.md)）— 涵盖从团队创建到日常使用的全流程。
 

package/dist/index.js

@@ -9655,11 +9655,18 @@ async function pushCore(localConfig, teamConfig, options) {
     log.debug(`Pre-push sync skipped: ${e.message}`);
   }
   const spin = spinner("Scanning local resources...").start();
+  const scanTeamConfig = selfMode ? {
+    ...teamConfig,
+    toolPaths: {
+      ...teamConfig.toolPaths,
+      [SELF_KNOWLEDGE_SCAN_KEY]: { skills: ".teamai/skills", rules: ".teamai/rules" }
+    }
+  } : teamConfig;
   const pushableTypes = ["skills", "rules", "env", "agents"];
   const allItems = [];
   for (const type of pushableTypes) {
     const handler = getHandler(type);
-    const items = await handler.scanLocalForPush(teamConfig, localConfig);
+    const items = await handler.scanLocalForPush(scanTeamConfig, localConfig);
     allItems.push(...items);
   }
   spin.stop();
@@ -9933,6 +9940,7 @@ ${selectedItems.map((i) => `- [${i.type}] ${i.name}`).join("\n")}`
   }
   await saveStateForScope(state, localConfig.scope, localConfig.projectRoot);
 }
+var SELF_KNOWLEDGE_SCAN_KEY;
 var init_push = __esm({
   "src/push.ts"() {
     "use strict";
@@ -9948,6 +9956,7 @@ var init_push = __esm({
     init_roles();
     init_prompt();
     init_fs();
+    SELF_KNOWLEDGE_SCAN_KEY = "__teamai_self_knowledge__";
   }
 });
 
@@ -10263,15 +10272,34 @@ var init_git = __esm({
 var known_agents_exports = {};
 __export(known_agents_exports, {
   KNOWN_AGENTS: () => KNOWN_AGENTS,
+  SELF_MODE_AGENT_CHOICES: () => SELF_MODE_AGENT_CHOICES,
+  detectHomeInstalledAgents: () => detectHomeInstalledAgents,
   detectInstalledAgents: () => detectInstalledAgents,
   getEffectiveAgents: () => getEffectiveAgents,
+  normalizeAgentList: () => normalizeAgentList,
   seedSelfModeToolDirs: () => seedSelfModeToolDirs
 });
 import path34 from "path";
+function normalizeAgentList(agent) {
+  if (agent === void 0) return [];
+  const raw = Array.isArray(agent) ? agent : [agent];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const part of raw) {
+    for (const piece of String(part).split(",")) {
+      const id = piece.trim();
+      if (id && !seen.has(id)) {
+        seen.add(id);
+        out.push(id);
+      }
+    }
+  }
+  return out;
+}
 async function seedSelfModeToolDirs(localConfig, teamConfig) {
   const baseDir = resolveBaseDir(localConfig);
   const configured = teamConfig.toolPaths ?? {};
-  let targets = localConfig.enabledAgents && localConfig.enabledAgents.length > 0 ? localConfig.enabledAgents : ["claude"];
+  let targets = localConfig.enabledAgents ?? [];
   targets = targets.filter((id) => !isAgentDisabled(localConfig, id));
   const seeded = [];
   for (const id of targets) {
@@ -10282,6 +10310,21 @@ async function seedSelfModeToolDirs(localConfig, teamConfig) {
   }
   return seeded;
 }
+async function detectHomeInstalledAgents(candidateIds = SELF_MODE_AGENT_CHOICES) {
+  const home = process.env.HOME;
+  if (!home) return [];
+  const found = [];
+  for (const id of candidateIds) {
+    const skillsPath = KNOWN_AGENTS.find((a) => a.id === id)?.skillsPath;
+    if (!skillsPath) continue;
+    const rootSegment = skillsPath.split("/")[0];
+    if (!rootSegment) continue;
+    if (await pathExists(path34.join(home, rootSegment))) {
+      found.push(id);
+    }
+  }
+  return found;
+}
 function getEffectiveAgents(teamConfig) {
   const byId = /* @__PURE__ */ new Map();
   for (const agent of KNOWN_AGENTS) {
@@ -10325,12 +10368,13 @@ async function detectInstalledAgents(localConfig, teamConfig) {
   }
   return results;
 }
-var KNOWN_AGENTS;
+var SELF_MODE_AGENT_CHOICES, KNOWN_AGENTS;
 var init_known_agents = __esm({
   "src/known-agents.ts"() {
     "use strict";
     init_fs();
     init_types();
+    SELF_MODE_AGENT_CHOICES = ["claude", "codex", "cursor", "codebuddy", "workbuddy"];
     KNOWN_AGENTS = [
       // Coding agents already wired through teamConfig.toolPaths defaults
       { id: "claude", displayName: "Claude Code", category: "coding", skillsPath: ".claude/skills" },
@@ -10446,12 +10490,15 @@ async function bootstrapSelfRepo(dir, opts) {
       log.debug("[bootstrap] teamai.yaml not loadable; skipping");
       return "skip";
     }
+    const { detectHomeInstalledAgents: detectHomeInstalledAgents2 } = await Promise.resolve().then(() => (init_known_agents(), known_agents_exports));
+    const enabledAgents = await detectHomeInstalledAgents2();
     const localConfig = {
       repo: { localPath, remote: repoInfo.httpsUrl, kind: "self", businessRepoRoot },
       username,
       scope: "project",
       projectRoot: businessRepoRoot,
-      additionalRoles: []
+      additionalRoles: [],
+      ...enabledAgents.length > 0 ? { enabledAgents } : {}
     };
     try {
       const { loadRolesManifest: loadRolesManifest2 } = await Promise.resolve().then(() => (init_roles(), roles_exports));
@@ -10741,6 +10788,7 @@ __export(init_exports, {
   init: () => init,
   initHttp: () => initHttp,
   initSelfRepo: () => initSelfRepo,
+  promptForSelfModeAgents: () => promptForSelfModeAgents,
   resolveInheritUserScope: () => resolveInheritUserScope,
   resolveInitRepo: () => resolveInitRepo,
   resolveInitScope: () => resolveInitScope
@@ -10962,11 +11010,12 @@ async function initHttp(url, options) {
       log.debug(`Role selection skipped: ${msg}`);
     }
   }
-  if (options.agent) {
+  const requestedAgents = normalizeAgentList(options.agent);
+  if (requestedAgents.length > 0) {
     const existing = await loadLocalConfigForScope(scope, projectRoot);
     const prev = existing?.enabledAgents ?? [];
-    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, options.agent])];
-    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => t !== options.agent);
+    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, ...requestedAgents])];
+    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => !requestedAgents.includes(t));
   }
   await ensureDir(teamaiHome);
   if (scope === "project") {
@@ -10982,7 +11031,7 @@ async function initHttp(url, options) {
     await saveStateForScope(state, scope, projectRoot);
   } catch {
   }
-  const filterAgents2 = options.agent ? [options.agent] : void 0;
+  const filterAgents2 = requestedAgents.length > 0 ? requestedAgents : void 0;
   await reconcileTeamHooksForConfig(teamConfig, localConfig, { filterAgents: filterAgents2 });
   const { initLocalAgentHttp: initLocalAgentHttp2 } = await Promise.resolve().then(() => (init_local_agent(), local_agent_exports));
   try {
@@ -11023,6 +11072,35 @@ function buildSelfModeGitignore() {
     ""
   ].join("\n");
 }
+async function promptForSelfModeAgents(options) {
+  const explicit = normalizeAgentList(options.agent);
+  if (explicit.length > 0) return explicit;
+  if (options.silent || options.force || !process.stdin.isTTY) {
+    return detectHomeInstalledAgents();
+  }
+  const choices = SELF_MODE_AGENT_CHOICES.map((id) => {
+    const meta = KNOWN_AGENTS.find((a) => a.id === id);
+    const root = meta?.skillsPath.split("/")[0] ?? `.${id}`;
+    return { id, label: meta?.displayName ?? id, root };
+  });
+  console.log("");
+  console.log("Which AI tools should teamai set up in this repo?");
+  console.log("(creates the skills dir, injects hooks, commits settings to main)");
+  console.log("");
+  choices.forEach((c, i) => {
+    console.log(`  ${i + 1}. ${c.label}  (${c.root})`);
+  });
+  console.log("");
+  const indices = await askSelection(
+    `Select [1-${choices.length}, comma/range, or "all"] (default: 1 = ${choices[0].label}): `,
+    choices.length,
+    false
+  );
+  if (!indices || indices.length === 0) {
+    return ["claude"];
+  }
+  return indices.map((i) => choices[i].id);
+}
 async function initSelfRepo(options) {
   log.info("Initializing teamai (single-repo mode)...");
   const cwd = process.cwd();
@@ -11134,11 +11212,12 @@ async function initSelfRepo(options) {
       log.debug(`Role selection skipped: ${msg}`);
     }
   }
-  if (options.agent) {
+  const selectedAgents = await promptForSelfModeAgents(options);
+  if (selectedAgents.length > 0) {
     const existing = await loadLocalConfigForScope("project", businessRepoRoot);
     const prev = existing?.enabledAgents ?? [];
-    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, options.agent])];
-    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => t !== options.agent);
+    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, ...selectedAgents])];
+    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => !selectedAgents.includes(t));
   }
   await ensureDir(teamaiHome);
   await saveLocalConfigForScope(localConfig, "project", businessRepoRoot);
@@ -11146,6 +11225,15 @@ async function initSelfRepo(options) {
   const gitignorePath = path38.join(teamaiHome, ".gitignore");
   await writeFile(gitignorePath, buildSelfModeGitignore());
   log.debug("Generated single-repo .teamai/.gitignore");
+  const filterAgents2 = selectedAgents.length > 0 ? selectedAgents : void 0;
+  try {
+    const { seedSelfModeToolDirs: seedSelfModeToolDirs2 } = await Promise.resolve().then(() => (init_known_agents(), known_agents_exports));
+    const seeded = await seedSelfModeToolDirs2(localConfig, teamConfig);
+    if (seeded.length > 0) log.debug(`Seeded tool dirs for: ${seeded.join(", ")}`);
+  } catch (e) {
+    log.debug(`Tool-dir seeding skipped: ${e.message}`);
+  }
+  await reconcileTeamHooksForConfig(teamConfig, localConfig, { filterAgents: filterAgents2 });
   if (!options.dryRun) {
     try {
       const { commitPaths: commitPaths2, hasCommits: hasCommits2 } = await Promise.resolve().then(() => (init_git(), git_exports));
@@ -11156,9 +11244,12 @@ async function initSelfRepo(options) {
         ".teamai/docs",
         ".teamai/learnings",
         ".teamai/teamai.yaml",
-        ".teamai/.gitignore",
-        ".claude/settings.json"
+        ".teamai/.gitignore"
       ];
+      for (const id of selectedAgents) {
+        const settingsPath = teamConfig.toolPaths?.[id]?.settings;
+        if (settingsPath) skeletonPaths.push(settingsPath);
+      }
       const committed = await commitPaths2(
         businessRepoRoot,
         "[teamai] Initialize single-repo mode (skills/rules/docs/learnings skeleton)",
@@ -11203,15 +11294,6 @@ async function initSelfRepo(options) {
     await saveStateForScope(state, "project", businessRepoRoot);
   } catch {
   }
-  try {
-    const { seedSelfModeToolDirs: seedSelfModeToolDirs2 } = await Promise.resolve().then(() => (init_known_agents(), known_agents_exports));
-    const seeded = await seedSelfModeToolDirs2(localConfig, teamConfig);
-    if (seeded.length > 0) log.debug(`Seeded tool dirs for: ${seeded.join(", ")}`);
-  } catch (e) {
-    log.debug(`Tool-dir seeding skipped: ${e.message}`);
-  }
-  const filterAgents2 = options.agent ? [options.agent] : void 0;
-  await reconcileTeamHooksForConfig(teamConfig, localConfig, { filterAgents: filterAgents2 });
   log.success("teamai initialized (single-repo mode)!");
   log.info("Push your business repo (e.g. `git push -u origin HEAD`) so teammates get the .teamai/ knowledge and are auto-initialized on clone.");
   log.info("Add skills/rules later with `teamai push` \u2014 it opens a PR against your repo without touching your working tree.");
@@ -11484,11 +11566,12 @@ async function init(options) {
       process.exit(1);
     }
   }
-  if (options.agent) {
+  const requestedAgents = normalizeAgentList(options.agent);
+  if (requestedAgents.length > 0) {
     const existing = await loadLocalConfigForScope(scope, projectRoot);
     const prev = existing?.enabledAgents ?? [];
-    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, options.agent])];
-    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => t !== options.agent);
+    localConfig.enabledAgents = [.../* @__PURE__ */ new Set([...prev, ...requestedAgents])];
+    localConfig.disabledAgents = (existing?.disabledAgents ?? []).filter((t) => !requestedAgents.includes(t));
   }
   await ensureDir(teamaiHome);
   if (scope === "project") {
@@ -11529,7 +11612,7 @@ async function init(options) {
   }
   const reloadedTeamConfig = await loadTeamConfig(localPath);
   if (reloadedTeamConfig) {
-    const filterAgents2 = options.agent ? [options.agent] : void 0;
+    const filterAgents2 = requestedAgents.length > 0 ? requestedAgents : void 0;
     await reconcileTeamHooksForConfig(reloadedTeamConfig, localConfig, { filterAgents: filterAgents2 });
   }
   log.success("teamai initialized successfully!");
@@ -11550,6 +11633,7 @@ var init_init = __esm({
     init_types();
     init_roles();
     init_prompt();
+    init_known_agents();
   }
 });
 
@@ -30807,7 +30891,7 @@ program.name("teamai").description("TeamAI \u2014 The team harness for AI agents
   const opts = thisCommand.opts();
   if (opts.verbose) setVerbose(true);
 });
-program.command("init").description("Initialize teamai (configure TGit, clone repo, register member)").argument("[repo]", 'Team repo (owner/repo or full URL). Pass "." for single-repo mode (the current git repo is the team repo).').option("--repo <repo>", "Team repo (alias of the positional argument)").option("--http <url>", "Git-free HTTP team repo (read-only consumer; only needs an API key)").option("--self", "Single-repo mode: the current git repo is the team repo (equivalent to `teamai init .`). Knowledge lives on main under .teamai/; reports go to the teamai-reports orphan branch.").option("--token <key>", "API key for HTTP team repo / status reporting (stored 0600, never committed). Also reads TEAMAI_API_TOKEN.").option("--scope <scope>", "Install scope: project (default, <cwd>/.teamai + <cwd>/.claude) or user (~/.teamai + ~/.claude)").option("--inherit-user-scope", "In project scope, also sync safe user-scope resources and search its knowledge").option("--no-inherit-user-scope", "Disable user-scope inheritance for this project").option("--role <id>", "Primary role ID (e.g. hai_dev) for non-interactive setup").option("--agent <name>", "Only inject hooks into this agent (e.g. claude, codebuddy, workbuddy). Additive on repeated runs.").option("--force", "Overwrite existing config without confirmation").action(async (repoArg, cmdOpts) => {
+program.command("init").description("Initialize teamai (configure TGit, clone repo, register member)").argument("[repo]", 'Team repo (owner/repo or full URL). Pass "." for single-repo mode (the current git repo is the team repo).').option("--repo <repo>", "Team repo (alias of the positional argument)").option("--http <url>", "Git-free HTTP team repo (read-only consumer; only needs an API key)").option("--self", "Single-repo mode: the current git repo is the team repo (equivalent to `teamai init .`). Knowledge lives on main under .teamai/; reports go to the teamai-reports orphan branch.").option("--token <key>", "API key for HTTP team repo / status reporting (stored 0600, never committed). Also reads TEAMAI_API_TOKEN.").option("--scope <scope>", "Install scope: project (default, <cwd>/.teamai + <cwd>/.claude) or user (~/.teamai + ~/.claude)").option("--inherit-user-scope", "In project scope, also sync safe user-scope resources and search its knowledge").option("--no-inherit-user-scope", "Disable user-scope inheritance for this project").option("--role <id>", "Primary role ID (e.g. hai_dev) for non-interactive setup").option("--agent <name>", "AI tools to set up (e.g. claude, codex, cursor, codebuddy, workbuddy). Repeatable or comma-separated. In single-repo mode, selects which tool dirs to create; omit for an interactive picker. Additive on repeated runs.", (val, acc) => acc.concat(val), []).option("--force", "Overwrite existing config without confirmation").action(async (repoArg, cmdOpts) => {
   const globalOpts = program.opts();
   const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
   await init2({ ...globalOpts, ...cmdOpts, repoPositional: repoArg });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamai-cli",
-  "version": "0.20.0-beta.1",
+  "version": "0.20.0-beta.3",
   "description": "TeamAI — the team harness for AI agents (skill sync + shared knowledge base, powered by Git)",
   "type": "module",
   "bin": {