Tokendraw es una herramienta de línea de comandos diseñada para estimar el consumo energético y las emisiones de carbono asociadas al uso de agentes de codificación basados en modelos de lenguaje de gran escala (LLM). El software analiza los registros de ejecución de herramientas populares como Claude Code, Codex y pi, así como de adaptadores personalizados para otros sistemas. Al revisar estos logs, el programa cuenta los tokens utilizados en cada llamada al modelo y calcula la electricidad necesaria para servir esas peticiones, derivando así las emisiones resultantes de la generación de esa energía.
La herramienta no incluye actualmente la estimación de las emisiones encarnadas, como las derivadas de la fabricación de hardware, el entrenamiento de modelos o el uso de agua. Tokendraw se instala mediante npm o cargo y permite a los desarrolladores asignar llamadas a proyectos específicos para mejorar la precisión de los informes. El sistema lee los logs desde variables de entorno específicas de cada agente, como $CLAUDE_CONFIG_DIR para Claude Code o $CODEX_HOME para Codex. Para agentes que no son compatibles con los formatos estándar, los usuarios pueden crear adaptadores en formato TOML que definen cómo leer los registros de JSON lines o ejecutar comandos externos.
El proyecto está construido en Rust y utiliza SQLite para el almacenamiento local de datos. No realiza solicitudes de red ni envía telemetría, garantizando la privacidad del usuario. La herramienta requiere un compilador de C para construir los binarios precompilados, que incluyen datos de energía y emisiones actualizados. Los usuarios pueden personalizar los datos de entrada mediante archivos TOML en la carpeta de configuración, y el código fuente, licenciado bajo MIT, permite la contribución y la auditoría de las estimaciones realizadas.