Quick Start¶

1. Start the app¶

Option A — Development (3 terminals):

# Terminal 1: Backend
cd backend && uv run python -m uvicorn app.main:app --reload --port 8000

# Terminal 2: Frontend
cd frontend && npm run dev

# Terminal 3: Electron (optional — or use browser at localhost:3000)
cd electron && npm start

Option B — Download the desktop app from Releases.

Navigate to http://localhost:3000 and sign in with GitHub OAuth (optional — the app works without auth).

3. Register a workspace¶

Click Add Workspace and provide the path to a local CUTIP project directory (must contain cutip.yaml).

4. Browse artifacts¶

Select a workspace to see its groups, units, and cards. Click any artifact to view its YAML definition. Switch to the Graph tab to see the DAG visualization.

5. Validate¶

Click Validate to run the CUTIP graph validator against all artifacts in the workspace. Errors are displayed inline.

6. Manage containers¶

Navigate to Containers, Images, Volumes, or Networks to manage Docker/Podman resources. Requires Docker Desktop or Podman to be running.