Home

Nebulus Atom Wiki

Nebulus Atom is a professional, autonomous AI engineer CLI that interacts with a local LLM server (Nebulus Prime/Nebulus Edge/Ollama) to assist with software engineering tasks. It includes Nebulus Swarm, a multi-agent orchestration system that autonomously processes GitHub issues at scale.

Quick Links

Getting Started	Core System	Swarm System
Installation	Architecture	Nebulus Swarm
Quick Start	CLI Reference	Swarm Overlord
Configuration	Features	Swarm Minion
Deployment	Testing	Swarm Dashboard
Troubleshooting	Contributing	Model Router

What is Nebulus Atom?

Nebulus Atom is an AI-powered CLI agent that:

• Reads, writes, and edits code autonomously
• Manages context with pinned files and semantic search (RAG)
• Creates checkpoints and supports smart undo
• Builds and executes persistent skills
• Runs in autonomous execution mode with TDD support
• Provides a TUI dashboard for real-time monitoring

What is Nebulus Swarm?

Nebulus Swarm extends Nebulus Atom into a multi-agent system:

• Overlord - Cross-project meta-orchestrator with:
  • Registry & Scanner for project discovery and dependency tracking
  • Dependency graph with blast radius analysis
  • Cross-project memory for persistent observations
  • Autonomy engine with confidence scoring
  • Slack command router with multi-project commands
  • Proposal manager with approval workflows via Slack threads
  • Background daemon with croniter-based scheduled sweeps
  • Proactive detectors (stale branches, ahead-of-main, failing tests)
  • Notification system with urgent alerts and daily digest
  • Slack/cron orchestration for minion dispatch
• Minions are containerized agents that clone repos, work on issues, and create PRs
• Model Router routes simple tasks to lightweight models and complex tasks to heavyweight models
• Dashboard provides a Streamlit web UI for monitoring swarm activity
• PR Reviewer automatically reviews minion-created pull requests

Project Status

• Version: 2.3.0
• Python: 3.12+
• License: See repository
• 1219 tests passing (393 Overlord tests)

Architecture Overview

nebulus-atom/
├── nebulus_atom/          # Core CLI agent (MVC architecture)
│   ├── models/            # Data structures
│   ├── views/             # UI (Rich TUI)
│   ├── controllers/       # Orchestration
│   ├── services/          # Integrations (LLM, RAG, Skills)
│   └── main.py            # Entry point
│
├── nebulus_swarm/          # Multi-agent swarm system
│   ├── overlord/           # Meta-orchestrator
│   │   ├── registry.py         # Project config & dependency tracking
│   │   ├── scanner.py          # Git state & health across repos
│   │   ├── graph.py            # Dependency graph & blast radius
│   │   ├── memory.py           # Cross-project observation store
│   │   ├── autonomy.py         # Confidence scoring & auto-dispatch
│   │   ├── action_scope.py     # Scope evaluation for changes
│   │   ├── slack_commands.py   # Multi-project Slack commands
│   │   ├── proposal_manager.py # Approval workflow lifecycle
│   │   ├── overlord_daemon.py  # Background daemon & scheduler
│   │   ├── detectors.py        # Proactive issue detection
│   │   ├── notifications.py    # Alerts & daily digest
│   │   └── main.py             # Slack/Docker/State control plane
│   ├── minion/             # Worker agents (GitHub, LLM, Tools)
│   ├── dashboard/          # Streamlit monitoring UI
│   └── reviewer/           # Automated PR review
│
└── tests/                  # 1219 tests (pytest)