teamai.yaml Configuration Options for Recall and Sharing Hints

The teamai.yaml file defines team-wide defaults for automatic knowledge retrieval and post-session sharing prompts via the sharing.recall.enabled and sharing.contributeHint.enabled keys.

In the Tencent/teamai-cli repository, these configuration options govern whether the CLI automatically recalls team knowledge before executing tasks and whether it displays hints encouraging users to share learnings after a session. Understanding these settings allows teams to standardize behavior across development environments while preserving individual override capabilities.

Configuration Hierarchy

The CLI implements a three-tier configuration system. Team defaults live in teamai.yaml at the repository root, individual developers can override these in ~/.teamai/config.yaml, and environment variables provide emergency bypasses. This hierarchy ensures that team standards apply by default, but individual workflows remain customizable.

Recall Configuration Options

sharing.recall.enabled controls the automatic knowledge-recall subsystem. When set to true, the CLI deploys a recall sub-agent that retrieves relevant team knowledge before task execution. When false or omitted, recall remains inactive.

According to the documentation in docs/usage-guide.md, the default value is false (Line 825).

Individual developers can override this team default using the recallEnabled key in their personal ~/.teamai/config.yaml file. This user-level setting takes precedence regardless of the team configuration. Additionally, setting the TEAMAI_RECALL_DISABLED=1 environment variable force-disables recall for the current shell session, acting as an emergency kill-switch that ignores all configuration file values.

Sharing Hints Configuration Options

sharing.contributeHint.enabled manages the "share-learning" hint displayed after CLI sessions. This hint lists friction signals and prompts users to contribute knowledge back to the team index. The default value is true, meaning hints appear automatically unless explicitly disabled.

This default is documented in docs/usage-guide.md (Line 799) and summarized in README.md (Line 169).

To suppress these prompts locally, developers set contributeHintEnabled: false in ~/.teamai/config.yaml. Like the recall override, this user-level setting takes priority over the team default, though it leaves the underlying stop-hook behavior intact for other operations.

Practical Configuration Examples

Configure team-wide defaults in teamai.yaml:

sharing:
  recall:
    enabled: true               # Enable automatic knowledge retrieval for all team members

  contributeHint:
    enabled: false              # Suppress the share-learning prompt globally

Override these settings for an individual machine in ~/.teamai/config.yaml:

recallEnabled: false            # Disable recall locally despite team default

contributeHintEnabled: true     # Enable hints locally despite team default

Disable recall immediately via shell environment:

export TEAMAI_RECALL_DISABLED=1
teamai query "example task"

Summary

• sharing.recall.enabled in teamai.yaml defaults to false and controls automatic knowledge retrieval for the entire team.
• sharing.contributeHint.enabled in teamai.yaml defaults to true and manages post-session sharing hints.
• User overrides in ~/.teamai/config.yaml use the keys recallEnabled and contributeHintEnabled, which take precedence over team defaults.
• The environment variable TEAMAI_RECALL_DISABLED=1 provides an immediate, process-level bypass for recall functionality.

Frequently Asked Questions

What is the default value for recall in teamai.yaml?

The default value is false. As documented in the usage guide, recall is opt-in at the team level, requiring explicit enabling via sharing.recall.enabled: true in the team configuration file.

How do I disable recall for my local machine only?

Add recallEnabled: false to your ~/.teamai/config.yaml file. This user-level override takes priority over the team default without affecting other team members' environments.

Can I disable the contribute hint while keeping recall enabled?

Yes. Set sharing.contributeHint.enabled: false in teamai.yaml while keeping sharing.recall.enabled: true. Alternatively, use the user override contributeHintEnabled: false in your personal config to disable hints locally while the team retains the default enabled state.

What happens if I set TEAMAI_RECALL_DISABLED=1?

This environment variable acts as a kill-switch that force-disables all recall hooks for the current process, overriding both team defaults and user configuration files. It is useful for debugging or emergency scenarios where recall behavior must be immediately suspended.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}