Praise the Sun! — A Dark Souls–themed terminal UI for managing AI squad teams, forged in .NET.
SquadTUI is a powerful, elegant terminal user interface built with Hex1b for managing AI development teams. Inspired by the cooperative spirits of Dark Souls, each team member is a seasoned warrior with specialized skills and roles. Track your squad's activity, monitor progress, review decisions, and manage tasks — all from your terminal.
- 📊 Dashboard — Real-time overview of squad activity, active tasks, and team metrics
- 👥 Roster — Browse team members with their roles, skills, and current status (Active, Idle, Working, Offline)
- 📋 Decisions — Review and track architectural decisions, context, and rationale
- 📜 Charter Viewer — Read detailed member charters including identity, expertise, and guidelines
- 🔧 Skills — Catalog of team capabilities and specializations
- 📈 Activity Log — Chronological orchestration log with task assignments and completions
- 📉 Metrics — Sprint velocity, task completion rates, and team performance insights
- ⚙️ Settings — Configure theme, vim bindings, mouse, emoji display, and markdown rendering (
Skey) - ❓ Help Screen — In-app keybinding reference accessible with
F1 - 🎨 Theming — Four beautiful themes (Ocean, Heist, Sunset, HighContrast) — cycle with
Tkey - 📱 Responsive Layout — Adapts to wide (≥120 cols), medium (80-119), and narrow (<80) terminals
- ⌨️ Keyboard Navigation — Vim-friendly shortcuts (
j/k/h/l) with arrow key support - 🖱️ Mouse Support — Clickable nav tabs, scroll, and select with your mouse
Click above to watch a live demo of SquadTUI in action.
Screenshots captured on a 120-column terminal with the Ocean theme using hex1b CLI. See docs/SCREENSHOTS.md for how to capture fresh screenshots. Currently placeholder SVGs.
git clone https://github.com/londospark/SquadTUI.git
cd SquadTUI
dotnet build -c Release
dotnet run --project src/SquadTUIDownload the latest release for your platform from the Releases page:
- Windows:
squadtui-X.Y.Z-win-x64.ziporsquadtui-X.Y.Z-win-arm64.zip - macOS:
squadtui-X.Y.Z-osx-x64.tar.gzorsquadtui-X.Y.Z-osx-arm64.tar.gz - Linux:
squadtui-X.Y.Z-linux-x64.tar.gzorsquadtui-X.Y.Z-linux-arm64.tar.gz
Extract and run:
# Windows
unzip squadtui-X.Y.Z-win-x64.zip
.\SquadTUI.exe
# macOS/Linux
tar xzf squadtui-X.Y.Z-osx-x64.tar.gz
./SquadTUI# From the repo root
dotnet run --project src/SquadTUIIf no .ai-team/ directory is detected, SquadTUI will offer to create one for you, or you can set one up with Squad:
npx github:bradygaster/squad| Key | Action |
|---|---|
1–6 |
Jump to screen (Dashboard, Roster, Decisions, Skills, Log, Metrics) |
j / k |
Move selection down/up in lists |
h / l |
Switch to previous/next screen |
↑ / ↓ |
Arrow keys for list navigation |
← / → |
Arrow keys for screen switching |
Enter |
Select / activate current item |
T |
Cycle theme (Ocean → Heist → Sunset → HighContrast) |
S |
Open Settings screen |
F1 |
Toggle Help screen |
E |
Edit charter (from Member Detail) |
C |
Create squad scaffold (from NoSquad screen) |
Escape |
Go back (Detail → Roster → Dashboard) |
Q |
Quit |
| 🖱️ Click | Click nav bar tabs to switch screens |
- Dashboard — Start here for an overview
- Roster — Select a member → Member Detail → press
Efor Charter - Decisions — Browse architectural decisions by date
- Skills — View team capabilities and specializations
- Activity Log — Track recent orchestration events
- Metrics — Analyze sprint velocity and completion rates
- Settings (
S) — Configure app preferences - Help (
F1) — Quick keybinding reference
- Framework: .NET 10
- TUI Library: Hex1b 0.87.0 — Modern, declarative terminal UI framework
- Language: C# 13
- Testing: xUnit + Hex1b headless testing (
TestAppBuilder) - Platform Support: Windows, macOS, Linux (x64 and ARM64)
- Architecture: Clean separation — Models, Services, Screens, Rendering, Themes
We welcome contributions! Please see CONTRIBUTING.md for our Git Flow workflow, CI pipeline details, and code style guidelines. See also docs/ARCHITECTURE.md for a technical overview.
git checkout develop
git pull origin develop
git checkout -b feature/my-feature
# Make changes
dotnet test --filter "FullyQualifiedName!~DotnetBuild&FullyQualifiedName!~DotnetTest"
git add .
git commit -m "feat: add my feature"
git push origin feature/my-feature
# Create PR to develop- Project Board — Track progress and upcoming work
- GitHub Repository — Source code and issues
- Hex1b — The terminal UI framework powering SquadTUI
- SquadUI — Inspiration for squad-based AI workflows
SquadTUI is forged in the fires of Lordran — where every team member, like an undead warrior, plays a critical role in linking the flame. Our AI squad follows the same cooperative philosophy found in Dark Souls.
| Role | Name | Specialty |
|---|---|---|
| 🎯 Lead | Solaire | Architecture, code review, big picture |
| 💻 Backend Dev | Andre | Services, data layer, integrations |
| 🎨 Frontend Dev | Siegmeyer | UI/UX, screens, theming |
| 🧪 QA Engineer | Patches | Testing, quality assurance |
| 📣 UX Designer | Firekeeper | User experience, design systems |
| 📝 Docs | Scribe | Documentation, knowledge management |
| 🔧 DevOps | Ralph | CI/CD, tooling, automation |
Special thanks to csharpfritz/SquadUI for inspiration.
MIT License — see LICENSE for details.
Copyright © 2026 LondoSpark
Built with ☀️ by the SquadTUI team
"Praise the Sun!" \[T]/