Swarm is a terminal workspace designed for vibecoders who thrive in command-line environments. Built on the robust foundation of Zellij, Swarm transforms your terminal into a powerful development ecosystem with modern tooling and collaborative features.

• MCP Manager Plugin: A powerful plugin for managing Model Context Protocol servers
  • Dynamic argument configuration for each MCP type
  • Template-based setup (Agent MCP, FileSystem, Git, Python, Node.js)
  • Smart command building with proper flag handling
  • Directory browser for path arguments (Ctrl+D)
  • Background tmux session management
  • Python virtual environment support
• Architecture Documentation: Comprehensive guides for understanding and extending Swarm
• Plugin Development Guide: Learn how to create your own Swarm plugins

• Full MCP Integration: Native support for Claude and other AI assistants
• Agent Orchestration: Manage multiple AI agents working in parallel
• Enhanced Collaboration: Real-time code sharing and pair programming features

Swarm is crafted for developers who demand both simplicity and sophistication - delivering an exceptional out-of-the-box experience while providing advanced customization for power users. Whether you're coding solo or collaborating with a team, Swarm adapts to your workflow.

Swarm features include deep customizability through layouts, true multiplayer collaboration, innovative UX elements like floating and stacked panes, and an extensible plugin system supporting any language that compiles to WebAssembly. From beginners taking their first steps in terminal-based development to seasoned vibecoders orchestrating complex workflows, Swarm empowers every type of developer.

You can get started by installing Swarm using our easy installation script.

For more details about our future plans, read about upcoming features in our roadmap.

The easiest way to install Swarm is using our installation script:

# Quick install
bash install-swarm.sh

Or install with cargo:

cargo install --locked swarm

After installation, you can use either command:

• swarm - Full command
• sm - Short alias

Installing Swarm from the main branch is not recommended. This branch represents pre-release code and may contain unstable features.

• Clone the project
• In the project folder, for debug builds run: cargo xtask run
• To run all tests: cargo xtask test

For more build commands, see CONTRIBUTING.md.

For configuring Swarm, edit your ~/.config/swarm/config.kdl file. See the example configuration in the example/ directory.

Issues in this repository, whether open or closed, do not necessarily indicate a problem or a bug in the software. They only indicate that the reporter wanted to communicate their experiences or thoughts to the maintainers. The Swarm maintainers do their best to go over and reply to all issue reports, but unfortunately cannot promise these will always be dealt with or even read. Your understanding is appreciated.

Presented here is the project roadmap, divided into three main sections.

These are issues that are either being actively worked on or are planned for the near future.

If you'll click on the image, you'll be led to an SVG version of it on the website where you can directly click on every issue

Swarm represents the collaborative nature of terminal workspaces - like a swarm of efficient processes working together in harmony. Multiple panes, tabs, and plugins coordinate seamlessly to create a powerful development environment where the whole becomes greater than the sum of its parts.

Built on the proven architecture of Zellij, Swarm inherits robust terminal multiplexing capabilities while adding modern enhancements and vibecoder-focused features that make terminal-based development more intuitive and productive.

MIT