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
Sao
4
Công cụ
—
Thời gian hoạt động
—
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.
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Câu hỏi
Làm thế nào để cài đặt Apollo Agent?
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Apollo Agent có cần khóa API không?
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Apollo Agent dùng giao thức truyền tải nào?
Apollo Agent chạy cục bộ qua stdio.
Apollo Agent được kiểm tra lần cuối khi nào?
Kiểm tra lần cuối: 2026-11-05. AI-powered coding agent with semantic code understanding and structured reasoning