AI-powered coding agent with semantic code understanding and structured reasoning
AI-powered coding agent with semantic code understanding and structured reasoning
2026-11-05
Звёзды
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.
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Вопросы
Как установить Apollo Agent?
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Нужен ли API-ключ для Apollo Agent?
В этой записи не указано обязательных переменных окружения.
Какой транспорт использует Apollo Agent?
Apollo Agent работает локально через stdio.
Когда Apollo Agent проверялся в последний раз?
Последняя проверка: 2026-11-05. AI-powered coding agent with semantic code understanding and structured reasoning