Skip to content

MikeeBuilds/Squadron

Repository files navigation

Squadron Logo

Squadron

The Agentic Operating System for Your Desktop

Squadron is a native command center that lets you manage swarms of local AI agents (Gemini, Claude, Codex) as if they were employees.
Features a 6-terminal parallel workbench, Kanban task management, and deep integration with Jira/Linear to turn AI autonomy into real engineering work.


⬇️ Download Now Β Β β€’Β Β  Features Β Β β€’Β Β  Quick Start Β Β β€’Β Β  Architecture

Release Downloads License: AGPL v3

Squadron Terminal Hub


πŸ”₯ What's New in v2.0

Feature Description
πŸ–₯️ Native Desktop App Download and run β€” no terminal required
πŸ€– Multi-Provider Support Claude, Gemini, Codex, OpenCode, Cursor
πŸ“Ί 6-Terminal Grid Run 6 AI agents simultaneously
πŸ” Secure API Keys Encrypted storage with OS-level security
🌳 Git Worktrees Safe parallel execution per task
πŸ“‹ Kanban Board Drag-and-drop task management
πŸš€ Onboarding Wizard Get started in under a minute

⬇️ Download

Download the latest release for your platform:

Platform Download Architecture
Windows Squadron-Setup.exe x64
macOS Coming Soon Intel & Apple Silicon
Linux Coming Soon x64

Windows users: You may see a SmartScreen warning. Click "More info" β†’ "Run anyway". We're working on code signing.


✨ Features

πŸ€– Multi-Provider AI Terminal

Run any AI coding assistant directly in Squadron:

Provider Models Status
Claude Sonnet 4, Opus 4, Haiku βœ… Auto-install
Gemini 2.5 Pro, 2.5 Flash βœ… Auto-install
OpenAI Codex GPT-4o, o1, o3-mini βœ… Auto-install
OpenCode Multi-model βœ… Auto-install
Cursor Any model βœ… Auto-install

Auto-Install: CLIs download automatically when you select a provider. No manual setup.

πŸ“Ί 6-Terminal Grid

6-Terminal Grid

  • 3x2 Grid Layout β€” See all agents at once
  • Per-Terminal Provider β€” Run Claude in one, Gemini in another
  • Task Linking β€” Connect terminals to Kanban tasks
  • Context Injection β€” Task details auto-sent to AI

πŸ“‹ Kanban Board

Kanban Board

Visual task management:

  • Columns: Backlog β†’ Planning β†’ In Progress β†’ Review β†’ Done
  • Real-time Updates via Server-Sent Events
  • Task Wizard for quick task creation
  • Agent Assignment per task

🌳 Git Worktree Isolation

Each agent task gets its own isolated workspace:

Task Started β†’ .worktrees/task-XXX created β†’ Agent works in isolation
                                                    ↓
                                        Merge or Discard via Dashboard

Benefits:

  • βœ… Agents work in parallel without conflicts
  • βœ… Main branch stays protected
  • βœ… Easy to discard failed work
  • βœ… Each task gets its own branch for review

πŸ” Secure Settings

Settings Panel

  • Encrypted at Rest using OS-level security (Windows DPAPI / macOS Keychain)
  • 11 Integrations: Slack, Discord, Jira, Linear, GitHub + AI providers
  • Export to .env for Python backend
  • Never Transmitted β€” keys stay local

πŸš€ Quick Start

1. Download & Install

Download from Releases and install for your platform.

2. Complete Onboarding

Onboarding Wizard

The wizard guides you through:

  • Choosing your AI provider
  • Entering your API key
  • Selecting your project folder

3. Start Coding

  • Click the provider dropdown in any terminal
  • Select your AI (Claude, Gemini, etc.)
  • CLI auto-downloads if needed
  • Start prompting!

πŸ—οΈ Architecture

Squadron is a hybrid desktop application:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    ELECTRON SHELL                       β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”‚
β”‚  β”‚   React + Vite  β”‚  β”‚       Main Process             β”‚β”‚
β”‚  β”‚   ─────────────  β”‚  β”‚    ────────────────            β”‚β”‚
β”‚  β”‚   β€’ 6-Terminal  β”‚  β”‚    β€’ PTY Management           β”‚β”‚
β”‚  β”‚   β€’ Kanban UI   │◄──    β€’ API Key Storage          β”‚β”‚
β”‚  β”‚   β€’ Settings    β”‚  β”‚    β€’ CLI Auto-Install         β”‚β”‚
β”‚  β”‚   β€’ Onboarding  β”‚  β”‚    β€’ Process Manager          β”‚β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β”‚
β”‚           β–²                        β–²                    β”‚
β”‚           β”‚ IPC                    β”‚ Spawn              β”‚
β”‚           β–Ό                        β–Ό                    β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β”‚
β”‚  β”‚    TERMINAL SESSIONS (node-pty + xterm.js)         β”‚β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
             β”‚
             β”‚ HTTP API (Port 8000)
             β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  PYTHON BACKEND                         β”‚
β”‚   β€’ Swarm Orchestration    β€’ Git Worktrees             β”‚
β”‚   β€’ Task Queue             β€’ Integrations              β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ› οΈ Build from Source

For developers who want to run from source:

# Clone the repo
git clone https://github.com/MikeeBuilds/Squadron.git
cd Squadron/desktop

# Install dependencies
npm install

# Run in development mode
npm run electron:dev

# Build for production
npm run electron:build

πŸ—ΊοΈ Roadmap

Completed βœ…

  • Native Desktop App β€” Electron cross-platform
  • 6-Terminal Grid β€” Multi-agent workspace
  • Multi-Provider Support β€” Claude, Gemini, Codex, OpenCode, Cursor
  • Auto-Install CLIs β€” Zero setup for users
  • Secure API Keys β€” Encrypted local storage
  • Git Worktree Isolation β€” Safe parallel execution
  • Kanban Board β€” Visual task management
  • Task Wizard β€” Easy task creation
  • Onboarding Wizard β€” First-launch setup
  • Integration Settings β€” Slack, Discord, Jira, Linear, GitHub

Coming Soon 🚧

  • AI Merge Resolution β€” Automatic conflict resolution
  • Insights Panel β€” ChatGPT-style project Q&A
  • Changelog Generator β€” Auto-generate from tasks
  • Auto-Updates β€” In-app updates

🀝 Contributing

We welcome contributions!

  1. Fork the repo
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

πŸ“œ License

AGPL-3.0 Β© MikeeBuilds


Command your AI agents. Ship faster.

⭐ Star this repo β€’ πŸ“¦ Download β€’ πŸ› Report Bug

About

The Agentic Operating System for your desktop. Squadron is a native command center that lets you manage swarms of local AI agents (Gemini, Claude, Codex) as if they were employees. Features a 6-terminal parallel workbench, Kanban task management, and deep integration with Jira/Linear to turn AI autonomy into real engineering work.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors