starred/codemap-skill-Asixa
1
0
Fork 0
mirror of https://github.com/Asixa/codemap-skill.git synced 2026-08-28 23:01:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

README: clone the tool to ~/codemap-skill (global), not the project-local .codemap/ output folder; clarify the distinction

Browse Source
This commit is contained in:
Xingyu Chen
2026-06-10 19:07:10 -07:00
parent 330ff300ec
commit 5d049f80d8
1 changed files with 12 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+12 -8
View File
@@ -21,9 +21,13 @@ helps you **pay down the cruft** — incrementally, one commit at a time.
## Install ## Install
codemap is one self-contained folder. Clone it once, then wire it into whichever agent you codemap is one self-contained folder. Clone it once to a global path, then wire it into
use — the engine (Python scripts + the `SKILL.md` / `AGENTS.md` / `reference/STANDARDS.md` whichever agent you use — the engine (Python scripts + the `SKILL.md` / `AGENTS.md` /
workflow) is identical for all of them. `reference/STANDARDS.md` workflow) is identical for all of them.
> Note: the clone location below (the **tool**) is separate from the per-project
> **`<project>/.codemap/`** folder, which is where codemap writes its output for each repo
> you run it on.
**Claude Code** — skills live under `~/.claude/skills/`, so clone it straight there: **Claude Code** — skills live under `~/.claude/skills/`, so clone it straight there:
@@ -37,19 +41,19 @@ Restart Claude Code; it shows up as **`/codemap`**.
project's `AGENTS.md` (or `~/.codex/AGENTS.md`): project's `AGENTS.md` (or `~/.codex/AGENTS.md`):
```bash ```bash
git clone https://github.com/Asixa/codemap-skill ~/.codemap git clone https://github.com/Asixa/codemap-skill ~/codemap-skill
``` ```
> For architecture maps / code audits, use the codemap tool at `~/.codemap` — follow its `AGENTS.md`. > For architecture maps / code audits, use the codemap tool at `~/codemap-skill` — follow its `AGENTS.md`.
**Cursor** — clone it, then add a project rule at `.cursor/rules/codemap.mdc`: **Cursor** — clone it, then add a project rule at `.cursor/rules/codemap.mdc`:
```bash ```bash
git clone https://github.com/Asixa/codemap-skill ~/.codemap git clone https://github.com/Asixa/codemap-skill ~/codemap-skill
``` ```
> Use the codemap tool at `~/.codemap` for architecture maps / code audits — follow its `AGENTS.md`. > Use the codemap tool at `~/codemap-skill` for architecture maps / code audits — follow its `AGENTS.md`.
**Any other agent** (Windsurf, Aider, Cline, …) or **by hand** — clone it anywhere and tell **Any other agent** (Windsurf, Aider, Cline, …) or **by hand** — clone it anywhere and tell
the agent: *"Use the codemap tool at `~/.codemap`; follow its `SKILL.md`, and score each the agent: *"Use the codemap tool at `~/codemap-skill`; follow its `SKILL.md`, and score each
module with a separate sub-task per `reference/STANDARDS.md`."* The deterministic scripts module with a separate sub-task per `reference/STANDARDS.md`."* The deterministic scripts
(`scan` / `query` / `render` / `apply_audit`) also run standalone with no agent at all. (`scan` / `query` / `render` / `apply_audit`) also run standalone with no agent at all.