## 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](https://docs.entire.io/updating), 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](https://docs.entire.io/learn/skills) 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.