by EvolutionAPI
The open source operating system for AI-powered businesses — built on Claude Code
# Add to your Claude Code skills
git clone https://github.com/EvolutionAPI/evo-nexusDisclaimer: EvoNexus is an independent, unofficial open-source project. It is not affiliated with, endorsed by, or sponsored by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic, PBC. This project integrates with Claude Code as a third-party tool and requires users to provide their own installation and credentials.
EvoNexus is an open source, unofficial toolkit compatible with Claude Code and other LLM tooling. It is designed to integrate with Claude Code capabilities: native agents, skills, slash commands, MCP integrations, and the Claude CLI.
It turns a single Claude Code installation into a team of 37 specialized agents organized in two ortogonal layers — 16 business agents (operations, finance, community, marketing, HR, legal, product, data) and 21 engineering agents (architecture, planning, code review, testing, debugging, security, design, cycle orchestration, retrospective — 19 derived from oh-my-claudecode, MIT, by Yeachan Heo + 2 native: Helm and Mirror). The engineering layer follows a canonical 6-phase workflow documented in .claude/rules/dev-phases.md. Each agent has its own domain, skills, persistent memory, and automated routines. The result is a production system that runs daily operations for a founder/CEO and supports software development workflows: from morning briefings to financial reports, community monitoring, social analytics, end-of-day consolidation, plus architectural reviews, code audits, and verified implementation pipelines.
This is not a chatbot. It is a real operating layer that runs routines, generates HTML reports, syncs meetings, triages emails, monitors community health, tracks financial metrics, and consolidates everything into a unified dashboard — all automated.
.md files with system prompts, not code/clawdia, /flux, /pulse invoke agents directlycustom-* agents (gitignored)social-, fin-, int-, prod-, mkt-, gog-, obs-, discord-, pulse-, sage-, hr-, legal-, ops-, cs-, data-, pm-). Includes prod-activation-plan — the canonical skill for producing phased activation plans (index + folder-per-phase + file-per-item) used by OracleConnect your existing tools via MCP servers, API clients, or OAuth:
| Integration | Type | What it does |
|---|---|---|
| Google Calendar | MCP | Read/create/update events, find free time |
| Gmail | MCP | Read, draft, send emails, triage inbox |
| GitHub | MCP + CLI | PRs, issues, releases, code search |
| Linear | MCP | Issues, sprints, project tracking |
| Discord | API | Community messages, channels, moderation |
| Telegram | MCP + Bot | Notifications, messages, commands |
| Stripe | API | Charges, subscriptions, MRR, customers |
| Omie | API | ERP — clients, invoices, financials, stock |
| Bling | API (OAuth2) | Brazilian ERP — products, orders, NF-e, contacts, stock (auto-refresh via make bling-auth) |
| Asaas | API | Brazilian payments — Pix, boleto, credit card, subscriptions, marketplace split |
| Fathom | API | Meeting recordings, transcripts, summaries |
| Todoist | CLI | Task management, priorities, projects |
| YouTube | OAuth | Channel stats, videos, engagement |
| Instagram | OAuth | Profile, posts, engagement, insights |
| LinkedIn | OAuth | Profile, org stats |
| Canva | MCP | Design and presentations |
| Notion | MCP | Knowledge base, pages, databases |
| Obsidian | CLI | Vault management, notes, search |
| Evolution API | API | WhatsApp messaging — instances, messages, chats, groups |
| Evolution Go | API | WhatsApp messaging (Go implementation) |
| Evo CRM | API | AI-powered CRM — contacts, conversations, pipelines |
Social media accounts (YouTube, Instagram, LinkedIn) are connected via OAuth through the dashboard.
| Tool | Required | Install |
|------|----------|---------|
| Claude Code | Yes | npm install -g @anthropic-ai/claude-code (docs) |
| Python 3.11+ | Yes | via uv: curl -LsSf https://astral.sh/uv/install.sh \| sh |
| Node.js 18+ | Yes | nodejs.org |
| uv | Yes | curl -LsSf https://astral.sh/uv/install.sh \| sh |
The setup wizard (make setup) checks for all prerequisites before proceeding.
Starting out? After installing, open Claude Code and call
/oracle. It's the official entry point of EvoNexus: runs the initial setup, interviews you about your business, shows what the toolkit can automate for you, and delivers a phased activation plan — an index file at the top + one folder per phase + one file per item, each with suggested agent team, dependencies, and pending decisions. The plan is materialized by theprod-activation-planskill (workspace canonical pattern) so you never have to guess the next step.
npx @evoapi/evo-nexus
This downloads and runs the interactive setup wizard automatically.
git clone https://github.com/EvolutionAPI/evo-nexus.git
cd evo-nexus
# Interactive setup wizard — checks prerequisites, creates config files
make setup
The wizard:
config/workspace.yaml, .env, CLAUDE.md, and workspace foldersnano .env
Add keys for the integrations you enabled. Common ones:
# Discord (for community monitoring)
DISCORD_BOT_TOKEN=your_token
DISCORD_GUILD_ID=your_guild_id
# Stripe (for financial routines)
STRIPE_SECRET_KEY=sk_live_...
# Telegram (for notifications)
TELEGRAM_BOT_TOKEN=your_token
TELEGRAM_CHAT_ID=your_chat_id
# Social media (connect via dashboard Integrations page)
SOCIAL_YOUTUBE_1_API_KEY=...
SOCIAL_INSTAGRAM_1_ACCESS_TOKEN=...
See .env.example for all available variables.
make dashboard-app
Open http://localhost:8080 — the first run shows a setup wizard where you:
make scheduler
Runs all enabled routines on schedule (morning briefing, email triage, community pulse, financial reports, etc). Configure schedules in config/routines.yaml.
/oracleOpen Claude Code in the project directory — it reads CLAUDE.md automatically. The first thing you should do is call /oracle:
/oracle
Oracle will:
prod-activation-plan skill — creates an index file + phase folders + item files, each with suggested agent team, deNo comments yet. Be the first to share your thoughts!