Crear herramientas de línea de comandos para explorar logs del asistente de codificación de IA (Claude Code & Codex CLI)

Explora logs de forma eficiente con Claude Code & Codex CLI. Optimiza la gestión de registros y simplifica el análisis de datos. Herramienta imprescindible para desarrolladores y administradores de sistemas.

19 dic 2025 • 3 min read • Q2BSTUDIO Team

Exploración de logs con Claude Code & Codex CLI

Problema Encontrar sesiones anteriores de asistentes de codificación por IA puede ser tedioso cuando los registros están dispersos en directorios anidados. Claude Code guarda registros en ~/.claude/projects/PROJECT_HASH/*.jsonl y Codex CLI en ~/.codex/sessions/YYYY/MM/DD/*.jsonl, y navegar manualmente por estas carpetas hace perder tiempo y contexto sobre prompts y soluciones que ya funcionaron.

Solución Hemos desarrollado dos scripts de shell simples para explorar esos logs de forma interactiva usando fzf y jq: claude-logs para Claude Code y codex-logs para OpenAI Codex CLI. Cada herramienta es un único fichero ligero que funciona sin complicaciones y permite buscar, previsualizar y formatear conversaciones almacenadas en JSONL.

Comandos principales sin parámetros lanzan el modo interactivo con fzf para seleccionar proyecto y sesión. Opciones útiles incluyen list para mostrar todos los proyectos o meses, latest para ver la sesión más reciente, tail para visualizar en tiempo real la sesión activa y status para comprobar si el CLI está corriendo.

Demostración rápida Modo interactivo ejecutar claude-logs seleccionar proyecto con fzf seleccionar sesión con fzf ver conversación formateada. Monitorización en tiempo real ejecutar claude-logs tail ver la sesión activa en directo Ctrl+C para salir. Comprobación de estado ejecutar claude-logs status mostrará si Claude Code está en ejecución y listará sesiones recientes.

Formato de salida Los logs JSONL se transforman en conversaciones legibles con marcas claras para roles como USUARIO y CLAUDE o CODEX y con indicación de herramientas propuestas por el asistente. Para Codex CLI se añade información del proyecto y la rama git cuando está disponible.

Instalación Requisitos previos instalar fzf y jq por ejemplo con brew install fzf jq. Para instalar claude-logs clonar el repositorio ejecutar chmod +x claude-logs/claude-logs y copiar el script a ~/.local/bin/. Para codex-logs clonar el repositorio ejecutar chmod +x codex-logs/codex-logs y copiar a ~/.local/bin/. Asegurarse de que ~/.local/bin está en PATH para poder invocar los comandos desde cualquier terminal.

Cómo funciona Escanea la estructura de directorios de logs, parsea archivos JSONL con jq para extraer mensajes, muestra opciones y previsualizaciones con fzf y formatea la salida con colores ANSI para facilitar la lectura. La función de previsualización de fzf permite ver fragmentos de conversación antes de abrir el archivo completo.

Casos de uso referencia Revisitar soluciones anteriores para reutilizar fragmentos de código o ideas. Reutilizar prompts efectivos para ahorrar tiempo en futuros proyectos. Revisión diaria de trabajos realizados con asistentes IA. Depuración cuando el CLI de IA se comporta de forma inesperada.

Limitaciones Actualmente diseñadas para macOS puesto que usan stat -f para timestamps. El soporte para Linux requeriría adaptar la llamada a stat con --format. Aceptamos contribuciones y pull requests para ampliar compatibilidad.

Sobre Q2BSTUDIO En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones basadas en inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y automatización de procesos. Diseñamos software a medida y aplicaciones a medida que integran agentes IA, ia para empresas y soluciones de Business Intelligence como Power BI para optimizar procesos y decisiones. Si te interesa potenciar tu proyecto con modelos de conversación y flujos automatizados podemos ayudarte con arquitectura, integración y despliegue.

Servicios recomendados Explora nuestros servicios de Inteligencia artificial para desplegar agentes IA y soluciones de ia para empresas. Para proyectos que requieren plataformas y aplicaciones a medida visita nuestra página de desarrollo de aplicaciones y software a medida. También ofrecemos ciberseguridad y pentesting, consultoría cloud en AWS y Azure, y servicios de inteligencia de negocio y Power BI para mejorar la visibilidad y el control sobre datos.

Conclusión Si usas Claude Code o Codex CLI con frecuencia, estos scripts simplifican el acceso a tus conversaciones de IA, ayudan a reutilizar prompts efectivos y aceleran la resolución de problemas. En Q2BSTUDIO combinamos experiencia en desarrollo de software, inteligencia artificial y ciberseguridad para ofrecer soluciones integrales que mejoran la productividad y la seguridad de tus proyectos. Si quieres soporte para integrar este tipo de herramientas en tu flujo de trabajo empresarial contacta con nosotros para una consultoría personalizada.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat