platform-setup

Tangerine Init Skill

Set up the Tangerine coding agent platform. Tangerine can run directly on the host machine OR inside a Lima VM. Either way: one machine runs the server, dashboard, agents, and all project repos.

Architecture (v1)

Host (laptop) — or VM (Lima)
├── tangerine server + dashboard (:3456)
├── {workspace}/project-a      (main clone)
│              /project-a--wt-1 (task worktree)
│              /project-a--wt-2 (task worktree)
├── {workspace}/project-b, project-b--wt-1, ...
├── ACP agents — local stdio processes
└── Apache, MariaDB, tools — shared

{workspace} defaults to ~/tangerine-workspace but is configurable via config.workspace in ~/tangerine/config.json.

No SSH tunnels, no per-project VMs. One machine, all projects.

Routing

Before doing anything, figure out which mode applies:

1. Check if Tangerine is already running (tangerine --version or ~/tangerine/config.json exists) → Mode 3 (add a project).
2. Check if we're inside a Lima VM (limactl info fails or uname -n contains "lima") → Mode 1 (set up Tangerine here).
3. Check if the user is on macOS (uname -s = Darwin) and limactl is available → ask: "Do you want to run Tangerine directly on this machine or inside a Lima VM?"
   • Direct → Mode 1
   • VM → Mode 2
4. Otherwise (Linux host, no VM) → Mode 1.

Setup Modes

Two modes: Tangerine Setup (install and run Tangerine on the current machine) and VM Creation (create a Lima VM on macOS, then run Tangerine Setup inside it — the setup steps are identical once inside).

Mode 1: Tangerine Setup (host or inside VM)

User is on the machine where Tangerine will run — either their host or inside a Lima VM. You help them:

1. Install prerequisites

   Detect OS: uname -s → Darwin = macOS, Linux = Linux.

   macOS (use Homebrew; install brew first if missing):

   brew install git gh jq dtach node
   # Bun:
   curl -fsSL https://bun.sh/install | bash