Semantic Search Troubleshooting - Entire
Use this page when Semantic Search cannot find expected checkpoints, sessions, or commits.
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:
- feature names
- user-facing labels
- error messages
- file names
- the decision or behavior you remember
- an author, branch, date, or repo filter
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.