platform-setup

name	platform-setup
description	Set up Tangerine on the host machine or inside a VM — install tools, configure projects, clone repos, and install agent skills.
metadata	{"author":"tung","version":"1.3.3"}

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 is available → ask: