| name | repo-navigator |
| description | Navigate and map this monorepo structure. Find files, packages, and dependencies. Use when asked to locate code, understand package relationships, find where something is defined, or explore repo structure. |
| allowed-tools | Read, Grep, Glob |
Repo Navigator
Maps this Turborepo monorepo and locates code quickly.
When to Use
- "Where is X defined?"
- "Find files related to..."
- "What packages exist?"
- "Show me the structure"
- "How do packages depend on each other?"
Quick Reference
Package Locations
| Package | Path | Purpose |
|---|---|---|
| Web App | apps/web/ |
Next.js 16 frontend + API routes |
| Mobile App | apps/mobile/ |
React Native bare |
| Database | packages/db/ |
Drizzle ORM, schema, migrations |
| Auth | packages/auth/ |
Better Auth config |
| AI | packages/ai/ |
Vercel AI SDK integration |
| API Client | packages/api-client/ |
Shared fetch client |
| Security | packages/security/ |
Rate limiting |
| Types | packages/types/ |
Shared TypeScript types |
| Tests | packages/tests/ |
Integration tests |
| Tools | packages/tools/ |
AI tool definitions |
| RAG | packages/rag/ |
Embeddings support |
| Evals | packages/evals/ |
LLM evaluation framework |
| Obs | packages/obs/ |
Observability utilities |
Key File Locations
| Looking for... | Check... |
|---|---|
| API endpoints | apps/web/app/api/ |
| Database schema | packages/db/src/schema.ts |
| Auth config | packages/auth/src/index.ts |
| Rate limiting | packages/security/src/rateLimit.ts |
| Shared types | packages/types/src/index.ts |
| Integration tests | packages/tests/src/ |
| Mobile screens | apps/mobile/src/screens/ |
| CI workflows | .github/workflows/ |
Procedure
1. Understand the Request
Identify what the user is looking for:
- Specific file/function → use Grep with pattern
- Package overview → use Glob for structure
- Dependency → check package.json imports
2. Search Strategy
For specific code:
Grep pattern: "export (function|const|class) {name}"
Glob pattern: "**/*.ts" or "**/*.tsx"
For package structure:
Glob: "{apps,packages}/*/package.json"
For imports/usage:
Grep: "from '@acme/{package}'"
Grep: "import.*{name}"
3. Report Findings
Output format:
## Found: {description}
**Location:** `{path}:{line}`
**Context:**
- Package: {package-name}
- Exports: {what it exports}
- Used by: {importers}
Common Searches
Find API endpoint
Glob: apps/web/app/api/**/*.ts
Grep: "export (async function|const) (GET|POST|PUT|DELETE)"
Find database table
Read: packages/db/src/schema.ts
Grep: "export const {tableName}"
Find component
Glob: apps/web/components/**/*.tsx
Glob: apps/mobile/src/components/**/*.tsx
Find where package is used
Grep: "@acme/{package-name}"
Guardrails
- DO NOT modify any files
- DO NOT execute commands
- Report file paths with line numbers when found
- If not found, suggest alternative search terms