co-tokens

Analyze Claude Code and Codex session tokens in Colony tasks.

3|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/opencue/colony --skill co-tokens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: co-tokens
Source: https://github.com/opencue/colony/tree/main/skills/tokens
Command: npx skills add https://github.com/opencue/colony --skill co-tokens

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps manage and optimize Claude Code and Codex session tokens within Colony tasks, providing insights into token usage and suggesting improvements.

Core Features & Use Cases

  • Token Attribution: Accurately attribute token usage to specific tasks.
  • Feedback & Suggestions: Offers actionable feedback on token usage patterns and suggests improvements.
  • Use Case: When you want to understand how many tokens a task consumed, identify expensive sessions, or find ways to improve token efficiency.

Quick Start

Run the co-tokens skill with the latest session data using the command: python3 scripts/colony-token-analyzer.py --latest

Frequently Asked Questions about co-tokens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze token usage in Claude Code and Codex sessions?

To analyze token usage, you can run the colony-token-analyzer.py script against your session JSONL files to get detailed token attribution and actionable feedback for your Colony tasks.

What's the best way to attribute token consumption to specific Colony tasks?

Attributing token consumption to specific Colony tasks requires parsing session JSONL files, which allows you to accurately map token usage and identify expensive sessions for optimization.

Do I need Python to run token analysis on Codex session files?

Yes, you need Python installed to execute the token analysis scripts and process the session JSONL files and Colony data required for generating token usage insights.

How does session token analysis help optimize Claude Code workflows?

Session token analysis optimizes Claude Code workflows by identifying expensive sessions and providing actionable feedback on token usage patterns to improve overall token efficiency.

Can I identify expensive Claude Code sessions using JSONL files?

Yes, you can identify expensive sessions by analyzing your session JSONL files, which reveals detailed token consumption patterns and helps you find ways to improve token efficiency.