Skip to content

njfio/swarmx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

465 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SwarmX

Multi-agent software development orchestration system with built-in quality assurance, skill evolution, and memory consolidation.

Overview

SwarmX coordinates specialized AI agents to collaborate on software development tasks. It provides:

  • Agent Orchestration: Centralized task coordination via Conductor agent
  • Skill System: Event-triggered skill invocation with evolution
  • Quality Assurance: File ownership enforcement and code review workflows
  • Intelligence: Episode logging and skill improvement tracking

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      Orchestration Pool                      │
│   Conductor  │  Spec  │  Architect  │  Reflection  │  ...   │
└──────────────────────────────┬──────────────────────────────┘
                               │ assigns tasks
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                       Execution Pool                         │
│      Backend     │     Frontend     │      DevOps      │    │
└──────────────────────────────┬──────────────────────────────┘
                               │ results
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                       Assurance Pool                        │
│         Arbiter         │       Skill Evolver        │     │
└─────────────────────────────────────────────────────────────┘

Crates

Crate Description
swx-core Shared types, ID generation, task management
swx-actors Actor-based message handling
swx-store Persistent storage
swx-sandbox Isolated execution environment
swx-llm LLM gateway
swx-git Git operations
swx-github GitHub API integration
swx-memory Long-term memory
swx-intel Intelligence and evolution
swxd HTTP API server

Quick Start

# Build the project
cargo build --workspace

# Run tests
cargo test --workspace

# Start the API server
cargo run --bin swxd

Documentation

Key Concepts

Agents

Agents are specialized AI workers assigned to specific tasks:

  • Orchestration Pool: Conductor, Spec, Architect, Reflection, etc.
  • Execution Pool: Backend, Frontend, DevOps, Data, Security
  • Assurance Pool: Arbiter, Skill Evolver, etc.

Tasks

Tasks are work items with:

  • Priority (Critical, High, Normal, Low)
  • State (Pending → Completed)
  • Parent/child relationships (epics)
  • Context tags for categorization

Skills

Skills are reusable workflows triggered by events:

Trigger Skill
CodeChanged code-change-verification
TestFailure test-failure-analysis
DependencyAdded dependency-review

Evolution

The Intel system evolves skills based on usage:

  1. Log successful task completions as episodes
  2. Propose skill improvements
  3. Apply changes with appropriate safety tier

Development

Adding a New Agent

  1. Add AgentId variant in crates/swx-core/src/agent.rs
  2. Assign to appropriate AgentPool
  3. Implement message handling in swx-actors

Adding a New Skill

  1. Create skill definition in crates/swx-core/src/skill.rs
  2. Add trigger mapping
  3. Implement skill scripts

Adding a New Crate

cargo new crates/swx-new-crate

Add to workspace in Cargo.toml.

License

MIT

About

Self-improving AI coding agent swarm platform

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors