Export and reference tracing
SkillDev toolsLets your agent trace TypeScript imports and find every caller of an export before you refactor or delete it.
Use Export and reference tracing in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add Export and reference tracing and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the Export and reference tracing skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
About this skill
Trace TypeScript exports, imports, and re-exports in codexhost before refactoring interfaces or deleting code. Use available symbol tooling and repository searches to identify actual callers.
What this skill tells your AI
The instructions your AI receives, as published by bytepioneer-ai/codex-host in .agents/skills/dep-refs/SKILL.md and read by Ahel’s review.
Work from the repository root. The ZCode-specific pnpm dep:refs and pnpm knip commands are not installed here; use current tools and package exports rather than adding dependencies for a lookup.
- Read the target declaration and owning package's
package.jsonexports. Follow its public entrypoint and any re-export chain. - Prefer a TypeScript language-service references query when the session provides one. Ensure it covers workspace callers, including
packages/adapters/*, scripts and tests. - Use
rgto find candidate references, then inspect aliases, namespace imports, re-exports and relevant consumers. For example:
rg -n --glob '*.{ts,tsx,mts,cts,mjs,js,json}' '\bHarnessAdapter\b' packages tests tools scripts
rg -n --glob '*.{ts,tsx,mts,cts,mjs,js,json}' '@codexhost/harness-adapter' packages tests tools scripts
- For a deletion, search the whole repository, including hidden configuration when relevant. Check public exports, dynamic loading, plugin manifests, string-based dispatch and generated consumers. Read the current boundary checker before changing dependency directions.
- Report concrete callers with paths and lines, re-exported public surfaces, and the limits of the search. Zero text matches or zero static references is not proof that an externally consumed export can be removed.
After changing an interface, validate its actual consumers with the applicable typecheck/build and focused tests from package scripts. This skill is read-only unless the user has also requested an implementation change.
Signals
- GitHub stars
- 3k
- Forks
- 241
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
dep-refs- Source
- github.com/bytepioneer-ai/codex-host
github.com/bytepioneer-ai/codex-host