# Terminal:Terminal Automation

**Page:** api/terminal-terminal-automation

[Download Raw Markdown](./api/terminal-terminal-automation.md)

---

## API Endpoints Summary

- **GET** `/api/v1/terminal/snapshot` — Get rendered terminal snapshot
- **GET** `/api/v1/terminal/find` — Search terminal screen with regex
- **POST** `/api/v1/terminal/press` — Send named key presses to terminal
- **POST** `/api/v1/terminal/paste` — Paste text into terminal
- **POST** `/api/v1/terminal/wait` — Wait for terminal condition
- **GET** `/api/v1/terminal/automation/metrics` — Get terminal automation metrics
- **GET** `/api/v1/terminal/keys` — List supported key names for /press endpoint
- **GET** `/api/v1/terminal/{terminal_id}/automation` — Get per-session automation state

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```