# 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?

```ts
click?: object;
```

#### args?

```ts
args?: Record<string, unknown>;
```

#### confirm?

```ts
confirm?: string;
```

***

### data?

```ts
data?: unknown;
```

***

### icon?

```ts
icon?: string;
```

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

***

### menu?

```ts
menu?: object[];
```

#### args?

```ts
args?: Record<string, unknown>;
```

#### confirm?

```ts
confirm?: string;
```

#### label

```ts
label: string;
```

***

### text

```ts
text: string;
```

***

### tone?

```ts
tone?: "error" | "warning";
```

***

### tooltip?

```ts
tooltip?: string;
```