Nix Workspace Dashboard

A lightweight Node.js dashboard for managing Nix agents and tasks.

Features

• •Kanban Board: Tasks with To Do → In Progress → Done columns
• •Comments System: AI comments on tasks with completion notes
• •Task Routing: Tasks moved to in_progress auto-route to main agent
• •Agent Status: View all configured agents and their models
• •Action Log: Track all dashboard activity
• •Notes: Leave instructions for agents (checked on heartbeats)

Quick Start

cd /data/workspace/skills/nix-workspace/src
npm install  # first time only
node server.js

Dashboard runs at:

• •Local: http://localhost:5050
• •Public: https://nixbot.auromations.com (via Cloudflare tunnel)

API Endpoints

Tasks

Comments

Comment types: note, completion, update

# Add comment
curl -X POST http://localhost:5050/api/tasks/TASK_ID/comments \
  -H "Content-Type: application/json" \
  -d '{"text":"Working on it...","author":"Nix","type":"note"}'

# Complete with summary
curl -X POST http://localhost:5050/api/tasks/TASK_ID/complete \
  -H "Content-Type: application/json" \
  -d '{"summary":"Task completed successfully","author":"Nix"}'

Other

Task Routing

When a task is moved to in_progress, the dashboard automatically sends a system event to agent:main:main via webhook. This ensures tasks are executed by the main agent which has access to all channels (Telegram, WhatsApp, etc).

The system event includes:

• •Task title and description
• •Task ID for completion tracking
• •Instructions for marking done and adding comments

Agent Integration

Heartbeat Checks

Add to HEARTBEAT.md:

## Dashboard Tasks
Check http://localhost:5050/api/tasks for in_progress items.
Complete with: curl -X POST http://localhost:5050/api/tasks/ID/complete -d '{"summary":"..."}'

Completion Flow

1. •Task created in dashboard → appears in "To Do"
2. •User moves to "In Progress" → routed to main agent
3. •Agent works on task
4. •Agent marks complete with summary:
   bash

   curl -X POST http://localhost:5050/api/tasks/ID/complete \
     -H "Content-Type: application/json" \
     -d '{"summary":"Sent email successfully","author":"Nix"}'
   

Configuration

Dashboard reads from /data/.clawdbot/openclaw.json:

• •gateway.auth.token - For API calls
• •hooks.token - For webhook notifications
• •agents.list - Agent names and models

Files

src/
├── server.js          # Express backend
├── data/
│   ├── tasks.json     # Tasks with comments
│   ├── notes.json     # Notes for agent
│   └── action_log.json
├── static/
│   ├── css/style.css
│   └── js/dashboard.js
└── templates/
    └── index.html

Environment Variables

Security

• •No auth by default - run on trusted networks
• •Public access via Cloudflare tunnel (nixbot.auromations.com)
• •Don't expose directly to internet without authentication