Skip to content

v1.3.3

Choose a tag to compare

@saidake saidake released this 29 Aug 08:43
· 7 commits to main since this release

Open VSX Plugin home page

What's New

  • Agent skill create_tree.py generates a nested workflow in one call (ensures existing nodes, adds new ones)
  • LINE locators require --file, --line, and --content; the script computes occurrence
  • Mutating skill ops auto-create missing storage
  • Select every requested trace point in the tree, not only the first
  • Remove the skill before npx skills add (add does not overwrite)

Install the Extension with vsix file

  1. Download the release .vsix file (code-trace-tree-vscode-1.3.3.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. 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.

Node.js required for npx skills add (ships with npx).

Agent Skill Installation

Option 1: Install with npx (Recommended)

Requires Node.js (npx). Pass -g for all projects; omit it for this project only.
On Windows, use --copy if symlinks are not available.

If the skill is already installed, remove it first — npx skills add does not overwrite an existing skill.

npx skills remove code-trace-tree -g
npx skills add saidake/code-trace-tree-skill -g

Explicit, non-interactive install for the agent you currently use (Cursor example):

npx -y skills remove code-trace-tree --agent cursor --global --yes
npx -y skills add saidake/code-trace-tree-skill --skill code-trace-tree --agent cursor --global --copy --yes

Set --agent to your current agent, for example cursor, claude-code, github-copilot, codex, or gemini-cli.

Try without installing (Codex example; same --agent values):

npx skills use saidake/code-trace-tree-skill@code-trace-tree --agent codex

Option 2: Install from a ZIP file

  1. Download code-trace-tree-skill-1.3.3.zip from this release (one zip works across agents).
  2. Delete any existing code-trace-tree folder in the skills directory, then extract the zip there.

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/

How to use the skill

Installing the skill makes it available to the agent:

  • Project-localnpx..., omit -g, or extract the zip into the project skills folder
  • Globalnpx..., pass -g, or extract the zip into the global skills folder

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 simple trace points related to the current topic.
Add simple trace points along the call path of method `test`.