> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Semantic Search

> Find previous checkpoints, sessions, and commits by phrase, meaning, or agent context.

Semantic Search helps you find the context behind previous agent work without remembering exactly where it happened.

It searches indexed Entire history, including checkpoints, sessions, and commits. Use it when you remember the feature, decision, prompt, bug, file, error text, or general idea, but not the exact checkpoint or session.

## What It Finds

Semantic Search can return:

* [checkpoints](/guides/checkpoints/overview) that captured agent-assisted changes
* sessions with prompts, transcripts, tool activity, and metadata
* commits connected to the captured work

Search combines semantic matching with keyword matching. That means exact phrases can work, but the query can also describe meaning:

```shell theme={null}
entire search "auth token refresh"
entire search "how did we decide whether a mission is ready to launch?"
```

## Where to Search

| Surface                                                                 | Use it when                                                                                         |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [Entire.io](/guides/search/semantic-search/search-in-entire-io)         | You want to browse results visually, open checkpoint details, or move between sessions and commits. |
| [Entire CLI](/guides/search/semantic-search/search-in-cli)              | You are already in the terminal and want quick results for the current repo or a repo filter.       |
| [`search` Skill](/guides/search/semantic-search/search-from-your-agent) | You want your agent to look up relevant history before it starts or while it is investigating.      |

## Before You Search

Semantic Search works best when:

* you are authenticated with `entire login`
* the repository has pushed checkpoints or sessions
* Entire has had time to index the latest pushed work
* your query includes specific feature names, bugs, prompts, files, or decisions

If you want a guided setup, follow [Search Past Agent Work](/learn/search-past-agent-work). The tutorial creates a small project, adds searchable checkpoints, and walks through phrase, meaning, web, agent, and cross-repo searches.

## Continue with

<CardGroup cols={2}>
  <Card title="Search in Entire.io" icon="globe" href="/guides/search/semantic-search/search-in-entire-io">
    Browse semantic search results in the web app.
  </Card>

  <Card title="Search in the CLI" icon="terminal" href="/guides/search/semantic-search/search-in-cli">
    Use `entire search` from your terminal.
  </Card>

  <Card title="Search from Your Agent" icon="bot" href="/guides/search/semantic-search/search-from-your-agent">
    Let an agent search past work with the `search` Skill.
  </Card>

  <Card title="Search Past Agent Work" icon="route" href="/learn/search-past-agent-work">
    Practice semantic search with a guided tutorial.
  </Card>

  <Card title="Semantic Search Troubleshooting" icon="wrench" href="/guides/search/semantic-search/troubleshooting">
    Fix missing results, repo scoping, login, and agent search issues.
  </Card>
</CardGroup>