bgauryy/octocode

Code research platform for AI agents: local + GitHub search, LSP semantics, AST patterns, and compact context. one toolset as MCP or CLI

What it solves

Octocode 是一个代理式研究平台，旨在将 AI 代理和开发者从“猜测驱动”转变为“研究驱动”的编码方式。它提供统一的工具集，从本地工作区和外部来源（GitHub、npm）收集具体证据，使代理能够基于实际的代码结构和历史，而不是假设，来进行更改和解释。

How it works

Octocode 使用高性能的 Rust 引擎，提供 12 种工具，可通过命令行界面（CLI）或模型上下文协议（MCP）服务器访问。它集成本地文件系统、GitHub API 与语言服务器协议（LSP）服务器，执行语义导航和结构分析。为优化 token 使用，它可以实时对 70 多种语言的代码进行压缩或骨架化，确保代理只获取相关结构而不受样板噪音干扰。

Who it’s for

该平台面向需要研究大规模代码库、比较多个仓库之间模式，并在本地和远程代码中进行深度语义导航（如解析定义和调用层级）的 AI 代理和开发者。

Highlights

  • Unified Research Flow: 将本地搜索、GitHub 仓库/PR 研究和 npm 包查询合并为一个工具集。
  • MCP & CLI Support: 可直接集成到 AI 助手（如 Cursor、VS Code、Windsurf）或作为独立终端工具使用。
  • Semantic Navigation: 利用 LSP 进行类型导航，包括调用者、被调用者和类型定义。
  • Structural Search: 支持使用 AST 形状的搜索，通过模式或 YAML 规则避免从注释或字符串中产生误报。
  • Token Efficiency: 压缩和骨架化代码，以减少在样板上消耗的 token 数量。
  • Built-in Security: 在内容送达 LLM 前，自动扫描并隐藏机密信息（AWS、OpenAI 等）。