Local context for coding agents

Save 30% of your AI coding tokens.

Let your coding agent spend tokens writing code, not finding it.

Measured in our three-turn coding-agent test.

  • Open Source
  • Runs Locally
  • Free
find session handlingLOCAL INDEXRANKED RESULTSsession.tsmiddleware.tsuser.tsCODEBASEworking treelocal · indexed3 FILEScoding agent
The query “find session handling” searches the local codebase index, ranks session.ts, middleware.ts, and user.ts, bundles the three relevant files, and sends them to the coding agent.
30%
Fewer tokens used

Avg. across our coding-agent test

60–70%
Less context overhead

In our three-turn experiment

100%
Local — nothing leaves your machine

Index, retrieval, and source code

Free
Open source, always

Apache 2.0 on GitHub

Where do those tokens go?

Before your agent can write code, it spends context searching, opening files, and following connections.

01

Finding the code

The agent searches broadly before it knows where to work.

"Add resource management."
  1. grep "resource" .
  2. 142 matches
  3. rg "resourceManager"
  4. 17 matches
  5. cat src/runtime/manager.ts
  6. rg "session" src/
  7. read session.ts
  8. inspect related files
  9. finally code
02

Understanding the connections

One useful file leads to the related code the change depends on.

inspect related files

It helps your AI find the right code.

Scubiee gives coding agents focused repository context before they start writing.

Find the right code.

Search by meaning and surface the files that matter to the task.

Understand the codebase.

Follow relationships between files without opening the whole repository.

Read only what matters.

Return focused context instead of large, token-heavy file dumps.

Stay up to date.

Refresh changed files incrementally as your codebase evolves.

Run locally.

Keep your repository index and source code on your machine.

Built for agents.

Connect to the coding tools you already use through MCP.

MCP tools

What your agent actually calls.

Scubiee exposes one tool, map, with two configs. Pick by what you know; act on the first good answer and stop. map partners with your agent's native Grep/Read — a known literal or exact path stays with the native tool.

map find

Where is X handled?

You don't know where the code is. One query → ranked locations with the relevant code inline. Also orients a wide/unknown area and pulls code near a chunk you already hold.

map focus

Show me this handler and how it's wired.

You know the symbol name. Returns its full body + callers/callees + sibling symbols in one unit — edit straight from it.

gate / status

Is this repo ready?

One health check at session start — managed, warming, or needs init/connect.

Recommended agent flow

status → map find | map focus → edit → scubiee sync .

Less searching. More building.

Give your agent a shorter path from a question to the code it needs.

Without Scubiee

  1. 1grep "resource"
  2. 2rg "resourceManager"context
  3. 3read manager.tscontext
  4. 4grep "session"context
  5. 5read session.tscontext
  6. 6inspect related filescontext
  7. 7code

With Scubiee

  1. 1map find("resource management")
  2. 2ranked files + inline code → edit

7 → 4 steps

Fewer retrieval steps

60–70%

Fewer context tokens used

More room

Left for actual coding

Your code stays on your machine.

Scubiee builds and uses its repository index locally, so your source code does not need to leave your computer.

Keep the repository, index, and retrieval loop inside your local environment.

  • Local
  • Open Source
  • Free
Read the docs →

Local repository index

Use it where you already code.

Connect Scubiee to compatible coding agents through the Model Context Protocol.

  • Cursor

    via MCP server

  • Claude Code

    via MCP server

  • Codex

    via MCP server

  • OpenCode

    via MCP server

  • Any MCP tool

    if it supports MCP

Compatibility is provided through MCP and does not imply endorsement by, or partnership with, any agent provider.

Three simple steps.

A focused retrieval loop gives your coding agent the context it needs.

  1. 01

    Index

    Build a local repository index — Scubiee scans your codebase and stores embeddings and relationships on your machine.

  2. 02

    Find

    Query the index by meaning. Scubiee surfaces the files and functions most relevant to the task, not the whole codebase.

  3. 03

    Read

    Return focused, ranked context to the agent. Less noise, fewer tokens, and more room to actually write code.

Incremental refresh — changed files update in under a second.

Your index stays current without re-indexing the entire codebase.

Less context. Same job.

A measured experiment shows how focused retrieval can leave more of the context window available for coding.

Three-turn experiment

60–70% fewer context tokens

In our three-turn coding-agent experiment, Scubiee used about 60–70% fewer context tokens than the comparison workflow. Results vary by repository and task.

Comparison workflowBroad context
ScubieeFocused context

Ready when you are

Start using Scubiee.

  1. 1Install
  2. 2Index your repo
  3. 3Connect your agent

Takes about 2 minutes to set up end-to-end.