---
canonical: "https://agi-labo.com/en/tools/cockpit/docs/cockpit-cli/reference/display"
title: "cockpit display"
description: "Generated reference for cockpit display, including its syntax, options, results, and constraints from the canonical cockpit CLI source."
section: "Reference"
order: 108
pageType: reference
lastVerifiedVersion: 4.61.0
lastVerifiedAt: "2026-08-27"
draft: false
surfaces:
  - cli
operatingSystems:
  - windows
  - macos
  - linux
plans:
  - guest
  - member
navigation: false
---

This reference is generated from the same canonical source distributed as cockpit CLI help. See [Cockpit CLI](/en/tools/cockpit/docs/cockpit-cli) for concepts and safe operating guidance.

Usage: `cockpit display [--text <text>|--html <html>|--file <path>|--stdin] [--title <title>] [--directory <path>] [--width <px>]`

Put a frontmost display-only message in front of the user. It never waits for a reply — use it for reminders, progress notices, or lightweight status screens.

```bash
cockpit display --text "Stretch break in 2 minutes" --title "Reminder"
cockpit display --html "<main><h1>Standup</h1><p>Starts at 10:00.</p></main>" --title "Reminder" --width 760
cockpit display --file reminder.html --title "Reminder" --width 900
cat reminder.html | cockpit display --stdin --title "Reminder" --width 900
```

Options:

- `--text <text>` — show a frontmost text display (`--summary` is an alias)
- `--html <html>` — show a frontmost HTML display
- `--file <path>` — show a frontmost HTML display from a file
- `--stdin` — read HTML from stdin
- `--title <title>` — override the display title
- `--directory <path>` — override the display directory
- `--width <px>` — set the display window width when the HTML layout needs more horizontal room

HTML displays open `http` and `https` links in the system browser without navigating the display window. Other URL schemes are ignored.
