AI-powered coding agent with semantic code understanding and structured reasoning
AI-powered coding agent with semantic code understanding and structured reasoning
星标
4
工具
—
可用率
—
Apollo Agent integrates cutting-edge MCP (Model Context Protocol) servers with OpenRouter LLMs to provide intelligent, context-aware assistance for software development tasks. It combines semantic code analysis (Serena), structured problem-solving (Sequential Thinking), and powerful language models to understand and manipulate codebases at a deep level.
🎯 Features
🔍 Semantic Code Analysis - Understands code structure, symbols, and relationships via Serena MCP
🧠 Structured Reasoning - Plans and executes multi-step tasks systematically
📚 Knowledge Base - Maintains context and learnings across sessions
🔧 Terminal Integration - Execute commands with smart sudo handling
📊 Symbol Indexing - Fast code navigation and search
# Clone the repository
git clone https://github.com/AlexandrosLiaskos/apollo-agent.git
cd apollo-agent
# Install dependencies
npm install
# Configure environment
cp .env.example .env
nano .env # Add your OPENROUTER_API_KEY
# Start Apollo
npm start
First Run
On first startup, Apollo will:
Initialize Serena MCP server (via uvx)
Initialize Sequential Thinking MCP server
Connect to OpenRouter
Create a terminal session
Load available tools (30+ from MCP servers)
█████╗ ██████╗ ██████╗ ██╗ ██╗ ██████╗
██╔══██╗██╔══██╗██╔═══██╗██║ ██║ ██╔═══██╗
███████║██████╔╝██║ ██║██║ ██║ ██║ ██║
██╔══██║██╔═══╝ ██║ ██║██║ ██║ ██║ ██║
██║ ██║██║ ╚██████╔╝███████╗███████╗╚██████╔╝
╚═╝ ╚═╝╚═╝ ╚═════╝ ╚══════╝╚══════╝ ╚═════╝
AI Agent with MCP Integration
✔ OpenRouter initialized (model: anthropic/claude-sonnet-4)
✔ Connected to all MCP servers
✔ Loaded 30 tools from MCP servers
? 🚀 Task (or "exit" to quit):
📖 Usage
Interactive Mode
Apollo provides an interactive CLI where you can:
Give tasks:
? 🚀 Task: Refactor the UserService class to use async/await
Use commands:
status - Show agent status
tasks - View current task list
knowledge - List knowledge entries
symbols - Show symbol index stats
search <name> - Search for symbols
help - Show all commands
exit - Quit Apollo
Example Tasks
Code Analysis:
? Task: Find all uses of the calculateTotal function
? Task: Show me the structure of the UserController class
? Task: List all API endpoints in this project
Code Modification:
? Task: Add error handling to the login method
? Task: Convert all var declarations to const/let
? Task: Add TypeScript types to user.js
System Operations:
? Task: Install and configure the axios package
? Task: Update all dependencies to latest versions
? Task: Set up ESLint with standard config
🛠️ Configuration
Environment Variables
Edit .env:
# OpenRouter Configuration (REQUIRED)
OPENROUTER_API_KEY=your_api_key_here
# Model Selection (optional)
OPENROUTER_MODEL=anthropic/claude-sonnet-4
# Sudo Configuration (see below)
SUDO_MODE=auto # auto | nopasswd | interactive | password
Sudo Commands
Apollo can execute sudo commands. Configure via SUDO_MODE:
Option 1: Auto (Default)
SUDO_MODE=auto
Tries passwordless sudo first, falls back to interactive if needed.
Option 2: Passwordless Sudo (Recommended)
# Configure system for passwordless package management
sudo visudo
# Add (replace 'user' with your username):
user ALL=(ALL) NOPASSWD: /usr/bin/pacman
user ALL=(ALL) NOPASSWD: /usr/bin/apt-get
user ALL=(ALL) NOPASSWD: /usr/bin/dnf
# Then in .env:
SUDO_MODE=nopasswd
Option 3: Interactive
SUDO_MODE=interactive
Apollo pauses and prompts for password when needed.
Option 4: Password in Env (⚠️ Less Secure)
SUDO_MODE=password
SUDO_PASSWORD=your_password
Only for personal development with disk encryption.