AgentValley, monitor de Claude Code en el Mac

¿Para qué sirve AgentValley?

AgentValley es una aplicación gratuita y de código abierto para ver qué hacen tus sesiones locales de Claude Code. Dicho de forma sencilla, coloca un pequeño puesto de control debajo de la muesca del MacBook: puedes saber quién trabaja y quién espera una respuesta sin recorrer todas las ventanas del terminal. Cada agente, incluidos los subagentes, tiene una fila y un personaje de píxeles. Requiere macOS 15 o posterior y Claude Code.

Instalación y primera sesión

1. Descarga el DMG oficial, arrastra AgentValley a Aplicaciones y ábrelo. También puedes usar brew install --cask morsechimwai/tap/agent-valley.
2. Inicia una sesión de Claude Code y apunta a la muesca para comprobar que aparecen su proyecto y última acción.
3. Desde otra aplicación, abre el panel con Control–Opción–Comando–A; elige una fila con las flechas y pulsa Retorno para volver a la sesión.
4. Si quieres contestar permisos en el panel, activa “Answer from the notch”, ejecuta el comando del plugin que ofrece Ajustes y reinicia Claude Code. Revisa la solicitud antes de elegir “Allow once” o “Deny”.

El plugin de respuestas es una configuración opcional y manual, distinta de la visualización de sesiones.

Localiza agentes y solicitudes de permiso

Las sesiones se agrupan por proyecto, incluidos sus worktrees. La tarjeta de cada sesión contiene filas con la tarea, el modelo y el último paso; los subagentes muestran también cuántos pasos han realizado. Esto permite distinguir la tarea principal de una exploración o planificación delegada.

Un contador rojo señala preguntas o solicitudes de permiso. Abre el panel para leerlas y salta a la aplicación correspondiente. La opción “Go to the session’s tab” permite localizar la pestaña en Terminal e iTerm2; en Ghostty puede resultar ambiguo si dos sesiones trabajan en la misma carpeta. Los sonidos vienen activados y se pueden desactivar o sustituir por un aviso sencillo.

Interpreta costes y límites de uso

El botón del gráfico abre History. Selecciona día, semana o mes y profundiza en las horas del día o las sesiones de un proyecto. Los importes usan precios de API: sirven para comparar consumo, no para sustituir la factura de tu suscripción. Puedes exportar un PDF de todos los proyectos o de uno concreto. El historial se conserva en el Mac aunque Claude Code borre archivos antiguos.

El panel muestra tokens de las últimas cinco horas y del día, además de un gráfico de doce horas. “Plan limits”, desactivado inicialmente, añade límites de cinco horas y semanales con el tiempo hasta el reinicio. A 25 de octubre de 2026, la aplicación es gratuita; el patrocinio es voluntario y el acceso a Claude Code se rige por sus propias condiciones.

Archivos locales y opciones de privacidad

La documentación pública indica que lee ~/.claude/projects, ~/.claude/sessions, procesos y datos Git del proyecto. Guarda sus datos en ~/Library/Application Support/AgentValley. Al activar “Plan limits”, accede al inicio de sesión de Claude Code en el Llavero y lo envía a api.anthropic.com. La consulta diaria de actualizaciones a GitHub se puede desactivar.

La línea de estado opcional del terminal modifica ~/.claude/settings.json, instala una fuente y puede añadir una línea a la configuración de Ghostty. Su comando de retirada deshace esos cambios. Conviene distinguir estas opciones del seguimiento básico; no hay una promesa de ausencia de conexiones de red en todas las configuraciones.

Cuándo merece la pena usarlo

Resulta útil si trabajas con varias sesiones locales y necesitas encontrar rápidamente la que requiere atención. Puedes mover el panel a una pantalla conectada desde Ajustes. Un estado “quiet” significa que no se ha escrito actividad durante dos minutos, no que se conozca un porcentaje de avance. El alcance documentado es Claude Code en Mac. El código de la app tiene licencia MIT y el proyecto es independiente de Anthropic.

Preguntas frecuentes

¿Es gratis AgentValley?

Sí. La app es gratuita y de código abierto; los patrocinios son opcionales. Esto no cambia las condiciones de acceso a Claude Code.

¿El coste mostrado es mi factura?

No necesariamente. Es una estimación basada en precios de API y puede diferir de lo que pagas según tu modalidad de acceso.

¿Necesito un plugin para ver las sesiones?

No para la visualización habitual. El plugin se instala manualmente si quieres permitir o denegar solicitudes desde el panel.

Descargas y ayuda oficiales

• Versiones y descargas oficiales
• Código fuente y guía de instalación
• GitHub Issues para incidencias