TriClaude Manager

This skill manages the TriClaude application - pulling latest code, syncing to runtime, ensuring services are running, and providing access URLs.

Quick Reference

Component Location

Git Repo /home/yousuf/local_workspaces/triclaude

Runtime Cache /home/yousuf/dev/cache/triclaude

Launch Script /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/launch_triclaude.sh

Desktop Shortcut /home/yousuf/Desktop/TriClaude.desktop

GitHub yousufjoyian/triclaude

Ports

Service Port

Web UI (Vite) 3001

Project API 7690

Consigliere 7695

WS Relay 7899

Command Bridge 8765 (legacy)

Dynamic Terminals (ttyd) 7700+

Shortcut Bar

The shortcut bar sends commands to ttyd terminals via WebSocket relay (port 7899).

How it works:

• Click on a terminal panel to make it "active" (green indicator)

• Press any shortcut button to send to that terminal

• Yellow indicator = no terminal selected yet

Available shortcuts:

Button Action Value

2 Keypress Sends "2"

ESC Keypress Escape key

UT Text "ultrathink"

⏎ (Enter) Keypress Enter/Return

Y Text "yes"

C Text "continue"

Commit Text "commit"

Context Text "extract context"

Technical: Uses ttydService.ts which connects via WebSocket relay at ws://<host>:7899/relay/<ttydPort> . The relay server (ws_relay.py ) forwards to ws://127.0.0.1:<ttydPort>/ws to bypass origin restrictions.

When to Use This Skill

Trigger phrases:

• "pull triclaude"

• "update triclaude"

• "start triclaude"

• "triclaude status"

• "launch triclaude"

What This Skill Does

• Pull latest from GitHub to /home/yousuf/local_workspaces/triclaude

• Sync to cache via rsync to /home/yousuf/dev/cache/triclaude

• Check services - verify all 4 services are running

• Start missing services if needed

• Provide URLs for localhost and Tailscale access

Execution Steps

Step 1: Pull Latest from GitHub

cd /home/yousuf/local_workspaces/triclaude && git pull

Step 2: Sync to Runtime Cache

rsync -av --exclude=node_modules --exclude=package-lock.json --exclude=dist --exclude=.git /home/yousuf/local_workspaces/triclaude/ /home/yousuf/dev/cache/triclaude/

Step 3: Check Running Services

Check all services

curl -s http://localhost:7690/api/health > /dev/null && echo "Project API: UP" || echo "Project API: DOWN" ss -tlnp 2>/dev/null | grep -q ":7695" && echo "Consigliere: UP" || echo "Consigliere: DOWN" ss -tlnp 2>/dev/null | grep -q ":8765" && echo "Bridge: UP" || echo "Bridge: DOWN" curl -s http://localhost:3001 > /dev/null && echo "Web UI: UP" || echo "Web UI: DOWN"

Step 4: Start Missing Services (if needed)

If services are down, either:

• Tell user to restart via desktop shortcut, OR

• Start individual services:

Project API

python3 /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/project_api.py &

Consigliere

nix-shell -p python312Packages.websockets --run
"python3 /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/consigliere_server.py" &

Command Bridge

nix-shell -p python312Packages.websockets --run
"python3 /home/yousuf/local_workspaces/triclaude/bridge/command_server.py" &

Web UI (from cache dir)

cd /home/yousuf/dev/cache/triclaude && npx vite --port 3001 --host &

Step 5: Get Tailscale IP

ip -4 addr show tailscale0 2>/dev/null | grep -oP '(?<=inet\s)\d+(.\d+){3}'

Step 6: Provide Access URLs

After all steps, output:

TriClaude v4.1 Ready

Localhost: http://localhost:3001

Android (Tailscale): http://<TAILSCALE_IP>:3001

Services: Project API: http://localhost:7690 [UP/DOWN] Consigliere: ws://localhost:7695 [UP/DOWN] Bridge: ws://localhost:8765 [UP/DOWN] Web UI: http://localhost:3001 [UP/DOWN]

Full Automated Script

Run all steps in sequence:

#!/bin/bash echo "=== TriClaude Pull & Sync ==="

1. Pull latest

echo "[1/5] Pulling latest from GitHub..." cd /home/yousuf/local_workspaces/triclaude && git pull

2. Sync to cache

echo "[2/5] Syncing to runtime cache..." rsync -av --exclude=node_modules --exclude=package-lock.json --exclude=dist --exclude=.git /home/yousuf/local_workspaces/triclaude/ /home/yousuf/dev/cache/triclaude/ >/dev/null 2>&1

3. Rebuild (production mode - no hot reload)

echo "[3/5] Rebuilding production bundle..." cd /home/yousuf/dev/cache/triclaude && npx vite build > /dev/null 2>&1 echo " Build complete. Refresh browser to see changes."

4. Check services

echo "[4/5] Checking services..." API_UP=$(curl -s http://localhost:7690/api/health > /dev/null 2>&1 && echo "UP" || echo "DOWN") CONSIGLIERE_UP=$(ss -tlnp 2>/dev/null | grep -q ":7695" && echo "UP" || echo "DOWN") BRIDGE_UP=$(ss -tlnp 2>/dev/null | grep -q ":8765" && echo "UP" || echo "DOWN") WEB_UP=$(curl -s http://localhost:3001 > /dev/null 2>&1 && echo "UP" || echo "DOWN")

5. Get Tailscale IP

TAILSCALE_IP=$(ip -4 addr show tailscale0 2>/dev/null | grep -oP '(?<=inet\s)\d+(.\d+){3}' || echo "not connected")

Output

echo "" echo "[5/5] Status Report" echo "========================================" echo " TriClaude v4.1" echo "========================================" echo "" echo "Access URLs:" echo " Localhost: http://localhost:3001" echo " Android: http://$TAILSCALE_IP:3001" echo "" echo "Services:" echo " Project API: $API_UP" echo " Consigliere: $CONSIGLIERE_UP" echo " Bridge: $BRIDGE_UP" echo " Web UI: $WEB_UP" echo ""

if [ "$API_UP" = "DOWN" ] || [ "$WEB_UP" = "DOWN" ]; then echo "WARNING: Some services are down." echo "Restart via: Desktop shortcut 'TriClaude'" fi

Troubleshooting

Issue Solution

Services down Use desktop shortcut to restart all

Code not updating Check rsync ran, rebuild with npx vite build , refresh browser

Tailscale not connected Run sudo tailscale up

Bridge offline Start manually with nix-shell command above

Terminal won't connect Add a project first, then launch Claude/Terminal

Architecture

GitHub (yousufjoyian/triclaude) ↓ git pull local_workspaces/triclaude (git repo, source of truth) ↓ rsync dev/cache/triclaude (runtime, build here → serve dist/) ↓ Browser → localhost:3001 or Tailscale:3001

Related Files

• Launch script: /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/launch_triclaude.sh

• Project API: /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/project_api.py

• Consigliere: /home/yousuf/GoogleDrive/PROJECTS/APPS/TriClaude/scripts/consigliere_server.py

• Bridge: /home/yousuf/local_workspaces/triclaude/bridge/command_server.py

• Desktop shortcut: /home/yousuf/Desktop/TriClaude.desktop