# teamai.yaml Configuration Options for Recall and 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.

- Repository: [Tencent/teamai-cli](https://github.com/tencent/teamai-cli)
- Tags: api-reference
- Published: 2026-09-11

---

**The [`teamai.yaml`](https://github.com/Tencent/teamai-cli/blob/main/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`](https://github.com/Tencent/teamai-cli/blob/main/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`](https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.md), the default value is `false` ([Line 825](https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.md#L825)).

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`](https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.md) ([Line 799](https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.md#L799)) and summarized in [`README.md`](https://github.com/Tencent/teamai-cli/blob/main/README.md) ([Line 169](https://github.com/Tencent/teamai-cli/blob/main/README.md#L169)).

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`](https://github.com/Tencent/teamai-cli/blob/main/teamai.yaml):

```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`:

```yaml
recallEnabled: false            # Disable recall locally despite team default

contributeHintEnabled: true     # Enable hints locally despite team default

```

Disable recall immediately via shell environment:

```bash
export TEAMAI_RECALL_DISABLED=1
teamai query "example task"

```

## Summary

- **`sharing.recall.enabled`** in [`teamai.yaml`](https://github.com/Tencent/teamai-cli/blob/main/teamai.yaml) defaults to `false` and controls automatic knowledge retrieval for the entire team.
- **`sharing.contributeHint.enabled`** in [`teamai.yaml`](https://github.com/Tencent/teamai-cli/blob/main/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`](https://github.com/Tencent/teamai-cli/blob/main/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.