Sherlook CLI

Understand any codebase in minutes.

Model-agnostic, terminal-native, and built for fast mental models. Switch providers without changing your workflow.

See commands
$ sherlook investigate
Sherlook:
Stack: Node.js CLI + AI providers
Entry point: src/bin/sherlook.ts
Purpose: map codebase intent fast

Core commands

Fast answers for deep codebases. Add --plain for plain text.

investigate

Summarize project stack, entry points, and purpose.

explain <path>

Explain a file from any perspective.

blueprint <request>

Map which files should change for a feature request.

Provider switching

One active provider at a time, saved locally.

OpenAI
Anthropic
Google AI
Ollama
OpenRouter
Hugging Face
Groq
Together
Mistral
Perplexity
$ sherlook auth login
$ sherlook list
$ sherlook auth logout

How it works

Three steps to clarity.

01

Scan metadata

Read README and package.json for context.

02

Map structure

List paths or file trees without token-heavy reads.

03

Ask Sherlook

Get concise, actionable guidance for changes.

Ready to investigate?

Run Sherlook in any repo to get instant direction.