autonomous-desk

# Autonomous Thinking Desk Display for Claude Code

Turn your [Thinking Desk](https://www.autonomous.ai/standing-desks/autonomous-desk-5-ai) into a live Claude Code companion. Task-done notifications and usage data appear on your desk display — no dashboard, no browser, just a glance.

https://github.com/user-attachments/assets/c036cb38-f9d6-42e8-8b66-5a09e0e77de2

## Quick Start

```bash
claude plugins marketplace add https://github.com/autonomous-ai/autonomous-desk
claude plugins install thinking-desk
```

Restart Claude Code, then type `pair my display` and follow the on-screen instructions.

> **After connecting your desk, update the firmware to the latest version** (via the Thinking Desk mobile app) to make sure the display works correctly.

See the full [Setup Guide](GUIDE.md) for details.

## Features

- **Task done + usage display** — when Claude completes a task, shows a "Task Done" notification followed by 5-hour and 7-day usage
- **Waiting-on-you ping** — when Claude needs your approval (a yes/no prompt or an MCP form), the display pings with a distinct buzzer (triple_ping) so you don't miss it while away from the keyboard. Idle "waiting for your next prompt" notices are ignored, so it only fires when there's actually something to act on
- **Builder insights** — analyze your local Claude Code sessions on-device and rotate a builder profile (archetype, peak hour, top model, go-to prompt, style) across the display. Everything is computed locally — nothing leaves your machine
- **Notifications** — send custom messages to the screen ("notify my display when done")
- **OTP pairing** — no sticker reading, just enter the code shown on screen
- **Auto-reconnect** — if your router hands the display a new IP, the hooks rescan the LAN, update the saved address, and retry; if it still can't be reached they warn you right in Claude
- **Zero dependencies** — Python 3 stdlib only, no pip install needed

## Commands

| Command | Description |
|---------|-------------|
| `/thinking-desk:usage` | Refresh usage display now |
| `/thinking-desk:insights` | Analyze local sessions, rotate builder profile on display |
| `/thinking-desk:notify` | Send a notification |

Or use natural language: "show my usage on display", "notify my display", "unpair my display"

## Turning notifications on/off

You don't always want the buzzer. Just tell Claude in plain language — it edits `~/.config/autonomous-lcd.json` for you (no restart needed):

- "mute the display" → keep the cards, silence the buzzer
- "stop the task done notification" → no more "Task Done" card
- "stop pinging me for approval" → no more "Claude needs you" ping
- "turn everything back on" → re-enable all

The flags (all default `true`):

| Key | Controls |
|-----|----------|
| `sounds_enabled` | Master buzzer. `false` = cards show silently |
| `task_done_enabled` | The "Task Done" card after each response |
| `notify_enabled` | The waiting-on-you ping (tool approval / MCP form) |
| `update_check_enabled` | The silent "Update available" card (≤ once/day) |
| `device_warning_enabled` | The in-Claude warning when the display can't be reached |

## Requirements

- macOS
- Python 3
- A Thinking Desk device on the same WiFi
- Claude Code with OAuth login

## Update

The plugin does **not** update itself when you restart Claude Code. You get new versions one of two ways:

**Auto-update (recommended)** — turn it on once, then every new version installs on the next launch:

```
/plugin
→ Marketplaces → autonomous-desk → Enable auto-update
```

**Manual** — pull the latest right now:

```bash
claude plugins update thinking-desk@autonomous-desk
```

Restart Claude Code after updating.

> Note: the marketplace is named `autonomous-desk`, so the reference is `thinking-desk@autonomous-desk` (plugin@marketplace).

## Already using `vibe-desk-display`?

This plugin used to be called `vibe-desk-display`. If you still have that
version installed, remove it — otherwise the desk hook fires twice and
you get duplicate cards and buzzes:

```bash
claude plugin uninstall vibe-desk-display
```

Your paired display and settings carry over; only the slash-command prefix
changes to `/thinking-desk:`.

## Uninstall

```bash
claude plugins uninstall thinking-desk
```