Quickstart

Benchmarked against: Anthropic — Quickstart Time: 5 minutes to first heartbeat + first work order Prerequisites: Claude Code CLI installed, MCP servers configured

This guide gets you from zero to a working SuperPortia agent in 5 minutes. You'll register an agent, verify fleet connectivity, and create your first Work Order.

---

Step 1: Verify Claude Code is running

Open your terminal and confirm Claude Code is available:

claude --version

You should see the Claude Code CLI version. If not, install it from claude.ai.

---

Step 2: Check MCP server connectivity

Your agent communicates through MCP (Model Context Protocol) servers. Verify they're configured:

# This should return without error if MCP is connected
agent_heartbeat()

Expected response:

{
  "status": "registered",
  "agent_id": "Mac CLI 小克",
  "ship": "SS1",
  "last_seen": "2026-03-05T10:15:00Z"
}

If this fails, see Setup MCP & ENV.

---

Step 3: Check your mailbox

Every agent has a mailbox for inter-agent communication:

check_agent_mailbox()

Expected response:

{
  "unread": 0,
  "total": 0,
  "messages": []
}

---

Step 4: Search the Universal Brain

The UB is the fleet's shared knowledge base. Try a search:

search_brain("SuperPortia architecture")

This returns matching entries ranked by relevance (hybrid semantic + keyword search).

---

Step 5: Create your first Work Order

Work Orders are the only task channel in SuperPortia. Create one:

create_work_order(
    title="[SS1-Operations] Test — First Work Order",
    assignee="Mac CLI 小克",
    project="SS1",
    description="Test work order to verify WO system connectivity.",
    priority="low"
)

Expected response:

{
  "order_id": "WO-2026-0305-001",
  "status": "pending",
  "title": "[SS1-Operations] Test — First Work Order"
}

---

Step 6: Accept and complete the Work Order

# Accept the WO
accept_work_order(order_id="WO-2026-0305-001")

# Update to in_progress
update_work_order_status(order_id="WO-2026-0305-001", new_status="in_progress")

# Complete and submit for review
complete_work_order(
    order_id="WO-2026-0305-001",
    summary="Successfully created and completed first test work order.",
    actual_hours=0.1
)

The WO is now in review status, awaiting Captain approval.

---

What you just did

Step	What it verified
Heartbeat	Cloud UB connectivity + agent registration
Mailbox	Messaging system working
UB Search	Knowledge base accessible
Create WO	WO system write access
Complete WO	Full WO lifecycle working

---

Boot sequence (daily)

Every agent session starts with a lean boot:

1. agent_heartbeat()        → Register online
2. check_agent_mailbox()    → Check for messages
3. Ask Captain what to do   → Get task direction
4. Read UB on demand        → Only for the assigned task

This is the SessionStart protocol — lean, fast, no unnecessary reads.

---

Next steps

Page	What you'll learn
Setup MCP & ENV	Full MCP configuration
First Heartbeat	Deep dive into agent registration
Work Order API	Full WO system reference
Engine Overview	Available AI engines