Describe is a command-line tool that scans a directory, embeds file contents, and generates a structured Markdown file (codebase.md). It respects a .describeignore file, which follows the same format as .gitignore, allowing precise control over which files and directories are included. This makes it useful for chatbot integrations and AI-assisted workflows, ensuring only relevant content is extracted while keeping unnecessary files out of the output.

If you use Homebrew, you can install describe with:

brew tap rodlaf/describe
brew install describe

Homebrew will automatically select the correct binary based on your system architecture (Apple Silicon or Intel).

If you don’t have Go installed, you can download a precompiled binary:

1. Visit the Releases page.
2. Download the correct binary for your system:
   • macOS (Apple Silicon): describe-macos-arm64.tar.gz
   • macOS (Intel): describe-macos-amd64.tar.gz
   • Linux (x86_64): describe-linux-amd64.tar.gz
   • Linux (ARM64): describe-linux-arm64.tar.gz
3. Extract and move it to /usr/local/bin:

   tar -xvzf describe-macos-arm64.tar.gz
   mv describe /usr/local/bin/
   chmod +x /usr/local/bin/describe

4. Run:

If you already have Go 1.23+ installed, you can install describe with:

go install github.com/rodlaf/describe@latest

This will install describe in Go’s bin directory (e.g., $HOME/go/bin/describe).

If you get a “command not found” error after running describe, add Go’s bin directory to your system’s PATH.

Add this to your ~/.bashrc, ~/.bash_profile, or ~/.zshrc:

export PATH=$HOME/go/bin:$PATH

Then run:

source ~/.zshrc  # or source ~/.bashrc

Add %USERPROFILE%gobin to your System Environment Variables:

1. Open Control Panel → System → Advanced system settings.
2. Click Environment Variables.
3. Under System variables, find Path, then click Edit.
4. Add C:UsersYourUsernamegobin (Replace YourUsername).
5. Click OK, restart your terminal, and run:

Now describe should work globally! 🎉

Scans .

Uses .describeignore (if present).

Outputs codebase.md.

Saves Markdown to docs.md.

Read More

Tags: codebaseDescribe

0Likes

Written by

HackTech

View all posts by HackTech