Protocolo ACP

Muchos editores de código pueden alojar un asistente externo en su propio panel de chat. Hablan con él en un idioma común, el Agent Client Protocol (ACP). Pando lo habla, así que puedes usarlo sin salir de tu editor. Esta página es material de referencia: el fragmento para cada editor, comandos y ajustes.

Para ir paso a paso, mira la guía Usa Pando desde tu editor y otras aplicaciones. Las opciones más finas están en Configuración ACP avanzada.

Inicio rápido

Inicia Pando como servidor ACP (modo stdio, para editores):

pando acp

Configuración en editores

VS Code

Añade a tu settings.json:

{
  "agent_servers": {
    "Pando": {
      "command": "pando",
      "args": ["acp"]
    }
  }
}

Zed

Añade a ~/.config/zed/settings.json:

{
  "agent_servers": {
    "Pando": {
      "command": "pando",
      "args": ["acp"]
    }
  }
}

JetBrains IDEs

Añade a tu acp.json:

{
  "agent_servers": {
    "Pando": {
      "command": "/ruta/a/pando",
      "args": ["acp"]
    }
  }
}

Configuración ACP

Configura el comportamiento ACP en .pando.toml:

[acp]
enabled = true
max_sessions = 10
idle_timeout = "30m"
log_level = "info"
auto_permission = false  # usar true en entornos CI/batch

Comandos de gestión

# Iniciar servidor ACP (stdio, para editores)
pando acp

# Iniciar con flags explícitos
pando acp start --debug --cwd /ruta/al/proyecto

# Ver estado del servidor (modo HTTP)
pando acp status

# Listar sesiones activas
pando acp sessions

# Ver estadísticas del servidor
pando acp stats

# Detener el servidor
pando acp stop

Transportes

Pando ACP soporta dos transportes:

• Stdio: Para uso como subproceso desde editores
• HTTP + SSE: Para actualizaciones en tiempo real via Server-Sent Events

# Deshabilitar stdio
pando mcp-server --no-stdio

# Deshabilitar HTTP
pando mcp-server --no-http

Checklist de Tareas Activas y Planificación

Cuando se integra con tu editor de código preferido a través de ACP, Pando muestra una Lista de Tareas Activa directamente dentro de la interfaz del editor. Esto proporciona una total transparencia sobre las acciones que está realizando el agente:

• Pasos en tiempo real: Visualiza de antemano qué archivos planea modificar el agente y el estado de cada tarea.
• Toma de decisiones integrada: Aprueba o realiza ajustes en el plan de trabajo del agente antes de que comience a ejecutar cambios.
• Limpieza de sesiones inactivas: Pando depura de forma inteligente sesiones inactivas de larga duración para optimizar el rendimiento de tu sistema.

Características de seguridad

• Validación de rutas para evitar acceso fuera del directorio del proyecto
• Sistema de permisos para la ejecución de herramientas
• Modo de auto-aprobación para entornos de confianza