Does it require manual documentation for each target?

The assistant automatically generates 'When to use' documentation and categorizes the command, though you can customize the names and descriptions during the confirmation step.

Can I use this for an existing project with long history?

Yes, the skill features a 'Bulk Initialization Mode' specifically designed to process your entire command history for a one-time project setup.

Does it capture every single command I run?

No, the skill intelligently filters out trivial commands like 'ls', 'cd', and 'pwd'. It focuses on high-value commands involving flags, system state, or complex arguments.

Where are the generated Makefile targets stored?

Targets are organized into modular files within the '.claude/makefiles/' directory (e.g., docker.mk, testing.mk) and included in your main root Makefile.

Makefile Assistant

Name: Makefile Assistant
Author: rafaelcalleja

byrafaelcalleja

•

Productivity & Workflow

Automatically captures Bash commands and organizes them into documented, reusable Makefile targets.

About

Makefile Assistant is a productivity utility for Claude Code that monitors your terminal activity to build a living documentation of your project. By analyzing command history, it filters out trivial operations and prompts you to transform meaningful sequences—such as complex Docker commands, test suites, or deployment scripts—into permanent, categorized Makefile targets. This ensures that 'one-time' fixes and hard-won debug sequences are preserved, making project onboarding and repetitive task execution seamless for the entire team.

Key Features

Intelligent filtering to ignore trivial operations like directory navigation
Fuzzy-matching similarity detection to prevent duplicate Makefile entries
1 GitHub stars
Smart categorization into modular .mk files for testing, docker, and deployment
Automatic generation of 'When to use' documentation for every captured target
Automatic capture of Bash commands from Claude Code command history

Use Cases

Preserving emergency incident response or debugging sequences for future reliability
Onboarding new team members with a self-documenting suite of project commands
Converting complex terminal one-liners into permanent, documented project shortcuts

About

Key Features

Intelligent filtering to ignore trivial operations like directory navigation
Fuzzy-matching similarity detection to prevent duplicate Makefile entries
1 GitHub stars
Smart categorization into modular .mk files for testing, docker, and deployment
Automatic generation of 'When to use' documentation for every captured target
Automatic capture of Bash commands from Claude Code command history

Use Cases

Preserving emergency incident response or debugging sequences for future reliability
Onboarding new team members with a self-documenting suite of project commands
Converting complex terminal one-liners into permanent, documented project shortcuts