# AI Token Efficiency Playbook
Drop-in instructions, prompts, examples, and lightweight checks to reduce wasted AI tokens across Codex, Claude Code, GitHub Copilot, Cursor, Gemini, and other AI coding agents.
This project is not just about making AI replies shorter. The main thesis is:
> Context is more expensive than reply style.
Most token waste comes from oversized context, repeated memory, noisy logs, and using the wrong model for the job. This playbook focuses on **context hygiene** and **model routing** so AI tools stay useful without carrying unnecessary token load.
## 30-Second Install
Pick your tool, copy the matching file into your repository, and commit it.
| Tool | Copy this file |
| --- | --- |
| Codex / general coding agents | `AGENTS.md` |
| Claude Code | `CLAUDE.md` |
| Gemini CLI / agents | `GEMINI.md` |
| GitHub Copilot | `.github/copilot-instructions.md` |
| Cursor | `.cursor/rules/token-efficiency.mdc` |
```bash
cp AGENTS.md /path/to/your-repo/AGENTS.md
.
βββ AGENTS.md
βββ CLAUDE.md
βββ GEMINI.md
βββ .github/
β βββ copilot-instructions.md
βββ .cursor/
β βββ rules/
β βββ token-efficiency.mdc
βββ prompts/
β βββ tokensaver-mode.md
β βββ debugging-mode.md
β βββ code-review-mode.md
β βββ architecture-mode.md
βββ
*(truncated)*
π Trend Scout: ravinperera/ai-token-efficiency-playbook
π What problem it solves
Drop-in instructions, prompts, and workflows to reduce token usage across Codex, Claude Code, GitHub Copilot, Cursor, and other AI coding agents
π Timeline
β Strengths
π‘ What this repo can learn
claude-adapter.py's JSONL parsing β e.g., handling new session event types or extracting richer metadata from Claude Code tool-use blocksmemory-tool add/search/dream) could streamline the UX ofquery-session.pyandlearn.py, making them easier to invoke from hooks or scriptswatch-sessions.pycould be extended to detect and parse cursor session formats natively, broadening the range of AI sessions indexed intoknowledge.dbREADME excerpt
For best results, also copy the canonical guidance in
guidelines/and the checklist inchecklists/token-efficiency-checklist.md.What This Provides
Ready-to-copy instruction files and supporting material:
Scouted on 2026-08-07 Β· View on GitHub