telagod avatar

Indexing Code

Before your agent touches a file, this runs abyss CLI to show you what else depends on it. You get caller traces with confidence scores, hotspot metrics, coupled files that change together, and test coverage gaps. The hook auto-fires on edits so high-risk changes surface warnings before they ship. Works across Claude Code, Codex, Gemini, and others via shell access. The confidence tiering is smart: 1.0 for same-file calls down to 0.7 for ambiguous matches, so you know what's reliable versus a hint. If you've ever broken production because you didn't know a utility function had 500 transitive callers, this catches that.

GitHub stars
224
last updated
Jun 10, 2026

Install

$ npx -y skills add telagod/code-abyss --skill indexing-code --agent claude-code

Installs into .claude/skills of the current project.

Files

代码关系图 · abyss

不是搜索工具,是代码的调用图 + 时间智能。通过 shell 调用 abyss CLI。

前置

进入项目时,检查并初始化索引:

command -v abyss >/dev/null && [ ! -f .code-abyss/index.db ] && abyss index

核心行为

改文件前:跑 abyss context

即将修改任何代码文件时,先获取该文件的完整上下文(不需要知道函数名):

abyss context <要修改的文件路径> --json

返回:该文件所有函数的外部调用方、依赖的类型和函数、热点评分、耦合文件。

根据返回结果:

  • 有 production callers:检查改动是否会破坏调用方,改完逐个同步
  • hotspot score > 5000:高风险文件,跑 abyss impact <func> --json 深入分析
  • impact risk > 7/10:跟用户确认方案后再改
  • 有 uncovered paths:提醒用户补测试
  • 有 coupled files:检查耦合文件是否需要同步修改

其他场景

场景命令
初识项目架构abyss map --json
追查 bug 来源abyss history <file> --symbol <func> --json
搜索代码(比 grep 好)abyss search "关键词" --json

输出说明

--json 输出结构化 JSON,agent 直接解析。不加 --json 输出人类可读文本。

context 输出关键字段

Sponsors

Details

Repository
github.com/telagod/code-abyss
Categories
AI & Agent Building, CLI & Terminal
License
MIT
First seen
Jun 11, 2026

More from telagod/code-abyss

All 30
1thinkinaixyz avatarcua-driverthinkinaixyz/deepchatDrive native macOS apps through DeepChat's plugin-provided Computer Use MCP tools. Use when the user asks to operate, inspect, automate, or perform a GUI task i0skills.sh installs
2thinkinaixyz avatarfeishu-toolsthinkinaixyz/deepchatUse the Feishu/Lark plugin MCP tools for Feishu documents, spreadsheets, knowledge content, and other matching workspace operations.0skills.sh installs
3ThinkInAIXYZ avatarmemory-managementThinkInAIXYZ/deepchatGuide the agent to recall, remember, and route durable learning into Memory, Skills, Scheduled Tasks, or Tape.0skills.sh installs
4UKGovernmentBEIS avatarcode-quality-fix-allUKGovernmentBEIS/inspect_evalsFix code quality issues identified in a code quality review stored in agent_artefacts/code_quality/<topic>/. Systematically addresses issues found by the code-q0skills.sh installs
5utopai-research avatarvideo-composeutopai-research/pai-proGenerates and prompts video clips on the filmmaking canvas. Use when the user asks to generate, render, animate, continue, restyle, edit, shoot, or compose a vi0skills.sh installs
6wbern avatartddwbern/claude-instructionsRemind agent about TDD approach and continue conversation0skills.sh installs