Skip to content

v1.3.0

Choose a tag to compare

View all tags
@saidake saidake released this 27 Aug 19:52
· 22 commits to main since this release
v1.3.0
79b4365

Plugin home page

What's New

  • Split skill add vs ensure (ensure is get-or-create; add always creates a new UUID); slim skill docs to script ops
  • Disable trace highlights and editor context menus in Git diff panes (Working Tree and Index)
  • Skill: do not delete existing traces unless the user asks (rebind "invalid" is locator status, not a delete list)
  • Clarify Agent Skill install: extract the zip into the agent skills directory and replace code-trace-tree if it already exists
  • Update marketplace preview screenshots

Install the Extension with vsix file

  1. Download the release .vsix file (code-trace-tree-vscode-1.3.0.vsix).
  2. In VS Code / Cursor: Extensions → ... → Install from VSIX…
    (or Command Palette: Extensions: Install from VSIX…).
  3. Choose the downloaded .vsix file.
  4. Reload the window if prompted.

Agent Skill

This extension does not ship an AI agent. Install your preferred coding agent,
then install the Code Trace Tree skill: extract the GitHub Release zip into the
agent’s skills directory (replace code-trace-tree if it already exists). Once installed, the agent can auto-load
it when your request is relevant. The skill is general — any agent that can load
skill folders can use it (for example Claude Code, Cursor, GitHub Copilot, Codex,
or Gemini CLI).

The skill lets the agent:

  • Resolve the bound global storage XML for the project
  • Search, add, move, and delete trace points
  • Rebind line locations after source edits on disk
  • Ask the IDE to reload / refresh plugin data
  • Select or navigate to nodes in the Code Trace Tree view

Python required: trace_tree ops need Python 3 on PATH. Resolve / refresh /
select helpers do not.

Install the skill (recommended)

Prefer extracting the zip into your agent’s skills directory.
If code-trace-tree is already there, replace that folder.
The zip contains one folder named code-trace-tree (with SKILL.md inside).

  1. Download code-trace-tree-skill-1.3.0.zip from this release (one zip works across agents).
  2. Extract it into the skills directory for your agent. When asked, replace the existing code-trace-tree folder. Global = all projects; project-local = this repo only.

Done when the skills directory contains code-trace-tree/SKILL.md
(not the zip file, and not an extra nested code-trace-tree/code-trace-tree folder).

Agent (examples) Global Project-local
Claude Code ~/.claude/skills/ .claude/skills/
Cursor ~/.cursor/skills/ .cursor/skills/
GitHub Copilot ~/.copilot/skills/ .github/skills/
Codex ~/.agents/skills/ .agents/skills/
Gemini CLI ~/.gemini/skills/ .gemini/skills/

Install example (command line, optional)

Same result as the steps above. Claude Code global path, Linux & macOS:

curl -L https://github.com/saidake/code-trace-tree-vscode/releases/download/v1.3.0/code-trace-tree-skill-1.3.0.zip -o code-trace-tree-skill-1.3.0.zip
rm -rf ~/.claude/skills/code-trace-tree
mkdir -p ~/.claude/skills
unzip code-trace-tree-skill-1.3.0.zip -d ~/.claude/skills/
rm code-trace-tree-skill-1.3.0.zip

Project-local: unzip into .claude/skills/ instead of ~/.claude/skills/.
For other agents, use the same zip and the skills path from the table above.

Install example (Windows PowerShell, optional)

Claude Code global path:

Invoke-WebRequest -Uri "https://github.com/saidake/code-trace-tree-vscode/releases/download/v1.3.0/code-trace-tree-skill-1.3.0.zip" -OutFile "code-trace-tree-skill-1.3.0.zip"
Remove-Item -Recurse -Force "$HOME\.claude\skills\code-trace-tree" -ErrorAction SilentlyContinue
New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills" | Out-Null
Expand-Archive -Path "code-trace-tree-skill-1.3.0.zip" -DestinationPath "$HOME\.claude\skills" -Force
Remove-Item "code-trace-tree-skill-1.3.0.zip"

Project-local: extract into .claude\skills\. For other agents, use the same zip
and change the destination to that agent’s skills path (see the table above for examples).

How to use the skill

Installing the skill makes it available to the agent:

  • Project-local — available in agent sessions for that project
  • Global — available across projects for that agent

In VS Code, keep the extension open for the same project: it loads the agent’s
trace point changes in real time (no manual reload).

Examples:

Help me generate some trace point nodes related to the current topic.
Assets 4
Loading