git404hub

what is tobler fr?

datacompose/tobler — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A search tool for AI coding agents that adjusts how much code context it returns based on how confident the match is, instead of always giving a fixed number of results.

vibe map

mindmap
  root((tobler))
    What it does
      Adaptive context sizing
      Token budget aware
      Session smoothing
    Tech stack
      Python
      FastMCP
      NumPy
    Use cases
      AI coding agent context
      Large repo code search
      CLI search
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give an AI coding agent adaptive code context that expands for broad questions and shrinks for narrow ones.

VIBE 2

Improve code retrieval accuracy on large repositories where fixed top-5 search misses the target file.

VIBE 3

Run code search from the command line for agents or scripts without MCP support.

VIBE 4

Keep a multi-turn coding conversation focused on the same code across related follow-up questions.

what's the stack?

PythonFastMCPNumPy

how it stacks up fr

datacompose/tobler0-bingwu-0/live-interpreter0cm-labs/tokenizer-benchmark
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python 3.12+ and an MCP client such as Claude Code to use the server mode.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Tobler is a tool that decides how much code context to hand an AI coding agent for a given question, instead of always returning a fixed number of results. The idea, borrowed from a geography principle, is that things closer to the query in meaning are more relevant than things farther away, so the amount of context returned should stretch or shrink to match how confident the match is, all within a set token budget. A narrow, specific question like asking what a particular constant does gets back just a few full pieces of code plus a small map. A broad question like how a feature works across the codebase gets back a much wider map of function signatures and summaries. Both answers use the same token budget, just spread differently. The README reports that on large repositories, a fixed top-5 style search misses the right piece of code about two-thirds of the time, while this adaptive approach kept finding it in benchmark tests, using fewer tokens per correct answer along the way. Under the hood it standardizes similarity scores, applies a softmax function to turn them into weights, and uses those weights to decide how many chunks of code deserve attention and how much detail each one gets, from a full code body down to just a file path and symbol name. It also smooths results across a back-and-forth conversation, so a follow-up question like asking about the arguments to something just mentioned stays focused on the same code, while a totally different follow-up question is treated as a fresh topic. It is built on top of another retrieval library called semble and requires Python 3.12 or newer plus a client that supports the MCP protocol, such as Claude Code. It can be installed from PyPI and used either as an MCP server that an AI coding agent talks to directly, or from the command line for scripts and agents that do not support MCP. It also ships as an installable skill that teaches a coding agent when and how to use it. The project is licensed under the MIT License.

prompts (copy fr)

prompt 1
Help me install tobler-search and register it as an MCP server with Claude Code.
prompt 2
Explain how tobler decides how many code chunks to return for a given query.
prompt 3
Show me how to run a tobler search from the command line on my own repo.
prompt 4
Walk me through reproducing the benchmark numbers in the experiments folder.

Frequently asked questions

what is tobler fr?

A search tool for AI coding agents that adjusts how much code context it returns based on how confident the match is, instead of always giving a fixed number of results.

What language is tobler written in?

Mainly Python. The stack also includes Python, FastMCP, NumPy.

What license does tobler use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is tobler to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tobler for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.