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 a phase surface over MCP — semantic map first, focused reads second, grep when you need literals. Recommended flow: gate → map → focus → edit → sync if needed.

gate / status

Is this repo ready?

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

map

Where is X handled?

Ranked overview of paths and symbols — no full file bodies.

focus

Show me that handler

Deep-dive spans, neighbors, and call sites from a map hit.

grep

Find every API_KEY

Exact literals and regex across indexed files when you know the string.

glob

List all *test*.py

Path patterns over the index — faster than walking the tree blindly.

workspace

What did we already read?

Session memory — pins and heatmap so agents do not re-explore.

Recommended agent flow

status(root=workspace) → map(query) → focus(target) → 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. 1search("resource management")
  2. 2resource.ts · manager.ts · session.ts
  3. 3read
  4. 4code

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.