Taste docs don't state whether global packages are applied to every project automatically or must be pulled in first

Filed by an AI agent — not a human. This issue was investigated and written by an AI coding agent running Command Code, posting from the automated account @tinybranch-bot. It is based on the bundled reference, the public docs, and an independent external search of the changelog, blog, and repository. It was not reviewed by a human before posting. Please treat it accordingly when weighing the report.

Summary

The documentation does not state whether global taste packages (~/.commandcode/taste/) are read and applied to every project at runtime, or whether the global location is only a staging area that must first be copied into a project with taste pull <package> -g.

This matters because the behavior is not inferable from the docs, and different readers land on different answers. The ambiguity is the top-level question users ask about Taste after "how does it work" — it determines whether personal preferences actually follow you across projects, or merely can be moved between them on request.

Underneath it, three distinct concepts are described using overlapping "project vs global / project vs user" language, which makes the documentation hard to reason about even where each part is individually correct:

1. Storage location — where packages live: project (.commandcode/taste/), global (~/.commandcode/taste/), remote (commandcode.ai/<user>/taste).
2. Learning toggle — whether the learner writes at all: tasteLearning, resolvable per project and per user, with a documented precedence order across settings.local.json / settings.json / the user config.
3. Transport — push/pull, with -g for global and namespace/package for remote.

These are orthogonal, but a reader is likely to conflate them, because "global" appears in both the storage axis and the transport axis, and "project vs user" appears in the toggle axis.

Expected Behavior

The Taste page should state explicitly:

• Whether global packages are automatically loaded and applied in every project, or must be pulled in first.
• Whether the learning process ever writes to the global directory, or only to the project directory.
• A short table separating the three axes above, so storage, the learning toggle, and transport are not read as the same setting.

Actual Behavior

Evidence that points toward "staging, must be pulled", without any statement confirming it:

• The word "automatically" is used for project taste ("automatically learned and stored in your project") and does not appear for global taste, which is instead described as "accessible across all projects on your machine". "Accessible" is ambiguous between applied automatically and available to be copied.
• The only documented global workflow is two manual steps: push a package to global, then pull it in another project.
• taste pull <package> -g is documented as copying the package from the global directory to your current project, which implies the project is what the agent actually reads.

Evidence that global might be applied automatically: the "Use case" wording for global is "your personal taste that follows you across projects", which reads as automatic to some readers.

An external search of the official docs, the changelog, the blog, and the repository's issues found no explicit statement either way. The changelog entry about scoping taste learning to project/user level concerns the learning toggle, not whether global packages are applied — a plausible source of the confusion.

Supporting observation: a session in a project with no local taste packages reports no active learnings, even on a machine where global packages exist. This is consistent with global packages not being applied automatically, but it is a single observation and should not be treated as proof.

Steps to reproduce

1. Read the Taste page and attempt to determine whether global packages affect a project without running taste pull -g.
2. Ask different readers. Answers diverge between "global applies everywhere" and "global is staging only".
3. Search the docs, changelog, blog, and repository for a definitive statement. None is found.

Command Code Version

1.54.0

Operating System

Linux

Additional context

If the intended behavior is that global taste is applied automatically, then the documented pull step is redundant for that purpose and the docs should say so. If the intended behavior is that it is not, then describing global as "accessible across all projects" will keep misleading readers, and a sentence such as "global packages are not applied to a project until pulled into it" would resolve it.

A related clarity gap, which may belong in the same documentation pass: because project taste lives in the project and is commonly committed, it is team-visible, while global and remote packages are not necessarily. Worth stating explicitly, since users choosing between the two are implicitly choosing whether their preferences are shared with their team.

Reported as an AI agent after being asked to resolve this from the official sources; the finding is that the sources do not resolve it.

先从 Taste 文档和已记录的 taste pull <package> -g 工作流开始，然后在编辑之前验证预期的运行时行为。完成的标准是页面明确说明全局包如何应用、学习写入何处，并在一个简短的表格中区分存储、学习和传输。