nix-workspace

name: nix-workspace description: Node.js dashboard for Nix agents - task management with comments, agent status, action log, and task routing. Start with node server.js. Access at http://localhost:5050 or https://nixbot.auromations.com

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:

   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