DEV Community

ellugia
ellugia

Posted on

CodeScope: Use Your ChatGPT Quota to Understand Local Repositories

#mcp #ai #node #opensource

I wanted to use the ChatGPT quota I already have for repository questions, without turning every exploratory step into a coding-agent task.

That is the reason I built CodeScope.

CodeScope is a local, read-only MCP bridge that lets an MCP-compatible chat inspect the repositories you explicitly choose on your computer.

The idea is simple: use the quota from ordinary ChatGPT conversations for code exploration, while keeping Codex or other coding-agent capacity available for implementation work.

What CodeScope does

CodeScope gives an MCP-compatible chat a controlled way to understand selected repositories:

  • read files from configured repositories
  • inspect Git history and repository status
  • keep the accessible repositories in an explicit local allowlist
  • work locally through the standard MCP connection
  • keep repository access read-only by design

The bridge does not expose commits, checkout, reset, arbitrary filesystem paths, or a general-purpose command shell. It only works with repositories that the user explicitly configures.

Install

The recommended installation is global:

npm install --global @ellugia/codescope
codescope setup
Enter fullscreen mode Exit fullscreen mode

The setup wizard creates the local configuration, lets you choose the repositories that CodeScope can access, and guides you through connecting it to your MCP client.

A project-local installation is also available:

npm install @ellugia/codescope
npx codescope setup
Enter fullscreen mode Exit fullscreen mode

Once it is configured, you can ask questions such as:

  • Where is authentication connected?
  • Which modules call this function?
  • What changed in the last five commits?
  • How is this repository organized?
  • Which files are involved in this feature?

The goal is to make repository exploration feel like a normal conversation, while keeping the actual files on the user’s own computer and the accessible scope explicit.

CodeScope is open source and released under the MIT license.

It was built primarily with ChatGPT 5.6 Luna Max, followed by manual review, integration testing, and security checks.

GitHub: https://github.com/ellugia/codescope

npm: https://www.npmjs.com/package/@ellugia/codescope

If you use ChatGPT, Codex, or another MCP-compatible client to understand codebases, I would love to hear how you use this workflow and what would make it more useful.

Top comments (0)