Exelerus
HomeServicesPortfolioSupport
Get in touch
© Exelerus AB 2026Privacy Policy
LinkedInGitHub
  1. Projects & work
  2. •
  3. TokenLean

TokenLean

CLI toolkit with 32 specialized tools that extract code information with minimal token overhead for AI coding assistants.

Client
Open source project
Role
Solo Developer
Year
2026-
URL
https://github.com/edimuj/tokenlean

AI coding assistants consume tokens for every line of context they process. Reading a 500-line file to understand a single function wastes context window capacity, increases costs, and slows responses. TokenLean solves this with 32 specialized CLI tools that extract exactly the information needed – nothing more.

Instead of reading entire files, run targeted commands like tl-exports to get module signatures in roughly 50 tokens instead of thousands.

Tool Categories

Code Analysis

  • tl-structure – Overview of file and directory organization
  • tl-symbols – Extract function, class, and variable definitions
  • tl-types – Type definitions and interfaces
  • tl-exports – Module export signatures
  • tl-react – React component props and structure
  • tl-docs – Documentation and comments extraction
  • tl-entry – Identify application entry points
  • tl-schema – Database schema analysis

Impact & Dependency Analysis

  • tl-blast – Calculate blast radius for changes
  • tl-deps – Dependency visualization with tree mode
  • tl-importers – Find files importing a module
  • tl-callgraph – Function call relationships
  • tl-coverage – Test coverage information
  • tl-complexity – Cyclomatic complexity metrics

Version Control Integration

  • tl-diff – Token-efficient diff summaries
  • tl-history – File change history
  • tl-blame – Authorship attribution
  • tl-hotspots – Change frequency analysis
  • tl-pr – Pull request summaries
  • tl-changelog – Generate release changelogs

Discovery & Search

  • tl-search – Pattern-based code searching
  • tl-secrets – Detect exposed credentials
  • tl-todos – Find TODO and FIXME comments
  • tl-env – Environment variable tracking
  • tl-dead – Identify unused code
  • tl-api – Extract API endpoints
  • tl-routes – Web framework route discovery

Key Features

  • Single-purpose tools – Each tool does one thing well
  • Minimal output – Only the information you actually need
  • Token conscious – Designed for AI context efficiency
  • Composable – JSON output for tool chaining
  • Fast execution – Uses ripgrep for high-speed searching
  • Git-aware caching – Invalidates automatically on changes

Language Support

Primary focus on JavaScript and TypeScript ecosystems, with most tools also supporting Python and Go.

Common Workflows

Onboarding to unfamiliar code:

tl-structure && tl-entry && tl-exports && tl-docs

Before refactoring:

tl-blast src/core/auth.ts && tl-importers src/core/auth.ts

Pre-commit security check:

tl-secrets --staged

Release preparation:

tl-changelog --since v1.2.0

TokenLean turns expensive context operations into cheap, targeted queries – letting AI assistants understand codebases efficiently without burning through token budgets.

Related Projects

  • Claude Mneme – Persistent memory plugin with similar token-conscious design philosophy
  • Claude Simple Status – Monitor context usage to know when TokenLean tools would help
  • Vexscan – Security scanner for AI agent plugins and tools
←Back to portfolio