dakboard

---
name: dakboard
description: Manage DAKboard screens, devices, and push custom display data.
author: Kristopher Clark
homepage: https://github.com/krisclarkdev/dakboard-skill
files: ["scripts/*"]
metadata:
  clawdbot:
    requires:
      env:
        - DAKBOARD_API_KEY
---

# DAKboard Skill

This skill provides a command-line interface to interact with the DAKboard API. It allows for comprehensive management of devices and screens, and enables pushing custom data for dynamic displays.

## Setup

Before using this skill, you must set your DAKboard API key as an environment variable.

```bash
export DAKBOARD_API_KEY="your_api_key_here"
```

The primary tool for this skill is the Python script located at `scripts/dakboard.py`.

## Available Commands

### 1. List Devices
Retrieves a list of all DAKboard devices (e.g., Raspberry Pis) linked to your account. This is useful for finding the `device_id` needed for other commands.

**Usage:**
```bash
python3 scripts/dakboard.py devices
```

### 2. List Screens
Retrieves a list of all available screen layouts (e.g., "Big Monthly", "Two Column"). This is used to find the `screen_id` needed to change a device's display.

**Usage:**
```bash
python3 scripts/dakboard.py screens
```

### 3. Update Device Screen
Changes the screen layout currently being displayed on a specific device.

**Usage:**
```bash
# Usage: update-device <device_id> <screen_id>
python3 scripts/dakboard.py update-device "dev_0c3e1405a961" "scr_709367acf3d4"
```

### 4. Push Metric
Pushes a single, named data point to a "DAKboard Metrics" block. This is ideal for displaying real-time data like sensor readings or statistics.

**Usage:**
```bash
# Usage: metric <key> <value>
python3 scripts/dakboard.py metric "indoor_temp" "72.5"
```

### 5. Push Fetch Data
Pushes a complete JSON object to a "Fetch" block on a screen. This is for displaying more complex, structured data.

**Usage:**
```bash
# Usage: fetch '<json_string>'
python3 scripts/dakboard.py fetch '{"task