MORAGENT — AI Agent Studio

█▀▄▀█ █▀█ █▀█ ▄▀█ █▀▀ █▀▀ █▄░█ ▀█▀
█░▀░█ █▄█ █▀▄ █▀█ █▄█ ██▄ █░▀█ ░█░
─────────────────────────────────────────────
 AI AGENT STUDIO · v3.0.0 · Bilingual ES/EN
─────────────────────────────────────────────

Design, learn, and deploy agentic AI projects in Claude Code. Documentación en español más abajo ↓

You: /moragent
Claude: 10-option guided menu → learn agentic AI, create projects,
        agents & skills, quality-check your outputs... in ES or EN.

What is MORAGENT?

MORAGENT is an MCP plugin for Claude Code that turns it into a full AI Agent Studio. It provides 12 tools and a guided menu (/moragent) that helps you understand, structure, create, and operate multi-agent projects — without writing any code.

It works by scanning your workspace, understanding what agents and skills you already have, and recommending what to create next — including which orchestration pattern fits your project (pipeline, parallel, orchestrator-workers, evaluator-optimizer, router). Think of it as an opinionated framework that enforces good practices: reuse over duplication, quality gates before delivery, and teaching through analogies.

Fully bilingual: switch between Spanish and English anytime with /moragent english or /moragent espanol. Menu, lessons, glossary, and generated templates all follow your language.

Related MCP server: TRUSS MCP Server

Who is it for?

You don't need to code. Just install Claude Code, type /moragent, and follow the menu.

Quick Start

Requirements

• Claude Code installed

• Python 3.10+

Get started (macOS / Linux)

git clone https://github.com/EduardoMoraga/moragent.git
cd moragent
claude

That's it — two commands and open Claude Code. When Claude Code asks to enable the moragent MCP server, say yes. On first launch, run_server.py automatically creates a local .venv and installs mcp[cli] inside it (30-60s, one time only) — no global pip install, no PEP 668 "externally-managed-environment" errors. Then type /moragent and you're in.

Optional: if you prefer managing the dependency yourself, python3 -m pip install "mcp[cli]" (or pip install -r requirements.txt) before launching also works — the launcher uses your interpreter directly when mcp is already available.

If the very first connection times out while the environment is being created (slow network), just reconnect with /mcp — the setup is self-healing and resumes where it left off.

Get started (Windows)

Same steps, but on Windows the Python launcher is usually python (not python3). Tell the MCP server which interpreter to use by setting PYTHON_CMD once, then launch:

git clone https://github.com/EduardoMoraga/moragent.git
cd moragent
setx PYTHON_CMD python   # one-time; open a NEW terminal afterward
claude

.mcp.json resolves the interpreter as ${PYTHON_CMD:-python3} — it defaults to python3 (macOS/Linux) and falls back to whatever you set in PYTHON_CMD (e.g. python on Windows).

Install in an existing project

cd my-project
python /path/to/moragent/install.py
claude

The installer copies server.py, creates .mcp.json, and installs the /moragent skill in your project.

Tools (12 MCP tools)

Menu (/moragent)

 LEARN
   1 · Workspace tour       First time? Start here
   2 · Lessons              8 lessons: patterns, skills, context...
   3 · Glossary             25 agentic AI concepts

 CREATE
   4 · New project          Your idea → architecture + structure
   5 · Create agent         Specialist with role, model and memory
   6 · Create skill         Reusable procedure (/name)

 OPERATE
   7 · My infrastructure    Dashboard of agents, skills, memories
   8 · Enrich               Diagnose and improve agents/skills
   9 · Quality check        Checklist before delivering
  10 · Find references      Prior work as a starting point

Orchestration Patterns

MORAGENT teaches and recommends the 5 core patterns from Anthropic's Building Effective Agents:

The advisor recommends the right pattern for your project — and always starts with the simplest one that works.

Architecture

You type something
       |
       v
  Orchestrator (your session + CLAUDE.md)
  Picks a pattern and decides which agents to launch
       |
       v
  Agent activates:
    1. Reads CLAUDE.md (global context)
    2. Reads its identity (.claude/agents/*.md — description drives delegation)
    3. Reads its memory (.claude/agent-memory/)
    4. Executes and returns result
       |
       v
  You receive consolidated output

Workspace structure

my-project/
  CLAUDE.md                    <-- Orchestrator handbook (project brain)
  .claude/
    agents/
      data-analyst.md          <-- Agent identity (frontmatter: name, description, model)
      report-writer.md
    skills/
      etl-run/
        SKILL.md               <-- Reusable procedure (modern format)
    agent-memory/
      data-analyst/
        MEMORY.md              <-- Persistent memory
    moragent.json              <-- MORAGENT config (language)
  .mcp.json                    <-- MCP server config

Key Concepts

Full glossary: 25 terms via moragent_glossary.

Orchestration Protocol

MORAGENT injects an orchestration protocol into every Claude Code session:

1. Before starting a project — call moragent_advisor to scan infra and recommend architecture + pattern

2. Before delivering output — call moragent_quality_check to verify quality

3. Before starting from scratch — call moragent_find_references to find prior work

4. After scaffolding — call moragent_enrich on each agent to ensure quality

5. When creating agents — reuse existing ones first; 3 focused agents > 10 generic ones

FAQ

Q: Does MORAGENT send my data anywhere? A: No. It runs 100% locally as a Python MCP server. It only reads/writes files in your project directory. No API calls, no telemetry. The only network access is the one-time download of mcp[cli] from PyPI during first-run setup.

Q: Can I use it with models other than Claude? A: Not currently. MORAGENT is built specifically for Claude Code's MCP protocol.

Q: What if I already have agents and skills? A: MORAGENT scans your existing infrastructure first and recommends reusing what you have before creating anything new.

Q: How do I switch languages? A: /moragent english or /moragent espanol — the setting persists in .claude/moragent.json.

Q: How do I update? A: If you cloned the repo: cd moragent && git pull — then restart Claude Code. If you installed into a project with install.py: pull the repo and re-run python /path/to/moragent/install.py in your project (it updates server.py, refreshes the skill, and migrates any legacy files from v2). Your language setting is preserved.

Q: Can I contribute? A: Yes! See CONTRIBUTING.md.

🇪🇸 Documentación en Español

¿Qué es MORAGENT?

MORAGENT es un plugin MCP para Claude Code que lo convierte en un AI Agent Studio completo. Proporciona 12 herramientas y un menú guiado (/moragent) que te ayuda a entender, estructurar, crear y operar proyectos multi-agente — sin escribir código.

Escanea tu workspace, entiende qué agentes y skills ya tienes, y recomienda qué crear — incluyendo qué patrón de orquestación conviene a tu proyecto (pipeline, paralelo, orchestrator-workers, evaluator-optimizer, router).

100% bilingüe: cambia entre español e inglés cuando quieras con /moragent english o /moragent espanol. Menú, lecciones, glosario y plantillas generadas siguen tu idioma.

¿Para quién es?

• Principiantes: Aprende qué es un agente, una skill, un CLAUDE.md — con analogías simples, en tu idioma.

• Intermedios: Crea proyectos completos con agentes y skills en minutos.

• Avanzados: Patrones de orquestación, quality gates, búsqueda de referencias, diagnóstico de agentes.

No necesitas saber programar. Solo necesitas Claude Code y escribir /moragent.

Instalación (macOS / Linux)

git clone https://github.com/EduardoMoraga/moragent.git
cd moragent
claude

Eso es todo — dos comandos y abrir Claude Code. Cuando pregunte si habilitas el servidor MCP moragent, di que sí. En el primer arranque, run_server.py crea automáticamente un .venv local e instala mcp[cli] adentro (30-60s, solo una vez) — sin pip global, sin errores de "externally-managed-environment". Después escribe /moragent y listo.

Si la primera conexión expira mientras se crea el entorno (red lenta), reconecta con /mcp — el setup se auto-repara y continúa donde quedó.

Instalación (Windows)

Los mismos pasos, pero en Windows el intérprete suele ser python (no python3). Indícaselo con PYTHON_CMD una sola vez:

git clone https://github.com/EduardoMoraga/moragent.git
cd moragent
setx PYTHON_CMD python   # una vez; abre una terminal NUEVA después
claude

Instalar en un proyecto existente

cd mi-proyecto
python /ruta/a/moragent/install.py
claude

Menú (/moragent)

 APRENDE
   1 · Tour del workspace   ¿Primera vez? Empieza acá
   2 · Lecciones            8 lecciones: patrones, skills, contexto...
   3 · Glosario             25 conceptos de IA agéntica

 CREA
   4 · Nuevo proyecto       Tu idea → arquitectura + estructura
   5 · Crear agente         Especialista con rol, modelo y memoria
   6 · Crear skill          Procedimiento reutilizable (/nombre)

 OPERA
   7 · Mi infraestructura   Dashboard de agentes, skills, memorias
   8 · Enriquecer           Diagnostica y mejora agentes/skills
   9 · Verificar calidad    Checklist antes de entregar
  10 · Buscar referencias   Trabajo previo como punto de partida

Los 5 patrones de orquestación

Conceptos clave

Glosario completo: 25 términos vía moragent_glossary.

Preguntas frecuentes

¿MORAGENT envía mis datos a algún lado? No. Corre 100% local como servidor MCP en Python. Solo lee/escribe archivos en tu proyecto. Sin llamadas a APIs, sin telemetría. El único acceso a red es la descarga única de mcp[cli] desde PyPI durante el setup inicial.

¿Cómo cambio el idioma? /moragent english o /moragent espanol — la preferencia persiste en .claude/moragent.json.

¿Cómo actualizo? Si clonaste el repo: cd moragent && git pull — y reinicia Claude Code. Si lo instalaste en un proyecto con install.py: actualiza el repo y vuelve a correr python /ruta/a/moragent/install.py en tu proyecto (actualiza server.py, refresca el skill y migra los archivos legacy de v2). Tu idioma configurado se conserva.

License

MIT — Eduardo Moraga, 2026

Contributing

See CONTRIBUTING.md for guidelines.