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

# Agent integration

> Make Kestrel Search discoverable to Codex, Claude Code, and GitHub Copilot.

# Agent integration

Kestrel Search can generate a `SKILL.md` that teaches supported coding agents
when and how to use the command.

## Interactive installation

```bash theme={null}
kestrelsearch skill install
```

You will be prompted to choose an agent and whether the skill should be
installed for the current project or globally.

## Install for every supported agent

```bash theme={null}
kestrelsearch skill install --agent all --scope global
```

Supported agents include:

* Codex
* Claude Code
* GitHub Copilot in VS Code

Restart the agent session after installing the skill.

## Use Kestrel from an agent

JSON is the recommended output format:

```bash theme={null}
kestrelsearch search \
  -q "recent Python packaging changes" \
  -q "Python packaging release notes" \
  --time-filter m \
  --top-k 3 \
  --output json
```

Agents can supply every query through repeatable `-q` or `--query` options;
the positional query is optional. Progress is written to stderr, leaving
stdout safe for parsing.

## Remove installed skills

```bash theme={null}
kestrelsearch skill uninstall
```