Guides
Every AI coding session has a token budget. Zephex tools are designed to minimize token use while maximizing signal.
A typical model context window is 100,000 to 200,000 tokens. Every file read, tool result, and copied snippet burns that budget. For coding sessions, token budget is working memory.
Agent reads package.json → 2,100 tokensAgent reads README.md → 4,500 tokensAgent reads src/index.ts → 8,200 tokensAgent reads app/api/route.ts → 6,100 tokensAgent reads lib/auth.ts → 3,800 tokensAgent reads middleware.ts → 2,400 tokens─────────────────────────────────────────────────────Total consumed for project orientation: 27,100 tokensActual useful signal extracted: ~600 tokensIn that example, the agent spent 27,100 tokens to extract about the same information get_project_context returns in roughly 450 to 700 tokens.
| Tool | Typical output | What it replaces | Savings |
|---|---|---|---|
| get_project_context | 400–700 tokens | 15,000–40,000 tokens of file reads | 97% |
| check_test | 300–600 tokens | 3–8 unnecessary file reads | 70–90% |
| read_code | 200–800 tokens | Full file read (2,000–10,000 tokens) | 85–95% |
| find_code | 100–400 tokens | Manual grep or multiple file reads | 90% |
| explain_architecture | 800–1,500 tokens | Reading 5–10 related files | 85% |
| keep_thinking | 200–500 tokens/call | Reasoning loops and repeated reads | Context stability |
Start session: read 6 files for orientation → 27,100 tokensFind the right function: read 3 more files → 18,400 tokensUnderstand auth flow: read middleware + 2 helpers → 11,200 tokens──────────────────────────────────────────────────Before writing a single line of code: 56,700 tokens consumedget_project_context → orientation → 520 tokenscheck_test → "add rate limiting to /api/webhooks" → 380 tokensread_code → find the existing rateLimiter.ts → 290 tokens──────────────────────────────────────────────────Before writing a single line of code: 1,190 tokens consumedThe same task. 47x fewer tokens consumed before writing code.
check_test.read_code with a symbol name, not a whole file.get_project_context once per session.find_code before read_code.keep_thinking when reasoning gets complex.