Search your developer workflow history instantly.
Terminal-native search for shell history, logs, markdown notes, and indexed project workflows.
GitHub · Documentation · Releases · Twitter/X
No cloud. No accounts. No telemetry. No AI layer — just fast, offline search in your terminal.
Comprehensive documentation, including usage guides, is available at Devgrep Docs
Go
go install github.com/aasixh/devgrep@latestRelease binary
curl -fsSL https://raw.githubusercontent.com/aasixh/devgrep/main/scripts/install.sh | shBuild from source
git clone https://github.com/aasixh/devgrep
cd devgrep
make build
./bin/devgrep versionPlatforms: Linux, macOS, and Windows (amd64 / arm64) via manual method (docs/release.md).
| Command | Description |
|---|---|
devgrep search [query] |
Search indexed workflows (TUI or plain) |
devgrep [query] |
Shorthand for search |
devgrep index [path...] |
Index history, logs, and notes |
devgrep index . --dry-run |
Preview files without writing to SQLite |
devgrep index <path> --no-watch |
Index once, do not stay in watch mode |
devgrep index --watch |
Restore and run persisted watchers |
devgrep sources |
List indexed source locations |
devgrep sources --tree |
Tree view of indexed paths |
devgrep stats |
Document counts, DB size, top searches |
devgrep doctor |
Local health checks |
devgrep version |
Version and build metadata |
Global flags: --config, --db, --plain, --verbose
Search flags: --source history,logs,notes, -n limit, -i force TUI, --tail, --regex, --severity
Index flags: --source, --path, --watch, --no-watch, --dry-run, -y confirm risky paths
devgrep runs with sensible defaults. No config file is required for the first run.
On first devgrep index, defaults are written to ~/.config/devgrep/config.yaml if missing. Customize indexed paths, ignore rules, ranking weights, history limits, log extensions, and TUI colors.
Full reference: docs/user-manual.md · docs/config.md
make build # bin/devgrep
make test # race detector + coverage
make lint # golangci-lint or go vet
make bench # includes 100k-document search benchmark