> ## 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.

# search

> Search checkpoints, commits, and sessions with hybrid semantic and keyword matching.

Search indexed Entire history from the CLI.

```bash theme={null}
entire search [QUERY] [flags]
```

By default, search is scoped to the current repository. Use `--repo`, `--all-repos`, or `repo:*` to change the scope.

Run without arguments to open interactive search. Use `--json` for machine-readable output.

## Examples

```bash theme={null}
entire search "auth token refresh"
entire search "auth token refresh" --repo entirehq/entiredb
entire search "repo:* auth token refresh"
entire search "retry logic" author:alex branch:main date:month
entire search "auth token refresh" --json
```

## Flags

| Flag                | Description                                                                |
| ------------------- | -------------------------------------------------------------------------- |
| `--all-repos`       | Search all accessible repositories instead of only the current repository. |
| `--author NAME`     | Filter by author name.                                                     |
| `--branch NAME`     | Filter by branch name.                                                     |
| `--date PERIOD`     | Filter by time period. Use `week` or `month`.                              |
| `--json`            | Output as JSON.                                                            |
| `--limit N`         | Maximum number of results per page. Default is `10`.                       |
| `--page N`          | Page number, 1-based. Default is `1`.                                      |
| `--repo OWNER/REPO` | Filter by repository. Use `'*'` to search all accessible repositories.     |

## Inline Filters

CLI queries also support inline filters:

```bash theme={null}
entire search "retry logic author:alex date:month branch:main repo:entirehq/entiredb"
```

Supported inline filters are:

* `author:NAME`
* `date:week|month`
* `branch:NAME`
* `repo:OWNER/NAME`
* `repo:*`

## Related Guides

<CardGroup cols={2}>
  <Card title="Semantic Search" icon="sparkles" href="/guides/search/semantic-search/overview">
    Learn what `entire search` finds and when to use it.
  </Card>

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