Sending Updates

The send command is the main way to push content from your terminal. It supports plain text, styled blocks, panel targeting, and piping JSON from stdin.

Basic text

Pass text directly as arguments:

pushtodisplay send -b <board-id> "Deploy completed"

Multiple text arguments become separate blocks:

pushtodisplay send -b <board-id> "Line one" "Line two" "Line three"

Styling text

Apply styles to all text blocks with flags:

pushtodisplay send -b <board-id> \
  --size large \
  --weight bold \
  --color "#E8FFF6" \
  --background "#0A4A36" \
  "Deploy completed"

Available style flags

Flag	Values	Description
`-s, --size`	`small`, `medium`, `large`	Text size
`-w, --weight`	`regular`, `semibold`, `bold`	Font weight
`-c, --color`	Hex color (`#RRGGBB`)	Text color
`--background`	Hex color (`#RRGGBB`)	Panel or block background

Panel targeting

Target a specific panel within the board's layout:

pushtodisplay send -b <board-id> --panel 2 "Right panel content"

Use --full-panel to make content fill the entire panel area:

pushtodisplay send -b <board-id> --panel 1 --full-panel "Big message"

Panel options

Flag	Values	Description
`-p, --panel`	`1`–`4`	Target panel number
`--full-panel`	—	Fill the entire panel area
`--density`	`compact`, `standard`, `spacious`	Content spacing
`--align-x`	`start`, `center`, `end`	Horizontal alignment
`--align-y`	`start`, `center`, `end`	Vertical alignment

Styled blocks (JSON)

For per-block styling, use --block with a JSON object. You can repeat --block for multiple blocks:

pushtodisplay send -b <board-id> \
  --block '{"text": "Deploy completed", "size": "large", "weight": "bold", "color": "#E8FFF6"}' \
  --block '{"text": "Queue: 12 | Escalations: 0", "size": "small", "color": "#061A13"}'

Each block must include a text field. All other fields are optional.

Piping from stdin

For full control over the request, pipe a complete JSON payload:

echo '{
  "boardId": "<board-id>",
  "panelId": 1,
  "density": "compact",
  "blocks": [
    { "text": "Build #4821", "weight": "bold" },
    { "text": "Status: passed", "color": "#22C55E" }
  ]
}' | pushtodisplay send --stdin

The stdin JSON uses the same fields as the HTTP API request body.

Stdin mode is useful for scripts that build the payload dynamically — for example, formatting test results or pulling data from another API.

Default board

If you set a default board, you can skip the -b flag:

pushtodisplay send "Hello!"

You can set a default board through the mobile app or via the MCP server.

Examples

Deploy notification

pushtodisplay send -b ops-board \
  --size large --weight bold --color "#22C55E" \
  "v3.8.1 deployed to production"

Multi-line status

pushtodisplay send -b ops-board \
  --block '{"text":"API Health","size":"large","weight":"bold"}' \
  --block '{"text":"Uptime: 99.97%","color":"#22C55E"}' \
  --block '{"text":"Latency: 42ms","color":"#94A3B8"}'

Script output to display

echo "$(date): Build $(git rev-parse --short HEAD) complete" \
  | xargs pushtodisplay send -b ops-board