skills.rest
NeoLabHQ
NeoLabHQOFFICIAL
Explore all skills by this author →
WebsiteGitHub

setup-codemap-cli

Installs and configures Codemap CLI for codebase visualization and navigation.

1.5k|154|Updated Nov 13, 2025
Search Tags:#codebase navigation#Installation#codemap#cli setup#Git diff#Dependency visualization#claude code hooks
One-click install
npx skills add https://github.com/NeoLabHQ/context-engineering-kit --skill setup-codemap-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-codemap-cli
Source: https://github.com/NeoLabHQ/context-engineering-kit/tree/main/plugins/mcp/skills/setup-codemap-cli
Command: npx skills add https://github.com/NeoLabHQ/context-engineering-kit --skill setup-codemap-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up the Codemap CLI for codebase visualization requires multiple manual steps across installation, CLAUDE.md documentation, gitignore rules, and agent hook configuration, which is error-prone when done by hand.

Core Features & Use Cases

  • Guided Installation: Detects whether Codemap is installed and walks through Homebrew (macOS/Linux) or Scoop (Windows) installation.
  • Configuration Scope Selection: Lets the user choose project-level shared, project-level personal, or global user-level configuration paths for CLAUDE.md and settings files.
  • Agent Integration: Updates CLAUDE.md with Codemap usage rules, adds .codemap/ to .gitignore, and configures session-start, pre-edit, post-edit, prompt-submit, pre-compact, and session-stop hooks.
  • Use Case: A developer onboarding a repository wants their AI coding agent to automatically receive codebase tree structure, dependency flow, and branch diff context at every session start without manual prompting.

Quick Start

Ask the agent to set up the Codemap CLI for this project and configure the session-start hook at the project level.

Frequently Asked Questions about setup-codemap-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Codemap CLI on macOS or Windows?▼

On macOS or Linux, install Codemap via Homebrew with brew tap JordanCoin/tap && brew install codemap. On Windows, use Scoop by adding the codemap bucket and running scoop install codemap.

How to configure Claude Code hooks for codebase context?▼

Add hook entries to your .claude/settings.json file mapping events like SessionStart, PreToolUse, and PostToolUse to codemap hook commands. The session-start hook provides the project tree, hubs, and branch diff automatically.

What is the difference between project-level and user-level Codemap configuration?▼

Project-level configuration writes to ./CLAUDE.md and ./.claude/settings.json, which can be shared via git or kept local. User-level configuration writes to ~/.claude/CLAUDE.md and applies to all projects for that user.

Does Codemap work with a default branch other than main?▼

Yes, Codemap supports non-main default branches by passing the --ref flag, such as codemap --diff --ref master. Hook commands and CLAUDE.md instructions must be updated to include the matching --ref flag.

Why is codemap command not found after installation?▼

The command not found error usually means the installation did not complete or the binary is not on your PATH. Verify installation by running codemap -help, and reinstall via Homebrew or Scoop if it fails.

Related Skills

Explore More Software Engineering Skills→
wshaddixwshaddix
71

dotnet-cli-release-pipeline

Automate .NET CLI releases with GitHub Actions and Semantic Versioning.

Community
Advanced
agentydragonagentydragon
4

branch_splitter

Decomposes large feature branches into a DAG of atomic PRs.

Community
Advanced
wizelinewizeline

code-review-contextualizing

Retrieve semantic codebase context for code reviews via dependency and data flow analysis.

Official
Advanced
89jobrien89jobrien
4

developer-experience

Automate developer environment setup, dependency installation, and code quality checks.

Community
Intermediate