<!-- GENERATED by scripts/build-docs.mjs from the live Commander tree (src/cli/program.ts). Do not edit by hand. -->

# pai observation

> Observation capture: list, search, and stats

## Synopsis

```
pai observation <subcommand> [options]
```

## Subcommands

| Command | Description |
|---------|-------------|
| [`pai observation list`](#pai-observation-list) | List recent observations |
| [`pai observation search <query>`](#pai-observation-search-query) | Search observations by title or narrative text |
| [`pai observation stats`](#pai-observation-stats) | Show observation statistics: totals, by type, by project |

### pai observation list

List recent observations

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--project <slug>` | Filter by project slug |  |
| `--type <type>` | Filter by type (decision, bugfix, feature, refactor, discovery, change) |  |
| `--session <id>` | Filter by session ID |  |
| `--limit <n>` | Maximum results | `20` |


### pai observation search <query>

Search observations by title or narrative text

**Arguments**

| Argument | Kind |
|----------|------|
| `<query>` | required |

**Options**

| Option | Description | Default |
|--------|-------------|---------|
| `--project <slug>` | Filter by project slug |  |
| `--type <type>` | Filter by type |  |
| `--limit <n>` | Maximum results | `20` |


### pai observation stats

Show observation statistics: totals, by type, by project


## Examples

```bash
# Recent classified tool-call observations
pai observation list

# Only this project's decisions
pai observation list --project pai --type decision

# Search observations by text
pai observation search "daemon socket"

# Totals, by type, by project
pai observation stats
```

## See also

[`pai audit`](audit.md) · [`pai backup`](backup.md) · [`pai clear-names`](clear-names.md) · [`pai config`](config.md) · [`pai daemon`](daemon.md) · [`pai db`](db.md) · [`pai end`](end.md) · [`pai help`](help.md) · [`pai identity`](identity.md) · [`pai kg`](kg.md) · [`pai launch`](launch.md) · [`pai mcp`](mcp.md) · [`pai memory`](memory.md) · [`pai notify`](notify.md) · [`pai obsidian`](obsidian.md) · [`pai pause`](pause.md) · [`pai project`](project.md) · [`pai projects`](projects.md) · [`pai registry`](registry.md) · [`pai restore`](restore.md) · [`pai session`](session.md) · [`pai sessions`](sessions.md) · [`pai setup`](setup.md) · [`pai shell-init`](shell-init.md) · [`pai skill`](skill.md) · [`pai task`](task.md) · [`pai topic`](topic.md) · [`pai update`](update.md) · [`pai worker`](worker.md) · [`pai zettel`](zettel.md)

Run `pai help <area>` to read any of these in the terminal.