---
# System prepended metadata

title: Simple codex-based kanban-aware multi-agent runner

---

# Simple codex-based kanban-aware multi-agent runner

1. Install the kanban-fs extension: https://marketplace.visualstudio.com/items?itemName=flcl42.kanban-vsix
2. Install dotnet SDK https://dotnet.microsoft.com/en-us/download
3. Install codex cli https://developers.openai.com/codex/cli 
4. Copy script https://github.com/flcl42/kanban-fs/blob/master/codex_runner.csx to an empty directory where everything will be rolled out
5. Run the script with `dotnet script .\codex_runner.csx`

Script will deploy the initial structure and will track changes in tasks, assigning agents(up to 5 tasks in parallel by default)

```
├─ .gitignore
├─ codex_runner.csx
├─ context.md
├─ projects.md
├─ cache/
├─ logs/
├─ projects/
├─ tasks/
│  ├─ .kanban
│  ├─ template.md
│  ├─ new/
│  ├─ backlog/
│  ├─ doing/
│  ├─ blocked/
│  ├─ done/
│  └─ confirmed/
└─ trash/
```

I allowed codex to work without asking for permissions / do everything, let me know if the mode you use breaks the runner