Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

canvas

/canvas

Wyświetla i steruje treścią HTML na podłączonych węzłach Bitterbot (Mac, iOS, Android) przez serwer canvas: gry, wizualizacje, panele, nawigacja po URL, zrzuty i diagnostyka połączenia.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
7
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wyświetla i steruje treścią HTML na podłączonych węzłach Bitterbot (Mac, iOS, Android) przez serwer canvas: gry, wizualizacje, panele, nawigacja po URL, zrzuty i diagnostyka połączenia.

Oryginalny opis (EN)

Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server. Use when presenting games, visualizations, dashboards, or interactive demos on a connected device, navigating canvas URLs, capturing canvas snapshots, or debugging canvas connectivity.

Jak działa

  1. Overview
  2. How It Works
  3. Actions
  4. Configuration
  5. Workflow
  6. Debugging
  7. URL Path Structure
  8. Tips
Sekcje z nagłówków SKILL.md, w oryginale · 200 linii, 671 słów
Podgląd SKILL.md
---
name: canvas
description: "Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server. Use when presenting games, visualizations, dashboards, or interactive demos on a connected device, navigating canvas URLs, capturing canvas snapshots, or debugging canvas connectivity."
metadata: { "bitterbot": { "emoji": "🖼️", "requires": { "config": ["canvasHost.enabled"] } } }
---

# Canvas

Display HTML content on connected Bitterbot nodes (Mac app, iOS, Android).

## Overview

The canvas tool lets you present web content on any connected node's canvas view. Great for:

- Displaying games, visualizations, dashboards
- Showing generated HTML content
- Interactive demos

## How It Works

### Architecture

```
┌─────────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Canvas Host    │────▶│   Node Bridge    │────▶│  Node App   │
│  (HTTP Server)  │     │  (TCP Server)    │     │ (Mac/iOS/   │
│  Port 18793     │     │  Port 18790      │     │  Android)   │
└─────────────────┘     └──────────────────┘     └─────────────┘
```

1. **Canvas Host Server**: Serves static HTML/CSS/JS files from `canvasHost.root` directory
2. **Node Bridge**: Communicates canvas URLs to connected nodes
3. **Node Apps**: Render the content in a WebView

### Tailscale Integration

The canvas host server binds based on `gateway.bind` setting:

| Bind Mode  | Server Binds To     | Canvas URL Uses            |
| ---------- | ------------------- | -------------------------- |
| `loopback` | 127.0.0.1           | localhost (local only)     |
| `lan`      | LAN interface       | LAN IP address             |
| `tailnet`  | Tailscale interface | Tailscale hostname         |
| `auto`     | Best available      | Tailscale > LAN > loopback |

**Key insight:** The `canvasHostHostForBridge` is derived from `bridgeHost`. When bound to Tailscale, nodes receive URLs like:

```
http://<tailscale-hostname>:18793/__bitterbot__/canvas/<file>.html
```

This is why localhost URLs don't work - the node receives the Tailscale hostname from the bridge!

## Actions

| Action     | Description                          |
| ---------- | ------------------------------------ |
| `present`  | Show canvas with optional target URL |
| `hide`     | Hide the canvas                      |
| `navigate` | Navigate to a new URL                |
| `eval`     | Execute JavaScript in the canvas     |
| `snapshot` | Capture screenshot of canvas         |

## Configuration

In `~/.bitterbot/bitterbot.json`:

```json
{
  "canvasHost": {
    "enabled": true,
    "port": 18793,
    "root": "/Users/you/bitterbot/canvas",
    "liveReload": true
  },
  "gateway": {
    "bind": "auto"
  }
}
```

### Live Reload

When `liveReload: true` (default), the canvas host:

- Watches the root directory for changes (via chokidar)
- Injects a WebSocket client into HTML files
- Automatically reloads connected canvases when files change

Great for development!

## Workflow

### 1. Create HTML content

Place files in the canvas root directory (default `~/bitterbot/canvas/`):

```bash
cat > ~/bitterbot/canvas/my-game.html << 'HTML'
<!DOCTYPE html>
<html>
<head><title>My Game</title></head>
<body>
  <h1>Hello Canvas!</h1>
</body>
</html>
HTML
```

### 2. Find your canvas host URL

Check how your gateway is bound:

```bash
cat ~/.bitterbot/bitterbot.json | jq '.gateway.bind'
```

Then construct the URL:

- **loopback**: `http://127.0.0.1:18793/__bitterbot__/canvas/<file>.html`
- **lan/tailnet/auto**: `http://<hostname>:18793/__bitterbot__/canvas/<file>.html`

Find your Tailscale hostname:

```bash
tailscale status --json | jq -r '.Self.DNSName' | sed 's/\.$//'
```

### 3. Find connected nodes

```bash
bitterbot nodes list
```

Look for Mac/iOS/Android nodes with canvas capability.

### 4. Present content

```
canvas action:present node:<node-id> target:<full-url>
```

**Example:**

```
canvas action:present node:mac-63599bc4-b54d-4392-9048-b97abd58343a target:http://peters-mac-studio-1.sheep-coho.ts.net:18793/__bitterbot__/canvas/snake.html
```

### 5. Navigate, snapshot, or hide

```
canvas action:navigate node:<node-id> url:<new-url>
canvas action:snapshot node:<node-id>
canvas action:hide node:<node-id>
```

## Debugging

### White screen / content not loading

**Cause:** URL mismatch between server bind and node expectation.

**Debug steps:**

1. Check server bind: `cat ~/.bitterbot/bitterbot.json | jq '.gateway.bind'`
2. Check what port canvas is on: `lsof -i :18793`
3. Test URL directly: `curl http://<hostname>:18793/__bitterbot__/canvas/<file>.html`

**Solution:** Use the full hostname matching your bind mode, not localhost.

### "node required" error

Always specify `node:<node-id>` parameter.

### "node not connected" error

Node is offline. Use `bitterbot nodes list` to find online nodes.

### Content not updating

If live reload isn't working:

1. Check `liveReload: true` in config
2. Ensure file is in the canvas root directory
3. Check for watcher errors in logs

## URL Path Structure

The canvas host serves from `/__bitterbot__/canvas/` prefix:

```
http://<host>:18793/__bitterbot__/canvas/index.html  → ~/bitterbot/canvas/index.html
http://<host>:18793/__bitterbot__/canvas/games/snake.html → ~/bitterbot/canvas/games/snake.html
```

The `/__bitterbot__/canvas/` prefix is defined by `CANVAS_HOST_PATH` constant.

## Tips

- Keep HTML self-contained (inline CSS/JS) for best results
- Use the default index.html as a test page (has bridge diagnostics)
- The canvas persists until you `hide` it or navigate away
- Live reload makes development fast - just save and it updates!
- A2UI JSON push is WIP - use HTML files for now

Wersje

RepozytoriumWynikLicencja
Ta strona · bitterbot-ai/bitterbot-desktop100MIT
nimbalyst/nimbalyst100MIT
leeguooooo/chrome-use100Apache-2.0
fogelman/local-design-canvas100MIT
kensaurus/cursor-kenji100MIT
agricidaniel/claude-obsidian100MIT
kansoku-trade/kansoku100AGPL-3.0
spinabot/brigade100MIT
grtninja/skill-arbiter100MIT

Migawka bazy z 13.11.2026 · wersja paczki 99235b3d7bde (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90agent-device
    Automatyzuje interakcje z aplikacjami na platformach Apple (iOS, tvOS, macOS) i urządzeniami Android: nawigacja, zrzuty, dotknięcia, pisanie, przewijanie i wyciąganie informacji z interfejsu.
  • 100pr-review-canvas
    Zamienia przegląd PR w artefakt Cursor Canvas albo stronę HTML na localhost, z ryzykownymi fragmentami na początku.
  • 90json-canvas
    Tworzy, wdraża lub sprawdza prace z JSON Canvas z kontrolą formatu, dostępności, wydajności i wizualnej weryfikacji.
  • 91agent-device
    Automatyzuje aplikacje na iOS, tvOS, macOS, Androidzie, Android TV, Fire TV i Vega OS: nawigacja, zrzuty ekranu, pilot TV, pisanie, przewijanie i zbieranie dowodów.
  • 100infopath-to-canvas
    Przenosi formularz Microsoft InfoPath (.xsn) do aplikacji Canvas w Power Apps, gdy trzeba odejść od InfoPath.
  • 100pr-review-canvas
    Renderuje review PR jako artefakt Cursor Canvas lub samodzielną stronę HTML serwowaną na localhost, z ryzykownymi fragmentami diffu wysuniętymi na pierwszy plan.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.