Spawning an Intern

There are two ways to create a new intern: the Dashboard (recommended) or the CLI.

From the Dashboard

Open the Dashboard

Go to intern-dashboard-blush.vercel.app and sign in with your @lunarsolargroup.com Google account.

Click Spawn Intern

Click the Spawn Intern button in the header. Enter a name (lowercase, alphanumeric, hyphens only).The dialog shows a preview of what will be created:

Slack: #intern-<name>
URL: <name>.lunarintern.com
API: api-<name>.lunarintern.com
App: app-<name>.lunarintern.com

Wait for Provisioning

The spawn takes ~5 minutes. You’ll see the agent appear in the dashboard with status provisioning, then ready.The intern’s Slack channel will receive a message when it’s online.

Names must be unique. The dashboard checks for existing agents and shows an error if the name is taken.

From the CLI

cd /path/to/agent-gen
npm run spawn -- <name>

Example:

npm run spawn -- hotel

This runs the full spawn sequence:

Creates private Slack channel #intern-hotel
Creates Cloudflare tunnel + 3 DNS records
Creates Linear label intern:hotel
Registers agent in Supabase
Generates cloud-init with all secrets
Creates Hetzner VM from snapshot
Waits for server to be ready
Auto-approves OpenClaw device pairing

Output

====================================
  Intern: hotel
====================================

  Server IP:     95.217.x.x
  Dashboard:     https://hotel.lunarintern.com
  API Backend:   https://api-hotel.lunarintern.com
  App Frontend:  https://app-hotel.lunarintern.com
  Password:      <random-32-byte-password>
  Tunnel ID:     <uuid>
  Slack:         #intern-hotel
  Linear Label:  intern:hotel
  Supabase ID:   <uuid>

What Happens on Boot

Cloud-init runs automatically and handles:

System Setup

Sets hostname to intern-<name>
Activates swap (4GB)
Starts Cloudflare tunnel
Authenticates GitHub CLI

Repository Setup

Fetches latest code for layerfivecore, l5ui, docs
Resets to default branch
Applies Angular budget and environment fixes

Secrets & Config

Pulls backend .env from Cloudflare KV
Generates Angular environment.dev.ts with instance URLs
Writes OpenClaw config with Slack tokens, password, security settings

Docker Stack

Starts Postgres, Redis, Mailpit
Runs Django migrations + seeds database
Builds Angular frontend
Starts Nginx to serve the app

OpenClaw & Crons

Installs and starts OpenClaw gateway
Auto-approves device pairing
Creates linear-poll cron (every 5 min)
Creates pr-review cron (every 10 min)

Cost

Each intern runs on a Hetzner CX33 (4 vCPU, 8GB RAM, 80GB disk):

Resource	Cost
Server (CX33, Helsinki)	~€5.99/month
Cloudflare Tunnel	Free
Claude Code CLI	Included in Claude Team subscription
Supabase	Pro plan (shared across all agents)

Destroying an Intern

npm run destroy -- <name>

This deletes the Hetzner server and Cloudflare tunnel + DNS records. The Linear label is preserved for audit trail.

Getting Started

Onboarding

Platform

Configuration

AI Agents

Agent Surface

Creative Analytics

Development

Lunar Interns

Performance Reports

Attribution & Reporting

Notes / PMT

Spawning an Intern

Spawning an Intern

From the Dashboard

From the CLI

Output

What Happens on Boot

Cost

Destroying an Intern

​Spawning an Intern

​From the Dashboard

​From the CLI

​Output

​What Happens on Boot

​Cost

​Destroying an Intern

Spawning an Intern

From the Dashboard

From the CLI

Output

What Happens on Boot

Cost

Destroying an Intern