search

Search indexed Entire history from the CLI. Add --code to search code content instead.

entire search [QUERY] [flags]

entire checkpoint search is an equivalent alias. In CLI versions 0.9.0 and earlier, entire search was hidden from entire --help but remained runnable. 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

entire search "auth token refresh"
entire search "auth token refresh" --repo entireio/cli
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.
`--case-sensitive`	Reserved for future case-sensitive Code Search. Only valid with `--code`; currently does not change backend matching.
`--code`	Search code content across repositories instead of checkpoints, commits, and sessions.
`--date PERIOD`	Filter by time period. Use `week` or `month`.
`--json`	Output as JSON.
`--limit N`	Maximum number of results per page, or total results with `--code`. Default is `10`.
`--page N`	Page number, 1-based. Default is `1`.
`--repo REPOSITORY`	Filter by repository. Accepts `gh/owner/repo`, `et/project/repo`, `owner/repo`, a repository ULID, or `*`; repeatable and comma-separated.

Inline Filters

CLI queries also support inline filters:

entire search "retry logic author:alex date:month branch:main repo:entireio/cli"

Supported inline filters are:

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

Code Search

Use --code to search code content instead of checkpoints, commits, and sessions. Results are grouped under a repo:path heading with line-numbered matches beneath it.

entire search --code "refreshAccessToken"
entire search --code "refreshAccessToken" --repo entireio/cli
entire search --code "repo:* refreshAccessToken"
entire search --code "refreshAccessToken" --json

Code Search matches exact text and is currently case-insensitive. The CLI accepts --case-sensitive, but the search backend does not yet apply it. In --code mode, repo: is the only supported inline filter. The author:, branch:, and date: tokens are treated as literal query text, and the --author, --branch, --date, and --page flags do not apply. In interactive search, press 4 to switch to the Code tab.

Compare semantic and keyword search with literal code search.

Search in the CLI

Use both search modes from your terminal.

Search Past Work and Code

Practice search with a guided tutorial.

​Examples

​Flags

​Inline Filters

​Code Search

​Related Guides

Search