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

# How do I search a project feed from the CLI?

> Use pz feed search with a project ID and query to search the full Paperzilla project feed from the terminal.

export const AiAgents = ({path}) => <Tip>
    <b>AI agents</b>: This page is available as <a href={path + '.md'}>markdown</a>. See also the <a href="/llms.txt">docs index</a> and <a href="/llms-full.txt">full docs</a>.
  </Tip>;

<AiAgents path="/answers/how-do-i-search-a-project-feed-from-the-cli" />

Use `pz feed search`.

If you do not know the project ID yet, get it first:

```bash theme={null}
pz project list
```

For scripts and AI agents, `pz project list --json` returns a compact summary array with `id`, `name`, `mode`, and `visibility`.

Then search the full feed for one project:

```bash theme={null}
pz feed search --project-id <project-id> --query "latent retrieval"
```

Useful examples:

```bash theme={null}
# Prefix matching
pz feed search --project-id <project-id> --query "Proxi"

# Only Must Read papers
pz feed search --project-id <project-id> --query "retrieval" --must-read

# Only starred papers
pz feed search --project-id <project-id> --query "retrieval" --feedback-filter starred

# JSON output for scripting
pz feed search --project-id <project-id> --query "latent retrieval" --json
```

Notes:

* search covers the full project feed, not just already loaded browse pages
* search is rank-first
* query terms use prefix matching
* the JSON envelope includes `items`, `limit`, `offset`, `has_more`, and `query`

See [CLI guide](/guides/cli) for the full command reference.
