Skip to content

Add symdex skill#38

Open
Zenlyte wants to merge 1 commit intozocomputer:mainfrom
Zenlyte:add-symdex-skill
Open

Add symdex skill#38
Zenlyte wants to merge 1 commit intozocomputer:mainfrom
Zenlyte:add-symdex-skill

Conversation

@Zenlyte
Copy link
Copy Markdown
Contributor

@Zenlyte Zenlyte commented Mar 9, 2026

Description

SymDex is a universal code-indexer MCP server that dramatically reduces token costs when searching codebases. It uses tree-sitter parsing across 12 programming languages (Python, JS, TS, Go, Rust, Java, PHP, C#, C, C++, Elixir, Ruby) to extract every function, class, and method with exact byte offsets. This allows AI agents to find any symbol in ~200 tokens instead of reading entire files at ~7,500 tokens (97% reduction).

Features

  • Symbol search by name (prefix + contains matching)
  • Semantic search by meaning using local embeddings (sentence-transformers, no API calls)
  • Call graph analysis (find all callers and callees of any function)
  • Cross-repo registry for searching multiple indexed projects simultaneously
  • SHA-256 change detection for fast incremental re-indexing
  • MCP server with 14 tools for AI agents (stdio + HTTP transport)
  • Wrapper script provides clean JSON output for Zo integration

Use Cases

  • Finding functions/classes across large codebases without reading every file
  • Understanding code dependencies before refactoring (call graph analysis)
  • Semantic code search when you don't know exact function names
  • Reducing token costs by 97% for AI agent code navigation

Testing

  • Installed SymDex via pip and verified all commands work
  • Indexed a test project (SymDex's own codebase) successfully
  • Tested search, semantic search, callers, callees, and outline commands
  • Verified wrapper script provides correct JSON output
  • Validated skill structure with bun validate (no issues)

Checklist

  • SKILL.md has required frontmatter (name, description, metadata.author)
  • Skill directory name matches name in frontmatter
  • Description clearly explains when to use the skill
  • No sensitive data (API keys, tokens, personal handles) included
  • bun validate passes with no errors for this skill
  • Wrapper script tested and working
  • Reference documentation included (upstream README)

@skeletor-js
Copy link
Copy Markdown
Collaborator

Please fix the metadata and installation story before resubmitting.

  • Replace the placeholder author field YOUR_HANDLE.zo.computer with the real value.
  • Clean up the frontmatter so it looks like a finished registry submission rather than a copied template.
  • Do a general polish pass so the skill reads as production-ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants