LOKIBAN

Agent Management

From task board to AI command center

🦊
🔍
✍️
📚
⚡
📡
📊
01 / 12

What Lokiban Does Today

✓ Working

  • Kanban board with drag-and-drop lanes
  • Full REST API — capture, move, complete, archive
  • Markdown sync to brain/tasks.md
  • Agent dispatch via heartbeat loop
  • Assignee field on tasks (loki, beacon, pixel…)
  • SQLite + WAL for reliable persistence

⚠ Missing

  • Agents are invisible in the UI
  • No way to see who's working on what
  • Can't view or edit SOUL files from dashboard
  • No agent creation flow
  • No session history or output tracking
  • Dispatch happens in the terminal, not the app
02 / 12

The Vision

Agents become first-class citizens in Lokiban — alongside tasks, not hidden behind them. View, edit, create, and dispatch agents directly from the dashboard.

🎯 See Every Agent

Cards show name, focus, current task, and success rate at a glance.

✏️ Edit SOULs In-App

Click an agent to view and edit their SOUL.md, model preference, and specialization.

🚀 Create New Agents

Add agents with a form — name, focus, SOUL template, model, output directory.

📡 Mission Control

Real-time dispatch view of active sessions, progress, and output links.

03 / 12

Agent Cards

🦊
Loki
Orchestrator
Task Reviewing Beacon output Last Dispatched SEO batch
🔍
Beacon
SEO
Task Building comparison pages Last Schema markup audit
✍️
Pixel
Writer
Task Blog post draft Last Landing page copy
📚
Cass
Research
Task Competitor landscape Last Market sizing report
⚡
Forge
Email
Task Welcome drip sequence Last Cold outreach batch
📡
Radar
Social
Task Twitter thread draft Last Content calendar
📊
Atlas
Analytics
Task Traffic dashboard Last Weekly metrics report
04 / 12

Agent Detail View

Click any agent card to open its full profile.

🔍
Beacon
SEO
Model: kimi-2.5
SOUL.md
Task History
Session Logs
Output
# Beacon — SEO Specialist ## Role SEO engine for the MAMV product portfolio. Builds pages that rank. Runs on Kimi 2.5. ## Capabilities → Programmatic SEO (pSEO) → Keyword Research → Schema Markup → Comparison Pages → Sitemap Optimization
05 / 12

Updated Sidebar

Tasks
📋 Board
📥 Capture
📊 Reports
Agents
🦊 Loki Orchestrator
🔍 Beacon SEO
✍️ Pixel Writer
📚 Cass Research
⚡ Forge Email
📡 Radar Social
📊 Atlas Analytics
+ New Agent

Focus Tags, Not Status

Each agent shows their specialty — SEO, Writer, Research — not idle/working status. You see what they do, not what they're doing right now.

The sidebar becomes a team roster. Click any agent to open their detail view. The + New Agent button opens the creation flow.

Active dispatch status lives in the dedicated Mission Control view (Slide 8) — not cluttering the nav.

06 / 12

Create Agent

How It Works

  • Creates agents/scout/SOUL.md
  • Registers agent in Lokiban's assignee system
  • Start from blank or clone an existing SOUL
  • Set model per agent (Opus for complex, Sonnet for bulk)
  • Auto-creates output directory
  • Agent appears in sidebar immediately
07 / 12

Agent Configuration

One file. Simple UI. The system writes the markdown — the human just fills in the blanks.

Configure Agent — Beacon
Direct, data-driven. Backs every recommendation with search volume and competition data. No fluff.
Haiku Sonnet ✓ Opus
30 min

Simple for Humans

  • Text fields for identity and personality — write naturally
  • Click to select model tier
  • Checkboxes for tool access — no config files
  • Slider for runtime budget
  • System generates the SOUL.md behind the scenes

💡 One file, not five

All config lives in SOUL.md with structured sections. The UI reads/writes it. Power users can edit the markdown directly. Everyone else uses the form.

08 / 12

What Gets Generated

The form builds a structured SOUL.md. Human-readable and machine-parseable.

# Beacon — SEO Specialist ## Identity Name: Beacon Focus: SEO Personality: Direct, data-driven. Backs every recommendation with search volume and competition data. No fluff. ## Model Preferred: claude-sonnet-4 ## Capabilities - [x] Web search - [x] GitHub (read/write repos) - [x] File system (output folder) - [ ] Email (himalaya) - [ ] Messaging (Slack, iMessage) - [ ] Browser automation ## Constraints Max runtime: 30 minutes Output: /output/beacon/ Never publish directly — save to output Never contact Mike — report through Loki ## Instructions Every page needs: title tag, meta desc, canonical URL, OG tags, schema markup. Target keywords with 100+ monthly volume and competition score under 40.

How It Works

  • Form → Markdown: UI writes structured SOUL.md sections from form inputs
  • Checkboxes → Task lists: Capabilities become [x] / [ ] in markdown
  • Slider → Constraint: Runtime slider writes a line in the Constraints section
  • Free text stays free: Personality and instructions are open text — no templates forced

🔄 Two-way sync

Edit in the form → updates SOUL.md. Edit SOUL.md directly → form reflects it. Either workflow works. No lock-in.

🔒 Guardrails built in

Unchecked capabilities = agent can't access those tools. Runtime limits prevent runaway sessions. Constraints section enforces rules during dispatch.

09 / 12

Live Dispatch — Mission Control

🔍 Beacon SEO

Building 12 comparison pages for HTMLDecks

Session: beacon-pseo-0208

8 / 12 pages complete

✍️ Pixel Writer

Writing blog post: "Why HTML Presentations?"

Session: pixel-blog-0208

Draft in progress

📚 Cass Research

Competitor analysis: Slides.com vs Reveal.js

Session: cass-comp-0208

Compiling findings

📡 Radar Social

No active session

Last: Content calendar (2h ago)

10 / 12

Architecture

Lokiban UI

Agent cards, sidebar,
detail views, forms

→

Lokiban API

/api/agents
/api/agents/:id/soul
/api/dispatch

→

Agent SOULs

agents/*/SOUL.md
File system read/write

→

OpenClaw

sessions_spawn()
Sub-agent dispatch

→

Sessions

sessions.json
Progress + output

Data Flow

11 / 12

Implementation Plan

3 phases, 3 days. Ship incrementally.

Phase 1
Day 1

Agent Cards + Sidebar

  • Add /api/agents endpoint — reads agents/ directory
  • Agent card component with avatar, name, focus tag
  • Left sidebar agent list with focus labels
  • Wire up to existing assignee data on tasks
Phase 2
Day 2

Detail View + Edit SOUL

  • Agent detail panel with tabs (SOUL, History, Logs, Output)
  • In-app markdown editor for SOUL.md files
  • Model preference selector
  • Task history pulled from Lokiban's assignee data
Phase 3
Day 3

Create Agent + Dispatch View

  • Create agent form → writes SOUL.md + registers assignee
  • Live dispatch view reading sessions.json
  • Progress tracking and output links
  • Mission control dashboard with real-time updates
12 / 12