用途

cli 是 Push To Display 的命令行界面与 MCP 服务器，用于把终端或 AI 智能体产生的实时更新推送到显示看板。配合 iOS 与 Android 上的 Push To Display 应用，可将任意屏幕变成实时显示看板。

主要能力

向看板发送显示更新，可通过 -b 指定看板，未指定时使用默认看板。
支持创建选项，可生成多面板布局，例如区域状态一览、带 CI/CD 流水线与基础设施日志的多面板、带颜色编码严重程度的事件时间线等。
任意命令添加 --json 可获得机器可读输出。
内置 Model Context Protocol（MCP）服务器，让 AI 客户端（Claude、Cursor、VS Code Copilot 等）直接访问看板。支持 stdio 传输的任意 MCP 客户端均可使用，服务器命令为命令行的相应入口。
提供可用 MCP 工具与命令一览。

直接运行（无需安装）：使用 npx。全局安装：使用相应的 npm 安装命令。要求 Node.js 18+。

浏览器登录（默认）：打开浏览器，登录后 CLI 自动接收凭据。
设备代码登录（无头）：适用于无浏览器的机器，如 SSH 会话、容器或远程服务器；CLI 打印 URL 和一次性代码，在任意设备打开 URL、输入代码并批准登录。凭据存储在操作系统钥匙串（macOS Keychain、Linux libsecret、Windows Credential Manager）。若钥匙串不可用，则回退到 ~/.config/pushtodisplay/。

auth status 报告有效认证状态：当有效的刷新令牌可透明续期时，即使访问令牌已过期仍会报告为已认证，并显示“will refresh automatically”而非原始令牌过期时间。已认证时退出码为 0，未认证时为 1，因此可用于脚本门控。

MCP 服务器继承 CLI 会话：若已运行 pushtodisplay auth login，则自动认证。配置解析顺序：环境变量 → 配置文件 → 默认值。

MCP 客户端配置示例：

Claude：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。
Cursor：打开 Settings → MCP Servers → Add Server，或编辑 .cursor/mcp.json。
VS Code：添加到 .vscode/mcp.json。

API 密钥认证：适用于无法交互登录的 CI/CD 流水线和脚本。可从移动应用或 Web 门户创建，密钥以 pt_ 开头。注意：API 密钥认证仅支持 send 命令；完整访问看板、设备和配置管理需使用 auth login。