Semantic Search Troubleshooting

`entire search` says you are not authenticated

Run:

entire login

Search only returns repositories and history your account can access.

`entire search` does not appear in `entire --help`

Run the command directly:

entire search --help

If that fails, update Entire from the updating guide, then try again.

Search opens an interactive view when you expected plain output

Use --json for scripts, automation, or agent instructions:

entire search "auth token refresh" --json

Running entire search without --json can open an interactive results table when stdout is a terminal.

You do not see recent work

Confirm the work has been committed and pushed, then give Entire a couple minutes to index it.Check that the current repository is Entire-enabled:

entire status

If the work happened in another repository, pass a repo filter:

entire search "auth token refresh" --repo OWNER/REPO

Search returns results from the wrong scope

CLI search is scoped to the current repository by default.To search one specific repository:

entire search "retry logic" --repo OWNER/REPO

To search across all accessible repositories:

entire search "retry logic" --all-repos

You can also use the inline filter:

entire search "repo:* retry logic"

The query is too broad

Add details that would have appeared in the prompt, commit, transcript, or files:

Example:

entire search "duplicate validation error banner" branch:main date:month

The search Skill returns no useful history

Confirm the project has the Skills workflow installed and that the agent can run entire search --json.Then make the prompt more specific:

search past work for duplicate validation in the checkout form

If the agent says authentication is missing, run entire login in the same environment where the agent runs.

Semantic Search

Learn what Semantic Search finds and where to use it.

Practice semantic search with known checkpoints and queries.