Orchestrator/shared/AI-Orchestrator/SETUP_TODO.md

Setup TODO — Getting AI-Orchestrator + OrgMyLife Running

Prerequisites

• Python 3.11+ installed on your machine
• PostgreSQL running (Docker on VPS)
• Codex CLI installed (codex app-server must be available in PATH)
• Git available in PATH

---

1. OrgMyLife Setup (Your Task Board) ✅ DONE

• PostgreSQL running in Docker on VPS
• .env configured with all credentials
• App deployed and running at https://api.andreknie.de
• Login page working (session-based auth)
• Nextcloud calendar sync working
• Nextcloud ToDo sync working (two-way)
• Email/IMAP sync working
• Backlog.md sync working
• Delete button, AI toggle, sort buttons in UI

---

2. AI-Orchestrator Setup (NEXT)

Install

• cd AI-Orchestrator && pip install -e ".[dev]"

Configure

• Copy the OrgMyLife workflow file:

  cp WORKFLOW.orgmylife.md WORKFLOW.md
  

• Edit WORKFLOW.md:
  • tracker.endpoint → https://api.andreknie.de
  • tracker.api_key → your API_SECRET from the VPS .env
  • workspace.root → where you want agent workspaces locally
  • codex.command → your agent CLI command

Verify Agent CLI

• Confirm your coding agent works:

  codex --version
  

• If using a different agent (Claude, local LLM), update codex.command

Run

• Start the orchestrator:

  ai-orchestrator WORKFLOW.md --port 8080
  

• Check the dashboard: http://localhost:8080
• Verify it connects to OrgMyLife (check logs)

---

3. End-to-End Test

• Mark a coding task as agent_ready (🤖 button in UI)
• Watch the orchestrator pick it up
• Verify the agent creates a workspace and starts working
• Check that OrgMyLife shows the task as "in_progress"
• When the agent finishes, verify the task moves to "completed"

---

4. Optional Enhancements

• Add authentication to OrgMyLife (login page + API_SECRET for orchestrator)
• Add 🤖 indicator in OrgMyLife frontend for agent_ready tasks
• Set up the orchestrator as a systemd service or Docker container
• Configure workspace hooks to clone repos automatically
• Set up auto-sync (cron) on the VPS
• Set up email notifications when agents complete tasks

---

Quick Reference

Service	URL	Purpose
OrgMyLife	https://api.andreknie.de	Your task board + data source
AI-Orchestrator	http://localhost:8080	Agent dispatch + monitoring
Orchestrator API	http://localhost:8080/api/v1/state	JSON system state

Command	What it does
docker compose up -d --build	Rebuild & restart OrgMyLife on VPS
ai-orchestrator WORKFLOW.md --port 8080	Start orchestrator locally
git pull && docker compose up -d --build	Deploy updates to VPS