Skip to content
Development
Command

/peek

Quickly find likely code locations without returning full code

From plugin
codebase-index
1629 skills9 commands1 MCP
Install
> /plugin marketplace add Helweg/open-codebase-index
> /plugin install codebase-index@helweg-plugins

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/peek

Context preview

What this command does when you run it.

Quickly find likely code locations without returning full code

Command definition

peek.md
description: Quickly find likely code locations without returning full code

Search the codebase using `codebase_peek`.

User input: $ARGUMENTS

The first part is the search query. Look for optional parameters:

  • `limit=N` or "top N" or "first N" → set limit
  • `type=X` or mentions "functions"/"classes"/"methods" → set chunkType
  • `dir=X` or "in folder X" → set directory filter
  • File extensions like ".ts", "typescript", ".py" → set fileType
  • `author=X` or `blameAuthor=X` → set blameAuthor filter
  • `sha=X` or `blameSha=X` → set blameSha filter
  • `since=YYYY-MM-DD` or `blameSince=YYYY-MM-DD` → set blameSince filter
  • `until=YYYY-MM-DD` or `blameUntil=YYYY-MM-DD` → set blameUntil filter

Call `codebase_peek` with the parsed arguments.

Examples:

  • `/peek authentication logic` → query="authentication logic"
  • `/peek error handling limit=5` → query="error handling", limit=5
  • `/peek validation functions` → query="validation", chunkType="function"
  • `/peek auth logic author=jane@example.com since=2025-01-01 until=2025-01-31` → query="auth logic", blameAuthor="jane@example.com", blameSince="2025-01-01", blameUntil="2025-01-31"

If the index doesn't exist, run `index_codebase` first.

Return results as concise locations with file paths and line numbers. Suggest reading the returned files or using `codebase_search` when the user needs full code context.

Ships withcodebase-index

Search a codebase by meaning, then follow the result into definitions, callers, and dependency paths. open-codebase-index is a local semantic code index for OpenCode, Jcode, Pi, Codex, Claude Code, and other MCP clients.

Get the whole plugin
Stats
170
Stars
31
Forks
Active
Maintenance
TypeScript
Language
MIT
License
4h ago
Last commit
7mo ago
Created

Repo: Helweg/open-codebase-index