# teamai-cli | Tencent | Knowledge Base | Instagit

Make Every Team AI Native

GitHub Stars: 4k

Repository: https://github.com/tencent/teamai-cli

---

## Articles

### [Per-User Skill Exclusion Mechanism in TeamAI CLI: How It Works](/tencent/teamai-cli/teamai-per-user-skill-exclusion-mechanism-how-it-works)

Master the per-user skill exclusion mechanism in TeamAI CLI. Learn how to locally filter skills during pull operations without impacting the shared repository.

- Tags: deep-dive
- Published: 2026-09-11

### [How TeamAI Manages Environment Variable Injection Across Developer Tools](/tencent/teamai-cli/how-teamai-manages-environment-variable-injection-tools)

TeamAI centralizes env variable injection via a shell script and guarded blocks for secure, cross-tool synchronization across developer tools.

- Tags: how-to-guide
- Published: 2026-09-11

### [CI Integration Flow for Extracting Knowledge from Merge Requests in TeamAI](/tencent/teamai-cli/teamai-ci-integration-flow-extracting-knowledge-mrs)

Automate AI knowledge extraction from Merge Requests with teamai ci. This flow posts insights as comments and saves learnings to your knowledge repository.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Configure HTTP Sources Alongside the Main Git Team Repo in TeamAI](/tencent/teamai-cli/how-to-configure-http-sources-teamai-git-repo)

Learn how to configure HTTP sources alongside your main Git team repo in TeamAI. Use teamai source add-http for a hybrid setup.

- Tags: how-to-guide
- Published: 2026-09-11

### [teamai.yaml Configuration Options for Recall and Sharing Hints](/tencent/teamai-cli/teamai-yaml-configuration-options-recall-sharing-hints)

Explore teamai.yaml configuration for recall and sharing hints. Learn how to enable automatic knowledge retrieval and post-session sharing prompts with Tencent/teamai-cli.

- Tags: api-reference
- Published: 2026-09-11

### [How TeamAI Migrates from the Legacy .teamai/ Directory to the New Partitioned Layout](/tencent/teamai-cli/how-teamai-handles-legacy-teamai-migration-new-partition)

TeamAI automatically migrates your legacy .teamai/ data to a new partitioned layout upon upgrade. Experience isolated storage for machine-local artifacts with this seamless transition.

- Tags: migration-guide
- Published: 2026-09-11

### [TeamAI Contribution Workflow: Promoting Learnings to Formal Skills and Rules](/tencent/teamai-cli/teamai-contribution-workflow-promoting-learnings-skills-rules)

Discover the TeamAI contribution workflow. Promote developer learnings to formal skills and rules via a three-stage pipeline. Enhance your team's knowledge base effectively.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Run the Knowledge Graph Lint and Reconcile Product with Code Docs in TeamAI](/tencent/teamai-cli/how-to-run-knowledge-graph-lint-reconcile-docs-teamai)

Learn how to run the TeamAI knowledge graph lint and reconcile product with code docs using simple CLI commands. Ensure your TeamAI knowledge graph is healthy and synchronized.

- Tags: how-to-guide
- Published: 2026-09-11

### [How TeamAI’s Deep-Enrich Process Generates Knowledge Docs from Extracted Code](/tencent/teamai-cli/what-is-teamai-deep-enrich-process-generating-knowledge-docs-code)

Discover TeamAI's deep-enrich process. This six-phase pipeline transforms extracted code into structured knowledge docs like component designs and architecture overviews. Learn more from the Tencent teamai-cli repository.

- Tags: deep-dive
- Published: 2026-09-11

### [How TeamAI Tracks Usage Statistics and Generates Weekly Digests](/tencent/teamai-cli/how-teamai-tracks-usage-statistics-generates-weekly-digests)

Discover how TeamAI CLI automatically tracks usage statistics using IDE hooks and team YAML data. Generate weekly digests for team health and usage trends.

- Tags: how-to-guide
- Published: 2026-09-11

### [TeamAI Single-Repo Mode (`--self`): Complete Guide and When to Use It](/tencent/teamai-cli/teamai-single-repo-mode-self-usage)

Master TeamAI single-repo mode with the --self flag. Learn when to use it for a self-contained knowledge hub storing skills and config in .teamai alongside your code.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Configure Tag-Based Skill and Rule Filtering in TeamAI](/tencent/teamai-cli/how-to-configure-tag-based-skill-rule-filtering-teamai)

Learn how to configure tag-based skill and rule filtering in TeamAI. Subscribe to tags via tags.yaml for selective synchronization with teamai pull.

- Tags: how-to-guide
- Published: 2026-09-11

### [Trust-On-First-Use Flow for New Member Registration in TeamAI](/tencent/teamai-cli/what-is-trust-on-first-use-flow-new-member-registration-teamai)

Learn the trust-on-first-use flow for new member registration in TeamAI. Understand how teamai init creates trusted YAML records on the teamai-reports branch.

- Tags: how-to-guide
- Published: 2026-09-11

### [How TeamAI Manages MCP Server Injection Across Multiple AI Tools](/tencent/teamai-cli/how-teamai-manages-mcp-server-injection-multiple-ai-tools)

TeamAI-CLI manages MCP server injection across AI tools like Claude and Codex using a deterministic pipeline for discovery, compliance, and configuration.

- Tags: architecture
- Published: 2026-09-11

### [TeamAI Built-in Hooks: How the SessionStart Hook Triggers Automatic Pull](/tencent/teamai-cli/teamai-hooks-injected-sessionstart-hook-auto-pull)

Discover how TeamAI's SessionStart hook automatically runs teamai pull to sync resources. Learn about the six built-in hooks and efficient session management.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Set Up Cross-Team Skill Subscriptions in TeamAI](/tencent/teamai-cli/how-to-set-up-cross-team-skill-subscriptions-teamai-repos)

Learn to set up cross-team skill subscriptions in TeamAI. Easily share and pull skills between repositories using teamai.yaml and the teamai pull command.

- Tags: how-to-guide
- Published: 2026-09-11

### [TeamAI Codebase Knowledge Graph Extraction Flow: AST vs Heuristic Tracks Explained](/tencent/teamai-cli/teamai-codebase-knowledge-graph-extraction-flow-ast-heuristic)

Understand the TeamAI codebase knowledge graph extraction flow. Explore AST and heuristic tracks, powered by tree-sitter and regex, for precise dependency mapping and universal fallback.

- Tags: deep-dive
- Published: 2026-09-11

### [How TeamAI CLI Integrates with GitHub, GitLab, and GitCode: The Provider Architecture Explained](/tencent/teamai-cli/how-teamai-integrates-git-providers-github-gitlab-gitcode)

Discover how TeamAI CLI seamlessly integrates with GitHub, GitLab, and GitCode using a unified GitProvider interface and factory pattern. Streamline your Git operations.

- Tags: architecture
- Published: 2026-09-11

### [TeamAI Data Directory Layout and Migration Path for the .teamai Partition](/tencent/teamai-cli/teamai-data-directory-layout-migration-path-teamai-partition)

Understand the TeamAI data directory layout at ~/.teamai and the automatic migration path from legacy .teamai folders. Learn how TeamAI CLI manages machine-level knowledge.

- Tags: internals
- Published: 2026-09-11

### [How to Configure Role-Based Namespace Mappings for TeamAI Skill Distribution](/tencent/teamai-cli/how-to-configure-role-based-namespace-mappings-teamai-skill-distribution)

Learn to configure role-based namespace mappings in Tencent/teamai-cli. Assign roles to your workspace and let SkillsHandler filter operations automatically for efficient skill distribution.

- Tags: how-to-guide
- Published: 2026-09-11

### [Understanding the Friction-Based Session Scoring Algorithm for TeamAI Share-Learnings](/tencent/teamai-cli/what-is-friction-based-session-scoring-algorithm-teamai-share-learnings)

Discover the friction-based session scoring algorithm in TeamAI CLI. It measures coding session complexity using friction signals to trigger learnings only when value is high.

- Tags: deep-dive
- Published: 2026-09-11

### [How TeamAI Recall Uses BM25 and Graph-Boost for Knowledge Retrieval](/tencent/teamai-cli/how-teamai-recall-use-bm25-graph-boost-knowledge-retrieval)

Discover how TeamAI Recall enhances knowledge retrieval with a two-stage pipeline combining BM25 scoring and graph-boost re-ranking for deeper code understanding.

- Tags: how-to-guide
- Published: 2026-09-11

### [TeamAI Unified Hook-Dispatch System Architecture and 7-Second Hard Exit Explained](/tencent/teamai-cli/what-is-the-architecture-of-teamai-unified-hook-dispatch-system-7-second-exit)

Understand TeamAI's unified hook-dispatch system architecture and its 7-second hard exit. Learn how it prevents host blocking while ensuring background task completion.

- Tags: architecture
- Published: 2026-09-11

### [How TeamAI Handles Multi-Project Resource Isolation and Distribution](/tencent/teamai-cli/how-does-teamai-handle-multi-project-resource-isolation-and-distribution)

Discover how TeamAI achieves multi-project resource isolation and distribution. Learn about per-project partitions and deterministic slug generation for shared worktrees.

- Tags: internals
- Published: 2026-09-11

### [How to Update teamai-cli to the Latest Version: A Complete Guide](/tencent/teamai-cli/how-to-update-teamai-cli-to-the-latest-version)

Easily update teamai-cli to the latest version using the simple teamai update command. Learn how to check for updates or install the newest release automatically.

- Tags: how-to-guide
- Published: 2026-09-11

### [teamai-cli Usage Examples: From Installation to CI/CD Integration](/tencent/teamai-cli/where-can-i-find-examples-of-teamai-cli-usage)

Explore teamai-cli usage examples from basic setup to CI/CD integration. Discover installation, repository initialization, and GitHub Actions automation in our detailed guide.

- Tags: tutorial
- Published: 2026-09-11

### [How to Contribute to the teamai-cli Project: A Step-by-Step Developer Guide](/tencent/teamai-cli/how-to-contribute-to-the-teamai-cli-project)

Learn how to contribute to the teamai-cli project with this step-by-step developer guide. Fork, code, test, and submit your pull request to the Tencent/teamai-cli repo.

- Tags: how-to-guide
- Published: 2026-09-11

### [TeamAI-CLI Project Structure: A Complete Guide to the Modular Architecture](/tencent/teamai-cli/what-is-the-project-structure-of-a-teamai-cli-application)

Explore the TeamAI-CLI project structure, a modular TypeScript architecture. Discover how its sub-command design and lazy loading optimize performance for faster startup times.

- Tags: architecture
- Published: 2026-09-11

### [How to View Logs for teamai-cli Operations: Complete Debugging Guide](/tencent/teamai-cli/how-to-view-logs-for-teamai-cli-operations)

Learn how to view logs for teamai-cli operations. Access debug.log at ~/.teamai/debug.log and use the --verbose flag for real-time console output. Your complete debugging guide.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Manage API Keys for AI Models in teamai-cli: Secure Credential Handling](/tencent/teamai-cli/how-to-manage-api-keys-for-ai-models-in-teamai-cli)

Learn to securely manage API keys for AI models in teamai-cli. Discover how teamai-cli handles credentials via environment variables or a local file for robust security.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Use Different AI Models with TeamAI-CLI: Complete Configuration Guide](/tencent/teamai-cli/how-to-use-different-ai-models-with-teamai-cli)

Configure and use diverse AI models with TeamAI-CLI using JSON manifests, CLI flags, and skill front-matter. Integrate multiple AI providers seamlessly into your projects.

- Tags: how-to-guide
- Published: 2026-09-11

### [Supported AI Model Providers for teamai-cli: Claude, OpenAI, Gemini & More](/tencent/teamai-cli/what-are-the-supported-ai-model-providers-for-teamai-cli)

Discover supported AI model providers for teamai-cli, including Claude, OpenAI, Gemini, and more. Effortlessly integrate top AI services with automatic or explicit provider selection.

- Tags: api-reference
- Published: 2026-09-11

### [How to Deploy AI Agents Created with teamai-cli: The Complete Workflow](/tencent/teamai-cli/how-to-deploy-ai-agents-created-with-teamai-cli)

Deploy AI agents with teamai-cli easily. Automate conversion and deployment to local tool directories like Claude and Codex using teamai pull. Get the complete workflow.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Test AI Agent Components in teamai-cli: Unit, Integration, and E2E Examples](/tencent/teamai-cli/how-to-test-ai-agent-components-in-teamai-cli)

Learn to test AI agent components in teamai-cli with unit, integration, and E2E examples. Master testing strategies for registry functions, detection logic, and complete workflows.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Debug AI Agents Developed with teamai-cli: A Complete Troubleshooting Guide](/tencent/teamai-cli/how-to-debug-ai-agents-developed-with-teamai-cli)

Debug AI agents with teamai-cli using verbose logging, doctor command, and log file analysis. Troubleshoot common issues and ensure seamless agent deployment.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Handle Errors in teamai-cli Agent Executions: A Complete Guide](/tencent/teamai-cli/how-to-handle-errors-in-teamai-cli-agent-executions)

Master error handling in teamai-cli agent executions. Discover the four-layer validation and recovery system for robust and reliable agent operations. Learn to prevent failures.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Set Up Communication Between AI Agents in teamai-cli](/tencent/teamai-cli/how-to-set-up-communication-between-ai-agents-in-teamai-cli)

Learn to set up communication between AI agents in teamai-cli. Discover how teamai-cli facilitates agent interaction through shared repositories and knowledge graphs. Get started today.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Define AI Agent Roles and Permissions in TeamAI-CLI](/tencent/teamai-cli/how-to-define-ai-agent-roles-and-permissions-in-teamai-cli)

Learn to define AI agent roles and permissions in TeamAI-CLI using a YAML manifest. Control access by mapping role IDs to resource namespaces and filtering skills.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Run AI Agent Tasks Using teamai-cli: A Complete Guide](/tencent/teamai-cli/how-to-run-ai-agent-tasks-using-teamai-cli)

Learn to run AI agent tasks with teamai-cli. Initialize, pull resources, and deploy sub-agents to connect with AI tools like Claude and Codex. Get started now.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Manage AI Agents with teamai-cli: Deploy, Configure, and Remove Sub-Agents](/tencent/teamai-cli/how-to-manage-ai-agents-with-teamai-cli)

Easily manage AI agents using teamai-cli. Learn to deploy, configure, and remove sub-agents seamlessly through this powerful command-line tool.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Add an AI Model to a TeamAI‑CLI Project](/tencent/teamai-cli/how-to-add-an-ai-model-to-a-teamai-cli-project)

Integrate any LLM into your TeamAI-CLI project by registering a model manifest and referencing the model ID in your skill configuration. Learn how to add an AI model today.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Configure teamai-cli for a Project: Complete Setup Guide](/tencent/teamai-cli/how-to-configure-teamai-cli-for-a-project)

Configure teamai-cli for your project with our complete setup guide. Easily bind your codebase to a shared team harness for automatic syncing of AI configurations.

- Tags: how-to-guide
- Published: 2026-09-11

### [Complete List of teamai-cli Commands: Developer Reference Guide](/tencent/teamai-cli/what-commands-are-available-in-teamai-cli)

Explore over 40 teamai-cli commands for seamless Team AI workflow management. This developer reference guide covers project init, sync, roles, and knowledge base operations. Get started today!

- Tags: api-reference
- Published: 2026-09-11

### [How to Initialize a New Project with teamai-cli: Complete Setup Guide](/tencent/teamai-cli/how-to-initialize-a-new-project-with-teamai-cli)

Quickly initialize a new project with teamai-cli using teamai init repo-url. This guide details scaffolding your TeamAI project, localizing config, and registering scope and role.

- Tags: how-to-guide
- Published: 2026-09-11

### [Prerequisites for Using teamai-cli: Installation Requirements & Setup Guide](/tencent/teamai-cli/what-are-the-prerequisites-for-using-teamai-cli)

Install teamai-cli easily. Discover the essential prerequisites including Node.js 20 and Git, plus optional CLIs for seamless Git repository management. Get started today.

- Tags: getting-started
- Published: 2026-09-11

### [How to Install teamai‑cli: Complete Setup and Verification Guide](/tencent/teamai-cli/how-to-install-teamai-cli)

Easily install teamai-cli with npm and verify your setup. This guide provides simple steps to get the Tencent TeamAI command-line tool running on your system quickly.

- Tags: how-to-guide
- Published: 2026-09-11