Ir al contenido
APX

Inicio rápido

Este recorrido te lleva desde un proyecto vacío hasta un agente en ejecución en pocos minutos.

  1. Inicializá un proyecto. En cualquier directorio que quieras que APX gestione:

    Ventana de terminal
    apx init --name "My Project"

    Esto crea la carpeta .apc/ y un AGENTS.md. Mirá Proyectos para ver qué queda en disco.

  2. Agregá un agente. Dale un slug, un rol y un modelo:

    Ventana de terminal
    apx agent add sofia --role "backend reviewer" --model ollama:llama3.2:3b
    apx 
    $ apx agent add sofia --role 'backend reviewer' --model ollama:llama3.2:3b
Added agent sofia
Role: backend reviewer
Model: ollama:llama3.2:3b
✓ wrote .apc/agents/sofia.md
✓ created runtime dir .apc/runtime/agents/sofia/
• rebuilt project #1 (5 agents)
    apx agent add creando el agente sofia y escribiendo .apc/agents/sofia.md

  3. Ejecutá el agente a través de un runtime completo. Esto lanza una CLI de programación externa (acá, Claude Code) con el system prompt del agente inyectado:

    Ventana de terminal
    apx run sofia --runtime claude-code "Review the open PRs and summarize them"

    ¿Preferís una respuesta rápida de una sola vez del LLM? Usá exec:

    Ventana de terminal
    apx exec sofia "What is my role in this project?"

  4. Observá lo que pasa. Seguí el registro de mensajes a través de todos los canales:

    Ventana de terminal
    apx messages tail
    apx 
    $ apx messages tail
2026-06-14 09:31:02  → runtime    sofia: spawned claude-code (exit 0, 4.2s)
2026-06-14 09:31:06  ← user       alex: What is my role in this project?
2026-06-14 09:31:08  → agent      sofia: I'm the backend reviewer — I check PRs
2026-06-14 09:32:14  → super-agent roby: routed 1 task to sofia
• 4 mensajes · canal: all
    apx messages tail mostrando actividad de runtime y exec con los tipos de actor

El asistente interactivo

Sección titulada «El asistente interactivo»

¿Preferís que te guíen? apx setup te lleva por provider → modelo → canales → daemon en un solo flujo:

Ventana de terminal
apx setup
apx 
$ apx setup
  Setup Wizard — configure daemon, model, and channels

Enable super-agent? [Y/n] y

AI Provider:
  1. Anthropic (Claude)
  2. OpenAI (GPT)
  3. Ollama (local / self-hosted)
  4. Gemini (Google)

Choose [1-4]: 1
Anthropic API key (sk-ant-...): ••••••••••••

Model:
  1. claude-sonnet-4-5
  2. claude-haiku-4-5
  3. claude-opus-4-5

Choose [1-4]: 1
› claude-sonnet-4-5

✓ Config saved to ~/.apx/config.json
Starting daemon... running ✓
✅ APX is ready! — http://127.0.0.1:7430
asistente apx setup: eligiendo un provider y un modelo

Siguiente

Sección titulada «Siguiente»