Agent System

Supervisor agent managing Claude Code agents for comprehensive Mac automation and development workflows.

Features

• Multi-agent orchestration: Coordinate specialized agents for different tasks
• HTTP API: RESTful API for agent registration and task management
• Priority-based task queue: Intelligent task scheduling
• Expert agents: Pre-configured specialists for Rust, K8s, security, IaC, and docs
• Mac automation: Nu script integration for shell config generation and tooling

Architecture

┌─────────────────────┐
│ Supervisor Agent    │
│  (HTTP API Server)  │
└──────────┬──────────┘
           │
    ┌──────┴──────┐
    │             │
┌───▼──┐      ┌───▼──┐
│Agent │      │Agent │
│Pool  │      │Queue │
└───┬──┘      └───┬──┘
    │             │
    └─────┬───────┘
          │
    ┌─────▼─────┐
    │  Agents   │
    │  ┌─────┐  │
    │  │Type │  │
    │  └─────┘  │
    └───────────┘

Quick Start

Prerequisites

• Rust 1.82+
• Nushell
• Just

Start Supervisor

just supervisor-start

Create an Agent

just agent-create my-agent rust_expert

List Agents

just agent-list

API Endpoints

• GET / - Root endpoint
• GET /health - Health check
• GET /agents - List all agents
• POST /agents - Create new agent
• GET /agents/:id - Get agent by ID
• DELETE /agents/:id - Delete agent
• POST /agents/:id/task - Assign task to agent
• GET /tasks - List all tasks
• POST /tasks - Create new task

Agent Types

Type	Description
dotfile	Shell configuration management
cluster	K8s cluster operations
security	Credential rotation and auditing
dev	Development workflow automation
gitops	Infrastructure deployment
rustexpert	Rust development optimization
k8sexpert	K8s troubleshooting and optimization
securityexpert	Security scanning and compliance
iacexpert	Pulumi/Crossplane management
docsexpert	Documentation generation

Configuration

Agent configurations are stored in agents/*.toml. Each config defines:

name = "agent-name"
agent_type = "type"
description = "Agent description"
max_parallel_tasks = 3
memory_limit_mb = 2048

[specialization_prompt]
prompt = "..."

Mac Setup

Automated Mac setup with all configurations:

just mac-setup

This will:

1. Install Homebrew packages from dotconfig
2. Generate shell configurations
3. Configure MCP servers
4. Setup development tooling

Development

just check

This runs: formatting, linting, and tests.

Integration

Works with:

• dotconfig: Shell config generation
• gitops-v2: Infrastructure deployment
• playground: Development sandbox
• credential-vault: Secret management
• k8s-orchestrator: Cluster management