Skip to main content
Glama

Most of a coding agent's context goes on finding things out: searching, opening files, following calls, checking what was tried before. All of it stays in the context, and it crowds out the real work.

ask-kit moves that work out of the agent's context. It gives the agent one tool, ask. The agent asks a question in plain words, and a cheap investigator works it out in its own context. The agent gets back a short answer, with the evidence it's based on. Your main agent keeps its context for the heavy lifting.

you:   add a CSV exporter like the other ones

agent → ask: how are the exporters built and registered, and which tests cover them?

ask   → Exporters implement Exporter in src/export/base.ts:12 and are registered in
        src/export/index.ts:30. JsonExporter (src/export/json.ts) is the closest model;
        tests are in test/export/*.test.ts.
        [code · glm-5.3-flash · 21s · $0.0031]

(This is an example of what an answer looks like. Measured has real numbers.)

ask is an MCP server, so any agent that takes MCP servers can use it: Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, opencode.

Read the guide: how to use it, use cases, models, tuning.

The work happens in code

The investigator doesn't work by calling tools one at a time. It writes a small JavaScript program for each step of the question, and runs it in a REPL. The program has whatever the step needs: loops, filters, joins, counts, comparisons, parsing. The logic is written fresh for that question. A domain only gives the programs a way in to the data. One program does what would otherwise take a dozen tool calls, and only what it prints comes back.

Your agent sends one question; the investigator writes small programs for it in its own context, reaching code, sessions and your own domains, and returns a short answer with path:line evidence

Each thing ask can answer about is a domain. ask-kit comes with two, as a starting point:

  • code: the repository the agent is working in, cited as path:line.

  • sessions: your past agent sessions, from the transcripts Claude Code, Codex, Copilot CLI, Gemini CLI and opencode already save. No proxy, no database.

Add your own for anything else your agent keeps digging through.

Related MCP server: RepoNav

Set it up

Paste one line into the agent you already use, on Linux, macOS or Windows:

Read https://github.com/temet-ai/ask-kit/blob/main/AGENTS.md, then set up ask-kit for me.

The agent installs ask-kit and asks you a few questions. The main one is which model does the digging:

  • an API key (cheapest and fastest),

  • a subscription you already pay for (Claude Code, Codex, Copilot),

  • or a local model.

It shows what it will change before it changes anything. Restart your agents afterwards, and they call ask by themselves when they need to find something out.

Without an agent: npm install -g --allow-git=root github:temet-ai/ask-kit, then ask-kit init and ask-kit setup. It needs Node.js 22.13 or newer and git. Set it up has the details.

Measured

How much context one ask keeps out of the calling agent. These are medians from mike-ask, the proof of concept ask-kit grew from:

Median per ask: 195,733 tokens read by the investigator, about 340 returned to your agent, 186 times less; 33 seconds and $0.0093

ask-kit itself, on 18 Nov 2026, on one machine with about 1,500 sessions on disk:

Question

Investigator

Time

Cost

What did a Codex session find and change

glm-5.3-flash (OpenRouter)

16 s

$0.0022

Which sessions worked on X in the last week

glm-5.3-flash, domain picked by the router

53 s

$0.0083

Follow-up on that (continue: true)

glm-5.3-flash

17 s

$0.0035

Which Copilot session did a piece of work, under which ticket

Claude Code, haiku

23 s

$0.0025

same

Codex (ChatGPT plan)

36 s

in the plan

same

Copilot CLI

134 s

Copilot premium requests

How does routing work in this repo

deepseek-v4.1-flash (code)

110 s

$0.0033

What's in this repository

Folder

What

bin/, src/

the ask-kit command, the MCP server, the investigator loop, the transcript readers

domains/

the two built-in domains, code and sessions: instructions, scripts and the typed description of what they can reach

bundle/

what ask-kit init installs into each agent: three skills, the ask-kit-tuner agent and the when-to-ask rule. They are templates, and init fills in this machine's paths.

docs/user-guide/

the guide, also at temet.ai/docs/ask-kit

Status

Early. Tested on Linux with real transcripts. Fixtures for all five transcript formats run in CI on Linux, macOS and Windows. The Gemini CLI reader and the opencode and Gemini install formats follow their docs, but haven't yet been tried on a real install. There are no releases yet, so you install from main.

ask-kit started as mike-ask, a proof of concept that answers from what mike records of every Claude Code session. ask-kit is the general version. It needs no mike and no server.

What it stores and sends

It sends your question, and the excerpts the investigator reads, to the model you chose. There's no telemetry. Everything it keeps is under ~/.config/ask-kit/ and ~/.local/state/ask-kit/. What it stores and sends has the full list.

Contributing

Bug reports and small fixes are welcome; see CONTRIBUTING.md. Report security problems privately, as SECURITY.md says.

Licence

MIT, see LICENSE. Third-party licences are in THIRD-PARTY-NOTICES.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables locating evidence for repository questions using CodeGraph or ripgrep, providing verified results and follow-ups.
      8 npm
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to perform read-only source investigation via a local SQLite index, offering status, search, backlog, context, impact, and drift tools for TypeScript, JavaScript, and Java codebases.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables coding agents to analyze a repository evidence-first, answering questions as verifiable claims with source evidence, targeted test observations, and reference resolution.
      5
      3
      Apache 2.0