ai-cli-log is a command-line interface (CLI) tool designed to streamline the process of logging interactions with AI models, such as Gemini and Claude. This tool captures all terminal interactions seamlessly, transforming them into well-structured Markdown documents for efficient review and documentation.

Key Features

• Interactive Session Capture: Functions as a wrapper for various CLI tools, logging complete interactive sessions, including user inputs and accurately rendered output. This ensures the terminal experience is preserved, complete with details such as cursor movements and backspaces.
• Accurate Logging: Utilizes node-pty for precise pseudo-terminal emulation and @xterm/headless for parsing ANSI escape codes, enabling faithful representation of what appears on the terminal.
• Markdown Output: Automatically saves captured sessions in clean Markdown format, enhancing readability and making documentation straightforward.
• Built with TypeScript: Developed with Node.js and TypeScript, leveraging a robust ecosystem for enhanced type safety and robust CLI functionality.

Usage

To initiate a logging session with any command, simply wrap it with ai-cli-log. For example, to log a session with Google's Gemini CLI, use:

ai-cli-log gemini

Similarly, logging a session with another tool, like Claude, can be achieved with:

ai-cli-log claude

The recorded session will then be stored as a Markdown file in the .ai-cli-logs directory, named according to the timestamp of the session, such as .ai-cli-logs/session-YYYYMMDD-HH:mm:ss.md.

Development Insights

The development of ai-cli-log was assisted by Google Gemini. The .ai-cli-logs directory contains comprehensive logs of the development process, beginning from log file 0001.md, providing insight into the interactions that shaped this tool.

Future Enhancements

Planned improvements include refining the output format for better Markdown compatibility, implementing content handling to prevent empty logs, and enhancing the filename convention for better organization while maintaining information security.

ai-cli-log empowers developers to easily document their AI-powered coding efforts, providing a resource for better insights and record-keeping.