mrkeyoor.com_
Tue 08 Sept 16:07 UTC
Dev Toolsevaluationupdated 08 Sept 2026

teamai-cli review

TeamAI CLI is a Git-backed distribution and memory layer for teams that use several coding agents. It sends shared skills, rules, documents, hooks, MCP settings, and selected session learnings into Claude Code, Codex, Cursor, and other supported tools so each agent starts with the team's working conventions.

Verdict

Our TeamAI CLI run installed 360 packages and used 895 MB, then passed all 2,729 tests, so the implementation is ready for a serious pilot despite its v0.23.0 label. Use it when agent configuration already belongs in your team's Git review process and several clients need the same instructions. Skip it if literal MCP secrets on disk, automatic hook injection, or uneven client support conflict with policy.

We ran it

Lab card: what happened when we ran teamai-cliScreenshot of teamai-cli (github.com/Tencent/teamai-cli)
Install✓ · 28s360 packages · 895 MB
Build✓ · 8s
Tests✓ · 89s2729 passed · 0 failed of 2729 (vitest)
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo502 files~117,460 lines of source · 5 MB · 2 CI workflows · tests dir

Answers from our run

Does teamai-cli build from source?

Dependencies installed in 28 seconds (360 packages), and the build succeeded in 8 seconds. We cloned commit cb51ebc into a clean Debian container with 3 CPUs and no project-specific setup.

Do teamai-cli's tests pass?

Yes: 2729 of 2729 passed when we ran the project's own test command (vitest). Some failures need services or credentials a bare container does not have.

Does teamai-cli have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use teamai-cli?

Teams that cannot store resolved MCP credentials in local config files: the usage guide says variables are replaced with literal values on disk and warns that project configs must never be committed.

What are the alternatives to teamai-cli?

Continue, Superpowers, ToolHive. Our TeamAI CLI run installed 360 packages and used 895 MB, then passed all 2,729 tests, so the implementation is ready for a serious pilot despite its v0.

Setup3/528-second install; shared repo, hooks, and provider auth take planning
Docs5/5English and Chinese guides cover scopes, providers, secrets, and cleanup
Community4/52,180 stars with active September issues and pull requests
Maturity3/5All 2,729 tests passed, though the current release is v0.23.0

Who it’s for

Engineering teams that already use Git review and want one source for agent skills, rules, hooks, and documentation.
Groups running Claude Code, Codex, Cursor, or several supported agents across the same projects.
Platform owners who need role and tag filters instead of giving every agent every instruction.
Teams willing to review configuration changes, maintain provider authentication, and treat agent instructions as versioned code.
Solo developers who use several agent clients and want the same knowledge available in each one.

Who it’s NOT for

Teams that cannot store resolved MCP credentials in local config files: the usage guide says variables are replaced with literal values on disk and warns that project configs must never be committed.
Organizations requiring identical features in every agent: the README matrix omits agents, hooks, MCP, or reporting for several clients, and project-scope MCP is unsupported for Codex.
Users of agent clients without lifecycle hooks who expect automatic updates: the guide names JoyCode and Gemini CLI as tools that need a manual teamai pull.
Teams that vendor public skills and require automatic upstream staleness alerts: open issue 416 says copied skills have no upstream tracking today.
Small groups that only need a few static instruction files: a team repo, hook injection, roles, reporting, and knowledge indexing may create more administration than the files deserve.

Setup reality

Our sandbox installed 360 npm packages in 28 seconds and used 895 MB. The build succeeded in 8 seconds, then all 2,729 Vitest tests passed in 89 seconds. Npm audit found 0 known vulnerabilities. Commit cb51ebc occupied 5 MB before dependencies, with 502 files and about 117,460 lines of source.

The documented minimum is Node.js 20 plus Git. Normal team use needs a writable shared repository and authentication for GitHub, GitLab, GitCode, CNB, TGit, or another Git service. Read-only HTTP consumers instead need a TeamAI endpoint and token. Some providers require their own command-line client.

Initialization writes into each selected agent's configuration and installs session hooks. Automatic pulls depend on lifecycle-hook support, and project-scope MCP is unavailable for Codex. MCP variables are resolved to literal secrets in local config files, so ignore rules and file permissions are part of setup. The repository contains no Dockerfile.

TeamAI 0.23.0 distributes agent instructions through Git

TeamAI CLI treats the instructions around coding agents as shared project material. A team repository stores skills, rules, documents, environment declarations, hooks, MCP definitions, and agent profiles. An administrator publishes changes through branches and merge requests; members pull approved material into each supported client's native directories. That flow is easy to reason about if code review already governs developer tooling. It also gives instruction changes authors, diffs, and rollback points instead of leaving them scattered through home folders.

The 895 MB dependency tree carries a broad CLI

Our clean container installed 360 npm packages in 28 seconds and used 895 MB. The checkout at commit cb51ebc was only 5 MB, so dependencies dominate local disk use. TeamAI requires Node.js 20 or newer and Git. Provider-specific paths may also need command-line clients such as gf for TGit or cnb for CNB, although initialization can install those two. A global npm install is the documented user path.

What happened when we ran it

Our run installed 360 packages in 28 seconds, built the TypeScript project in 8 seconds, and completed the Vitest suite in 89 seconds. All 2,729 tests passed and none failed. Npm audit reported 0 known vulnerabilities in the installed dependency set. These results cover the repository mechanics at commit cb51ebc in a fresh Debian container with 3 CPUs and 8 GB of RAM; they do not test a team's Git permissions or every supported agent.

The repository held 502 files and roughly 117,460 lines of source. We found 2 CI workflow files, no Dockerfile, and a tests directory. The package exposes separate unit and end-to-end commands, while the supplied lab result covers the test target that produced the 2,729-test Vitest total. A passing local suite is meaningful for a tool that edits many configuration formats, though each organization's provider authentication and agent versions still need a small acceptance test.

Seven resource types can alter local agent configuration

TeamAI's pull flow handles 7 named resource classes in the quick-start description: skills, rules, documents, environment values, agents, hooks, and MCP servers. Automatic pull runs at session start on clients with lifecycle hooks. Project hooks can be injected into home-level tool settings because the dispatcher checks the current working directory at runtime. That choice makes synchronization convenient, while it also means administrators should inspect generated diffs and run teamai pull --dry-run before broad rollout.

Secret handling is the sharpest policy issue. MCP definitions may use environment-style placeholders in the team repository, but TeamAI resolves each value and writes the literal secret into the target client's config. New files receive mode 0600; project files still need ignore rules and must never be committed. The reason is practical: graphical IDE launches often lack the shell environment. Security teams may prefer a secret broker or agent-native interpolation even if that makes startup less predictable.

Ten supported agents still have different capabilities

The 10-row compatibility table contains visible gaps. WorkBuddy lacks distributed agent profiles, OpenCode omits usage, sessions, and dashboard features, and several lighter clients lack hooks or MCP support. The usage guide also says Codex has no project-scope MCP destination, although user-scope configuration is supported. Teams should map their required columns before adopting TeamAI, since the phrase "supported agent" does not promise the same behavior everywhere.

Open issue 435 reports duplicate Codex skills when a project already uses .agents/skills and TeamAI also writes .codex/skills. Issue 354 documents a host limitation where CodeBuddy and WorkBuddy discard Stop-hook output, forcing TeamAI to deliver its learning hint on the next user prompt. Both reports concern the cross-client reconciliation that makes the project useful. They are also a reminder to pilot with the exact agent versions and directory conventions your developers use.

The shared memory works only after teams curate it

Version 0.23.0 can collect friction signals from sessions, suggest that a useful lesson be shared, search approved learnings, and import code into a graph-backed wiki. Recall is disabled by default and deploys a retrieval subagent when enabled. Session summaries are described as privacy-scrubbed, and third-party packages are never installed automatically after a pull. Members must review a declaration and run the package command themselves, which keeps downloaded code behind an explicit action.

Copied public skills have a maintenance gap. Open issue 416 says vendored skills do not retain upstream provenance or warn when the original changes. TeamAI subscriptions can refresh compatible repositories, but most public skill repositories do not use its required layout. A team that customizes copied skills should record the upstream commit itself and schedule review until the proposed staleness command exists. Shared memory becomes useful through ownership and pruning; a larger index alone does not make an agent better informed.

A September 8 push shows active maintenance at v0.23.0

GitHub recorded a push on September 8, 2026, the same day v0.23.0 was published. The repository had 2,180 stars and 24 open issues and pull requests when fetched. It began in April 2026, so this is a young project shipping frequently. The current release notes contain only a comparison link, which is less useful than the detailed English and Simplified Chinese usage guides when deciding how an upgrade changes local state.

TeamAI is most convincing as internal developer infrastructure for a group already comfortable reviewing configuration in Git. The clean 2,729-test result lowers the technical risk of a pilot, while the 895 MB install, client-specific gaps, plaintext local secrets, and hook writes set the operational price. Start with one repository and two agent clients, inspect the generated files, test uninstall behavior, and decide who owns stale skills before making session-start synchronization a team default.

Alternatives

ProjectWhat it isPick it when
Continue gh↗An open-source coding agent with shared configuration and IDE integrations.pick this instead when the team wants one coding-agent experience rather than a distribution layer across many agents.
Superpowers gh↗An opinionated set of reusable software-development skills for coding agents.pick this instead when you want a ready-made workflow and do not need roles, Git-backed publishing, session reports, or a team knowledge graph.
ToolHive gh↗A platform focused on installing, running, and governing MCP servers.pick this instead when MCP runtime isolation and server operations matter more than distributing skills and team memory.

What people are saying

  1. [github-trending] Tencent/teamai-cli

Sources

  1. TeamAI CLI README
  2. TeamAI usage guide
  3. TeamAI CLI v0.23.0 release
  4. Issue 416: upstream skill tracking
  5. Issue 435: duplicate Codex skill paths
  6. Issue 354: CodeBuddy and WorkBuddy Stop hooks

More dev tools reviews

buildkit · validator · rustlings · zstd · styled-components · ILSpy · the whole board →