# Setup TODO — Getting AI-Orchestrator + OrgMyLife Running

## Prerequisites

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

---

## 1. OrgMyLife Setup (Your Task Board) ✅ DONE

- [x] PostgreSQL running in Docker on VPS
- [x] `.env` configured with all credentials
- [x] App deployed and running at https://api.andreknie.de
- [x] Login page working (session-based auth)
- [x] Nextcloud calendar sync working
- [x] Nextcloud ToDo sync working (two-way)
- [x] Email/IMAP sync working
- [x] Backlog.md sync working
- [x] 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:
  ```bash
  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:
  ```bash
  codex --version
  ```
- [ ] If using a different agent (Claude, local LLM), update `codex.command`

### Run

- [ ] Start the orchestrator:
  ```bash
  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

- [x] Add authentication to OrgMyLife (login page + API_SECRET for orchestrator)
- [x] 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 |