Installation

The fastest path if you have Go 1.21+ and a working GOPATH/bin or Go bin directory on your PATH:

go install github.com/aasixh/devgrep@latest

Verify the install:

devgrep version

Clone the repository and use the Makefile target:

git clone https://github.com/aasixh/devgrep
cd devgrep
make build
./bin/devgrep version

The build embeds version metadata via linker flags: version from git describe, commit hash, and build date.

For a prebuilt binary without a local Go toolchain, use the install script from the repository:

curl -fsSL https://raw.githubusercontent.com/aasixh/devgrep/main/scripts/install.sh | sh

Go bin directory

After go install, the binary is typically at ~/go/bin/devgrep. Add it to your shell profile:

# ~/.bashrc or ~/.zshrc
export PATH="$PATH:$(go env GOPATH)/bin"

Local build

If you built with make build, either run ./bin/devgrep from the repo or copy/symlink the binary into a directory already on PATH.

Confirm devgrep runs and reports version information:

devgrep version
devgrep doctor

doctor checks config validity, database health, permissions, shell history availability, and other local prerequisites.

• Run devgrep index to create your first local index — see Getting Started.
• Optional config lives at ~/.config/devgrep/config.yaml; defaults work without creating a file.
• The SQLite database is created at ~/.local/share/devgrep/devgrep.db.