Installation
From Source
git clone https://github.com/pjcau/AgentsBoard.git
cd AgentsBoard
swift build -c release
The built app will be at .build/release/AgentsBoard.
Using the CLI Tool
AgentsBoard includes agentsctl, a command-line tool for controlling sessions:
# Build the CLI
swift build --product agentsctl
# Install to /usr/local/bin
cp .build/debug/agentsctl /usr/local/bin/
# Verify
agentsctl --help
Homebrew (Coming Soon)
brew install --cask agentsboard
Building the .app Bundle
# Build, sign, and create the .app bundle
./Scripts/bundle.sh
# Create a DMG installer
./Scripts/build-dmg.sh
Dependencies
AgentsBoard uses Swift Package Manager. Dependencies are resolved automatically:
| Package | Purpose |
|---|---|
| SwiftTerm | VT100/xterm terminal emulation |
| Yams | YAML configuration parsing |
| GRDB.swift | SQLite persistence layer |
Project Structure
AgentsBoard/
├── Sources/
│ ├── App/ # Main app entry point, CompositionRoot
│ ├── Core/ # Domain logic (zero UI dependencies)
│ ├── UI/ # SwiftUI + AppKit views
│ └── CLI/ # agentsctl command-line tool
├── Tests/
│ ├── CoreTests/ # 150+ unit tests
│ └── UITests/ # View model tests
├── Scripts/ # Build, CI, release scripts
└── website/ # This documentation (Docusaurus)