🧭 Decision Guide
Why trending now: Unable to determine from the provided materials.
Try it if you
-
Your team uses Claude Code, Codex, or Cursor and wants to share skills and rules.The README Overview lists these agents, while Team Execution describes sharing skills, rules, docs, and hooks.
-
Your team has GitHub, GitLab, or a private Git service and can grant members write access.Quick Start requires a shared-experience repository and says to grant write access to team members.
-
You want teamai roles and tags to control which skills different members synchronize.Distribution Controls describes Roles, Tags, and Sources.
-
You want high-friction sessions to become team knowledge and searchable through teamai recall.Team Context describes Stop-hook sharing based on friction, and Commands lists teamai recall.
Skip it if you
-
Your AI provider requires Models configuration, but the project has not implemented Models for every provider.The What Gets Shared table says: Models — Not implemented for every provider yet.
-
You cannot provide Git repository write access or do not accept the push, review, merge, and pull workflow.Quick Start requires member write access, and How It Works shows teamai push → review & merge → teamai pull.
-
You need to place secrets in the shared env/ configuration.What Gets Shared explicitly says: do not put secrets here.
-
You only need local configuration and do not need team Harness, teamai pull, or knowledge-base features.The README defines the core flow around a shared Git repository, teamai push, and teamai pull, with recall listed as a team capability.
Requirements
- The npm package teamai-cli must be installed.
- A shared repository must be created on GitHub, GitLab, GitCode, CNB, TGit, or a private Git service.
- You must grant write access to team members.
- Supported AI agents include Claude Code, Codex, CodeBuddy, WorkBuddy, OpenCode, and Cursor.
First step (verbatim from README)
npm install -g teamai-cli
Watch out
-
teamai init injects hooks; removal requires teamai uninstall.The Commands section describes init as injecting hooks and lists teamai uninstall.
-
teamai packages currently supports only npm packages and Claude Code plugins.The Commands section limits teamai packages to npm packages and Claude Code plugins.
-
Automatic experience sharing prompts at most once per session and may include a redacted task summary.Automatic Experience Sharing states that each session is prompted at most once and that the summary is redacted.
-
docs/ uses progressive disclosure, so not all documents load by default.The What Gets Shared table says Docs are not all loaded by default using progressive disclosure.
Not stated in the README
- The README does not specify minimum Node.js, npm, or Python versions.
- The README does not specify compatible versions of agents such as Claude Code, Codex, or Cursor.
- The README provides no performance data for team size, repository size, or teamai pull.
- The README does not identify the exact license text or restrictions behind the Other license.
- The README does not describe changes in v0.24.0-beta.3 compared with the previous version.
💡 Deep Analysis
6
No
I need to distribute team-level environment variables, MCP, and Hooks to Codex and Cursor, but security policy forbids secrets in Git. Can TeamAI’s env mechanism directly serve as secret management?
No. TeamAI can distribute team-level env settings, but the README explicitly warns not to put secrets in that directory, so it cannot replace a secret-management system.
- “What Gets Shared” defines
env/as shared team-level environment variables and switches, while explicitly statingdo not put secrets here. - MCP, Hooks, and env are delivered through the team repository and
teamai pullinto local AI tools, so an accidental commit could spread across member machines. - The README’s distribution model relies on Git repository permissions; it does not describe secret references, runtime injection, rotation, audit, or encrypted storage.
- TeamAI can therefore manage non-sensitive switches and MCP declarations, but secrets must come from an external enterprise secret system. TeamAI alone does not meet this security constraint.
- README, “What Gets Shared”: `Env | env/ | Shared team-level environment variables and switches; do not put secrets here`
- README, “Team Execution”: resources are distributed to each agent through `teamai pull`
- README, “Quick Start”: requires granting write access to team members
- Project insight, “usage_limitations”: it cannot replace a complete secret-management and security system
No
We mainly use OpenCode, OpenClaw, Hermes, and DeepSeek Harness, but require model configuration, context, and team rules to behave like Claude Code. Can TeamAI guarantee equivalent behavior across these agents?
No, not as a guarantee of behavioral equivalence. The README explicitly shows an uneven capability matrix across agents, and Models are not implemented for every provider.
- In the Overview table, OpenCode, OpenClaw, Hermes, and DeepSeek Harness show
—for some Team Context or Team Improvement capabilities, meaning those capabilities are not universally available. - The “What Gets Shared” section states:
Models — Not implemented for every provider yet. - TeamAI is strong at distributing skills, rules, docs, agents, Hooks, and MCP; it does not unify model invocation, context windows, or execution semantics across agents.
- It can serve as a resource synchronization layer, but it cannot satisfy a hard requirement for Claude Code-equivalent behavior. The README also provides no cross-agent regression or equivalence mechanism.
- README, “Overview”: the capability matrix contains `—` for OpenCode, OpenClaw, Hermes, and DeepSeek Harness
- README, “What Gets Shared”: `Models — Not implemented for every provider yet`
- README, “Team Execution”: shared resources include skills, rules, docs, agents, Hooks, and MCP
Yes
We use Claude Code, Codex, and Cursor simultaneously, need to host team resources on a private Git service, and require merge-request review for every change to skills, rules, Hooks, and MCP. Is TeamAI suitable for centralized distribution?
Yes, it is suitable because it uses a Git repository as the collaboration base for the team Harness and directly covers the listed agents and review workflow.
- The README explicitly supports Claude Code, Codex, and Cursor, and manages skills, rules, agents, Hooks, MCP, env, and docs.
teamai pushcreates a branch and merge request; after approval and merge, a SessionStart Hook runsteamai pull, so members do not need manual synchronization.- Supported Git providers include GitHub, GitLab, GitCode, CNB, TGit, and private Git services. Roles, tags, and sources can narrow distribution.
- However, Models are not implemented for every provider, and Team Context and Team Improvement are beta, so cross-agent behavior should not be assumed to be identical.
- README, “Team Execution”: `teamai push → create branch + MR → reviewer approves + merges`
- README, “Team admin / solo user”: GitHub, GitLab, GitCode, CNB, TGit, or private Git service
- README, “What Gets Shared”: Skills, Rules, Agents, Hooks, MCP, and Env
- README, “Product architecture”: Team Context (beta) × Team Improvement (beta)
npm install -g teamai-cli
It depends
I already have project-level CLAUDE.md, AGENTS.md, Hooks, and MCP configurations, and I need to add team rules to both Codex and Cursor. Should I use project scope or user scope, and will TeamAI overwrite existing configuration?
It depends. TeamAI supports both project scope and user scope, but the README does not promise how existing configuration is merged, overridden, or conflict-resolved.
- Project scope is the default and installs resources under the project directory, which fits project-specific rules.
--scope userinstalls under~/, which fits cross-project resources. initregisters the member and injects Hooks; later AI sessions automatically pull the latest skills, rules, and other Harness updates.- The README lists CLAUDE.md, agents, Hooks, and MCP as shareable resources, so existing local files may collide with team resources by name or behavior.
statusshows differences between local resources and the team repository, whiledoctordiagnoses configuration issues, but neither is documented as an automatic conflict merger.
- README, “Team members”: project-scope init (default) and `teamai init ... --scope user`
- README, “Quick Start”: every AI session automatically pulls the latest skills, rules, and Harness updates
- README, “What Gets Shared”: CLAUDE.md, Agents, Hooks, and MCP
- README, “Commands”: `teamai status` and `teamai doctor`
teamai init https://github.com/yourorg/yourrepo
Yes
We do not yet have a team Git repository, mainly use Cursor and Claude Code, and want preloaded skills, rules, and review agents. Is TeamAI straightforward enough for initial adoption?
Yes. The README provides a template path for users without a team repository, and lists Cursor and Claude Code as supported agents, making the initial setup relatively direct.
- Quick Start recommends choosing a template from teamai-hub; the template is preloaded with production-ready skills, rules, and review agents.
- Initial installation requires a global CLI install followed by
teamai init; project scope is the default and places resources in the current project. - After initialization, every AI session automatically pulls Harness updates published by administrators, reducing manual synchronization.
- Full usage still requires understanding Git repositories, Hooks, resource formats, and merge-request workflows. The current release is v0.24.0-beta.3, with only five releases, so stability and long-term compatibility require separate confirmation.
- README, “Quick Start”: start from a teamai-hub template preloaded with production-ready skills, rules, and review agents
- README, “Team members”: project-scope init is the default scope
- README, “Quick Start”: every AI session automatically pulls the latest Harness updates
- Project data: latest_release is v0.24.0-beta.3; release_count is 5
- README, “Overview”: Claude Code and Cursor are listed as supported agents
npm install -g teamai-cli
It depends
I want to improve team skills from Claude Code session experience, but our enterprise requires customer code and unsanitized summaries to remain inside the network. Can TeamAI’s recall, session save, and promote workflow satisfy this constraint?
It depends. TeamAI provides privacy-scrubbed session summaries and a knowledge lifecycle, but the README does not define it as an enterprise data-isolation or compliance system.
teamai session saverecords a privacy-scrubbed session summary and can write it to the digest with--push;recall promotecan turn a high-confidence learning into a skill, rule, or document.recallsearches knowledge using BM25 plus graph boost, whilecodebase --extractextracts code facts and builds a local graph underteamwiki/.- Team Context and Team Improvement are beta, and the project insight identifies privacy risks in session summaries and code context.
- It is therefore suitable only after the organization verifies sanitization boundaries, repository location, retention, and internal deployment. The README does not specify those controls.
- README, “Commands”: `teamai session save` records a privacy-scrubbed session summary
- README, “Commands”: `teamai recall` uses BM25 plus graph boost; `recall promote` promotes a learning
- README, “Commands”: `teamai codebase --extract [path]` builds `teamwiki/`
- README, “Product architecture”: Team Context (beta) and Team Improvement (beta)
teamai session save
✨ Highlights
-
Supports agents including Claude Code, Codex, and Cursor
-
Distributes the team Harness through push, review, and pull
-
Provides recall, codebase graphs, and experience sharing
-
Team Context and Team Improvement are marked beta
🔧 Engineering
-
teamai init injects shared-repository resources into local AI tools
-
teamai roles and tags control skill synchronization scope
-
teamai recall searches knowledge with BM25 and graph boost
-
The Stop hook suggests sharing sessions based on friction
⚠️ Risks
-
Team Context and Team Improvement are still beta features
-
env/ explicitly forbids storing secrets, requiring separate secret management
-
Models are not yet fully implemented for every provider
-
Initialization requires a Git repository with member write access
👥 For who?
-
Development teams using Claude Code, Codex, or Cursor
-
Teams sharing rules through GitHub, GitLab, or private Git services
-
Organizations standardizing skills, hooks, MCP, and agents configuration