get_project_context
Project brief — framework, database hints, scripts, monorepo detection, deploy signals.
When: First command in any repo. Before architecture or find-code.
50+ aliasesget-contextcontext.frameworkauth
Alias breakdown
Counts from cli.ts and cli-context-topic.ts
| Category | Count | Examples |
|---|
| Core subcommands | 6 | get-context, get_context, context, . |
| Typo variants | 14 | getprojectcontext, project_context, … |
| Topic shortcuts | 34 | framework, database, auth, monorepo |
| Natural language | 20+ | "tell me about my project" |
Copy-paste examples
# Full project brief (stack, scripts, layout, deploy hints)npx zephex get-contextnpx zephex get_project_contextnpx zephex context # One section only — faster, less noisenpx zephex frameworknpx zephex databasenpx zephex authnpx zephex scripts # Plain English (no subcommand to memorize)npx zephex "tell me about my project"npx zephex "what database am I using" # Public repo without cloningnpx zephex get-context github:vercel/next.js # Cache + exportnpx zephex get-context --forcenpx zephex get-context -o PROJECT-BRIEF.mdnpx zephex get-context --json -o context.json
Flags
--topic framework — same as npx zephex framework--json — raw MCP JSON for scripts--force — ignore .mcp-context.json cache (24h TTL)--cwd mcp-proxy — monorepo package root-o file.md — write brief to disk
find_code
BM25-style code search over your uploaded project index. Grouped file paths and line numbers.
When: You know a string or symbol but not the file. Before a rename. To list all usages.
31 aliasesfindsearchrenameusagesdefs
All 31 subcommands
find-codefindsearchgreprgwhererenameusagesdefsdefinitionslocatepaste
Intent presets
Intent router rewrites your argv automatically
| You type | Becomes |
|---|
| rename X | find-code --exhaustive X (every file:line) |
| usages Symbol | find-code --scope usages Symbol |
| defs Symbol | find-code --scope definitions Symbol |
| paste code… | Snippet search (≥8 chars) |
Copy-paste examples
# Searchnpx zephex find auth middlewarenpx zephex find encrypt --also cipher,E2E # Rename preview & usagesnpx zephex rename OldProductNamenpx zephex defs validateTokennpx zephex usages handleAuth # Snippet pastenpx zephex paste 'export async function handleAuth(' # CI / scriptsnpx zephex rename Crystal --json | jq '.data.files_summary[].file'
read_code
AST-based reading — file outline, symbol body, or batch files. Terminal shows summaries; use --json for full payload.
When: Large files (>300 lines): outline first, then symbol. After find-code gives you a path.
31 aliasesoutlinesymbolsummarizeexplainfiles
summary vs summarize
Easy to mix up — check this before running commands
| Command | Actual tool |
|---|
| npx zephex summary | get_project_context — topic quick |
| npx zephex summary src/foo.ts | read_code — outline + summarize |
| npx zephex explain | explain_architecture |
| npx zephex explain src/foo.ts | read_code file summary |
Copy-paste examples
# File summary (outline + plain-language overview)npx zephex summarize src/app/page.tsxnpx zephex explain src/lib/stripe.ts # Table of contents only (large files)npx zephex outline src/cli.ts # One function or class bodynpx zephex symbol handleAuth # Batch readnpx zephex files src/a.ts src/b.ts # summary alone = project brief; summary + path = file outlinenpx zephex summary # → get-context --topic quicknpx zephex summary src/foo.ts # → read_code outline
explain_architecture
System map — entry points, layers, auth/billing flows, external services, hotspots.
When: After get-context when you need “how does X work in this codebase?” Use --focus to narrow.
9+ aliasesarchitecturearchhow-it-works"how does auth work"
Natural language routing
npx zephex "how does auth work" → architecture --focus authnpx zephex "how does payment flow work" → billing focus- Keyword routing in cli-intent-router.ts — no LLM in the CLI
Copy-paste examples
# System mapnpx zephex architecturenpx zephex archnpx zephex how-it-works # Focus one areanpx zephex arch --focus authnpx zephex architecture --focus billing # Plain Englishnpx zephex "how does auth work" # explain alone = architecture; explain + file = read_codenpx zephex explain src/foo.ts
check_test
Test Pulse — run tests, return structured health: broken areas, fix_first, coverage, triage.
When: After code changes. Chain: find-code → check-test → read-code on focus files.
12 aliasescheck-testscope-taskscopeplanfiles-for
Copy-paste examples
npx zephex check-test "add Stripe webhooks"npx zephex scope "fix auth bug" --max-files 5npx zephex plan "migrate to app router"npx zephex check-test --area auth