Makefile Explorer
Browse and run Makefile targets in a tree view — like NPM Scripts, but for Make. No more scrolling through massive Makefiles hunting for the right target.
Why?
When your Makefile grows to 50+ targets, finding the right one in a flat text file is painful. Makefile Explorer treats every Makefile like a folder of executable commands:
- Expand a Makefile node → see all targets at a glance
- Click a target → runs
make <target> in the terminal
- Right-click → jumps straight to the definition line
Built for the monorepo reality: multiple Makefiles, nested directories, dozens of targets — all organized in one tree.
Features
- 🌲 Tree View — Targets grouped by Makefile in the Explorer sidebar
- ▶ One-Click Execute — Click any target to run it in a terminal
- 🔍 Jump to Definition — Right-click → "Go to Target Definition" jumps to the exact line
- 📝 Description Support — Extracts
## comments (above-target and inline) as descriptions
- 🔄 Auto-Refresh — Watches for file changes; tree stays in sync
- 🛡️ Smart Filtering — Skips
.PHONY, variable assignments, and empty targets
- 🚫 Dependency-Aware — Excludes
node_modules/, vendor/, .build/, and other third-party dirs
- 📦 Multi-Makefile — Finds
Makefile, makefile, GNUmakefile, *.mk, and Makefile.*
Usage
- Open a project that contains Makefiles
- Click the "Make Targets" view in the Explorer sidebar
- Expand a Makefile node to see its targets
- Click a target → executes
make <target> in the terminal
- Right-click → "Go to Definition" → opens the Makefile at the target's line
Targets can have descriptions extracted from comments:
# Build the project binary
# Uses release flags for optimization
build:
cargo build --release
test: ## Run the full test suite
cargo test
Above-target comments take priority over inline ## comments.
Extension Settings
This extension contributes the following settings:
| Setting |
Type |
Default |
Description |
| (none yet — future release) |
|
|
|
Requirements
- VSCode 1.85.0 or later
make available in your $PATH
Known Issues
- Very large workspaces (1000+ Makefiles) may have a slight delay on first scan
- Targets with complex variable expansions in their names may not be detected
See the GitHub issues for the full list.
Release Notes
0.1.0
Initial release:
- Tree view with auto-discovery of Makefiles
- Click to execute targets in terminal
- Right-click to jump to definition
## comment extraction (above-target and inline)- File watcher auto-refresh
- Third-party dependency exclusion
Development
# Install dependencies
npm install
# Compile
npm run compile
# Watch mode (auto-recompile on changes)
npm run watch
# Package for distribution
npm run package
Press F5 in VSCode to launch the Extension Development Host for debugging.
Project Structure
src/
├── extension.ts # Entry point: TreeView + command registration
├── MakefileTreeProvider.ts # TreeDataProvider: scan + build tree
├── TargetParser.ts # Makefile parser: extract targets
└── types.ts # Type definitions
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
License
MIT — see LICENSE for details.
Enjoy! ⭐ this repo if you find it useful.
