# `bird docs`

## Usage

```bash
bird docs
```

## Description

Search the public Bird documentation from the command line.

search takes a query and returns the most relevant documentation sections as
JSON, each with a deep link and a markdown_url for the full page. No
authentication is required.

Snippets are previews, not answers. Pick the one or two results that match, then
fetch their markdown_url to read the whole page and answer from that; don't try
to read every result in full. When answering, consider delegating the read to a
subagent (if your tooling supports it) so your own context stays focused on the
task.

## Commands

| Name                                        | Description               |
| ------------------------------------------- | ------------------------- |
| [`read`](/docs/cli/reference/docs-read)     | Read a documentation page |
| [`search`](/docs/cli/reference/docs-search) | Search documentation      |