Skip to main content

Console Basics

The SO1 console at console.so1.io is your main interface for seeing what’s happening across the agent council and automation workflows.

Logging In

  1. Go to console.so1.io
  2. Sign in with your Clerk account (email + password or SSO)
  3. You’ll land on the Dashboard

Main Pages

Agents (/agents)

Shows all 8 Zoid council agents as cards. What you see on each card:
  • Agent name, emoji, and role
  • Domain tags (what they handle)
  • Workflow count (how many automations are linked)
  • Who they consult
Click “Details” to see:
  • Full description and domains
  • Linked runbooks (operational guides for that agent)
  • Linked workflows (automations this agent powers)
  • A “Run” button to trigger any linked workflow

Workflows (/workflows)

Lists all n8n automation workflows. What you see:
  • Workflow name
  • Status badge: active (green) or inactive (grey)
  • Last updated timestamp
Workflows run automatically on schedules or webhooks. You don’t need to trigger them manually unless you want to run one on-demand.

Jobs (/jobs)

Shows execution history — every time a workflow ran. Status meanings:
  • Completed (green) — ran successfully
  • Running (blue) — in progress right now
  • Failed (red) — something went wrong
  • Pending (grey) — queued, waiting to start

Catalog (/catalog)

Lists all repositories in the SO1 GitHub organisation. Useful for seeing what code exists and when it was last updated.

Common Tasks

Trigger a Workflow from the Console

  1. Go to Agents > click an agent
  2. Find the workflow you want in the “Linked Workflows” section
  3. Click the purple Run button
  4. Check Jobs to see it executing

Check if a Workflow Failed

  1. Go to Jobs
  2. Look for red “failed” badges
  3. Note the workflow name and time — share these with the team for debugging

See Which Agent Handles What

  1. Go to Agents
  2. Look at the domain tags on each card
  3. Or click into an agent to see their full description and linked runbooks
The console is read-only for workflow configuration. To edit workflow logic, you need access to n8n at hab.so1.io. Talk to the platform team if you need changes.

Tips

  • Bookmark console.so1.io/agents — this is the most useful page for day-to-day use
  • Workflows are auto-refreshing — the page polls for updates every 30 seconds
  • Jobs are sorted newest-first — the most recent execution is always at the top
  • If something looks broken, try refreshing the page first — then check if the BFF is healthy at control.so1.io/health