CoworkStatusBarItem

An app's item in the footer (status bar). Declare it in the app's cowork.json — "statusBar": {"routine": "my-status", "args"?: {…}, "interval"?: 60} — and return this from that routine (null hides it). It refreshes every interval seconds (15–3600) while the window has focus, when focus returns and after a click. A click runs the same routine with click.args (menu: the user picks an entry first; confirm: a modal asks first). data is free-form — for the app's widgets.

Properties

click?

click?: object;

args?

args?: Record<string, unknown>;

confirm?

confirm?: string;

data?

data?: unknown;

icon?

icon?: string;

A codicon id ("remote", "plug"; "sync~spin" spins).

menu?: object[];

args?

args?: Record<string, unknown>;

confirm?

confirm?: string;

label

label: string;

text

text: string;

tone?

tone?: "error" | "warning";

tooltip?: string;