Ir al contenido

Chuletario de CLI

Una referencia densa de cada comando de apx. Una línea por comando, organizada para coincidir con apx --help. Para profundizar, seguí los enlaces del final.

apx
$ apx --help
  apx  Agent Project Context  v1.38.0
Docs: https://agentprojectcontext.com

Usage:  apx <command> [subcommand] [args] [--flags]

Bootstrap     init · setup · status · update
Projects      project add|list|remove|rebuild
Agents        agent add|list|get|remove · agent vault …
APX Profile   identity show|set|wizard
Config        config show|set · model · permission
Sessions      session new|list|resume|find · sessions list
MCPs          mcp list|add|remove|enable|run|tools|logs|check
Daemon        daemon start|stop|reload|status · log
Telegram      telegram send|status · messages tail|chat|search
LLM / Code    exec · chat · code · search
Runtimes      run --runtime … · env detect
Routines      routine add|list|run · task add|list|done
Voice         voice say|listen|providers · desktop · pair

Run 'apx <command> --help' for details.
apx --help mostrando todos los grupos de comandos

ComandoQué hace
apx init [path]Inicializa un nuevo proyecto APC (crea AGENTS.md + .apc/)
apx setupAsistente interactivo: proveedor → modelo → canales → daemon (alias: install)
apx statusEstado completo del sistema: daemon, super-agente, motores, Telegram, proyectos
apx updateBusca actualizaciones y actualiza (alias: upgrade)

ComandoQué hace
apx project add [path]Registra un proyecto con el daemon
apx project listLista los proyectos registrados
apx project remove <id>Desregistra un proyecto
apx project rebuild [id]Reconstruye el índice del proyecto desde el sistema de archivos

ComandoQué hace
apx agent add <slug>Crea un agente local del proyecto (--role R --model M --skills a,b --language L --description D)
apx agent listLista los agentes del proyecto
apx agent get <slug>Imprime la definición de un agente
apx agent importImporta una plantilla de agente desde ~/.apx/agents/
apx agent vault listLista las plantillas del vault (defaults incluidos + tus overrides)
apx agent vault addCrea una nueva plantilla de vault

ComandoQué hace
apx identity showImprime la identidad actual de APX (nombre, dueño, personalidad)
apx identity set <k> <v>Define un campo de identidad
apx identity wizardConfiguración interactiva de identidad

ComandoQué hace
apx config showImprime la config del proyecto (--effective para la vista combinada, --only-overrides para las diferencias)
apx config set <key.path> <value>Define un valor con reconocimiento de JSON en .apc/config.json
apx config unset <key.path>Elimina una clave
apx model statusSalud del proveedor + modelo activo (enrutador de fallback)
apx model order <p1> <p2> …Define el orden de fallback — p. ej. ollama openrouter groq
apx model key <provider> <api-key>Guarda una API key en ~/.apx/config.json
apx model set <provider> <model-id>Fija un id de modelo específico para un proveedor
apx model testResuelve qué modelo elige el enrutador ahora mismo
apx model enableHabilita el enrutador de fallback
apx model disableDeshabilita el enrutador de fallback (solo primario)
apx permission showMuestra el modo de permisos de herramientas de APX
apx permission set <mode>Define el modo: total | automatico | permiso

ComandoQué hace
apx memory <slug>Imprime el memory.md de un agente
apx memory <slug> --append "<note>"Agrega una nota bajo ## Recent context
apx memory <slug> --replaceReemplaza la memoria desde stdin

ComandoQué hace
apx session new <slug>Crea un archivo de sesión (--title T --task-ref REF --body -|"text")
apx session list [slug]Lista las sesiones (--last N)
apx session get <id>Imprime los metadatos o el cuerpo de la sesión (--body)
apx session update <id>Actualiza el frontmatter de la sesión (--status S --result R --title T)
apx session close <id>Marca una sesión como completa (--result "text")
apx session checkSale con código distinto de cero si ya existe una sesión activa
apx session close-staleCierra automáticamente las sesiones de más de 1 h
apx session resume <id>Muestra la sesión APC + transcript opcional (--summary --full)
apx session compact <slug>Colapsa el historial de conversación en un resumen
apx session find <text>Busca sesiones por título entre motores (--deep --engine X)
apx session summary <id>Resumen LLM de cualquier sesión por id
apx session ask <id> "<q>"Hace una pregunta sobre una sesión (--max-chunks N)
apx sessions listLista las sesiones de los motores de IA (--engine claude|codex|apx --project P)

ComandoQué hace
apx mcp listLista los servidores MCP del proyecto
apx mcp add <name>Agrega un servidor MCP propio del proyecto (--command <cmd> --env KEY=VAL)
apx mcp remove <name>Elimina un servidor MCP propio del proyecto
apx mcp enable <name>Habilita un servidor MCP propio del proyecto
apx mcp disable <name>Deshabilita un servidor MCP propio del proyecto
apx mcp run <name> <tool>Llama a una herramienta MCP ([<json-args>])
apx mcp tools <name> [<tool>]Lista las herramientas de un servidor; con <tool>, muestra schema + ejemplo listo (--json para schemas crudos)
apx mcp logs <name>Log de arranque/init + cola de stderr
apx mcp checkAudita el merge multi-fuente y los conflictos

ComandoQué hace
apx daemon startInicia el daemon
apx daemon stopDetiene el daemon
apx daemon restartDetiene y luego inicia — toma cambios de código, prompt y herramientas
apx daemon reloadSolo relee ~/.apx/config.json (sin reinicio, sin recarga de código)
apx daemon statusMuestra la salud del daemon
apx daemon logsImprime el final del log del daemon (--tail N)
apx logLog unificado de todos los módulos (-f seguir, --tail N, --errors solo)

ComandoQué hace
apx telegram send "text"Envía un mensaje (--chat <id>)
apx telegram statusMuestra el estado del plugin de Telegram
apx telegram startInicia el polling en cada canal configurado
apx telegram stopDetiene el polling (la config queda intacta)
apx telegram setupImprime la guía de configuración
apx telegram channel <sub>Gestiona canales: add | list | show | set | unset | remove
apx telegram contactsLista el roster de personas conocidas
apx telegram role <user_id> <role>Asigna un rol a un contacto
apx telegram roles <sub>Define rol→herramientas: list | set <name> --tools a,b | rm <name>
apx telegram owner <channel> <user_id>Define quién es dueño de un canal

ComandoQué hace
apx messages tailImprime los mensajes recientes (--agent <slug> --channel <ch> -n 50 --global)
apx messages chatTranscript de chat con tipos de actor (--channel telegram -n 50)
apx messages search "q"Busca en los logs de mensajes

ComandoQué hace
apx codeAsistente de codificación de terminal de APX (TUI)
apx exec "prompt"Llamada LLM one-shot al super-agente (--model <id> -a <agent>)
apx chat <agent>REPL interactivo de agente (--conversation <id>)
apx search "query"Búsqueda web vía DDG / Brave / navegador (--mode <m> -n N)
apx conversations listLista las conversaciones de exec/chat almacenadas
apx conversations get <agent> <id>Imprime una conversación almacenada

ComandoQué hace
apx run <agent>Lanza una sesión de runtime externo completa (--runtime <id> "prompt" --timeout <s>)
apx env detectMuestra qué CLIs de runtime están instalados

Runtimes disponibles: claude-code · codex · opencode · aider · cursor-agent · gemini-cli · qwen-code


ComandoQué hace
apx send <from> <to> "msg"Registra un mensaje A2A (--deliver ejecuta el motor de destino)
apx connections <agent>Mapa mental: con quién, cómo y cuándo se comunicó este agente

ComandoQué hace
apx routine listLista las rutinas con la próxima y la última ejecución
apx routine add <name>Crea una rutina
apx routine get <name>Imprime la definición de la rutina
apx routine history <name>Muestra el historial de ejecución
apx routine run <name>Dispara manualmente (ignora la programación)
apx routine enable <name>Habilita una rutina
apx routine disable <name>Deshabilita una rutina
apx routine remove <name>Elimina una rutina

ComandoQué hace
apx task add "<title>"Crea una tarea (--tag t --due 2026-06-01 --agent A --body "...")
apx task listLista las tareas (--state open|done|dropped|all --tag X --agent Y --limit N)
apx task show <id>Imprime una tarea como JSON
apx task done <id>Marca la tarea como hecha (--by <name>)
apx task drop <id>Descarta / archiva una tarea
apx task reopen <id>Reabre una tarea hecha o descartada
apx task patch <id>Edita campos (--title T --body B --due D --agent A --tag t)

ComandoQué hace
apx artifact create <name>Crea un archivo gestionado en el almacenamiento del proyecto (--content '...' --project 0)
apx artifact listLista los artefactos
apx artifact show <name>Imprime el contenido del artefacto
apx artifact remove <name>Elimina un artefacto

ComandoQué hace
apx command listLista los comandos de workflow en .apc/commands/
apx command show <name>Imprime el contenido del comando
apx skills add [targets]Instala skills en los archivos de reglas del IDE (claude-code cursor windsurf copilot trae)
apx skills add --globalInstala en ~/.claude/skills/ etc.
apx skills listLista las skills en el .apc/skills/ de este proyecto
apx skills statusMuestra qué targets de IDE tienen skills incluidas instaladas
apx skills syncFuerza el refresco de todas las skills incluidas a cada dir global de skills

ComandoQué hace
apx plugins listMuestra los plugins cargados y su estado
apx plugins status <id>Estado detallado de un plugin (p. ej. telegram)

ComandoQué hace
apx voice say "text"TTS vía daemon (--provider <id> --voice <name> --no-play)
apx voice listenMicrófono → /voice/turn → respuesta (--seconds N --no-play)
apx voice providersLista los proveedores de TTS / STT configurados
apx desktop startLanza la ventana de voz flotante de Electron (--debug)
apx desktop stopDetiene la ventana de escritorio
apx desktop statusMuestra el estado del proceso, PID y estado de autostart
apx desktop installActiva el autostart al iniciar sesión (no necesita sudo)
apx desktop uninstallDesactiva el autostart

ComandoQué hace
apx pair [label]Emparejamiento por QR para la app Deck / clientes compañeros
apx pair webQR + enlace para emparejar un navegador en la LAN
apx pair listLista los clientes emparejados
apx pair revoke <id>Revoca el token de un cliente emparejado

FlagEfecto
--project <name|id|path>Fija un comando a un proyecto específico
--helpMuestra la ayuda de cualquier comando
--versionImprime la versión