bosun.sh / ohtools

Ohtools

Build explorable Bun TypeScript tool apps for agents. Define typed tools once, inspect the app without side effects, then run it locally or expose it over MCP stdio.

Read the docs

what it is

Bun TypeScript tool apps.

Ohtools is a small framework for declaring typed tools, grouping them into an inspectable app, and sharing that same app with local CLIs or MCP stdio clients.

problem

Agents need the map before the action.

Coding agents should be able to discover tool names, input contracts, hierarchy, and metadata before invoking handlers or changing project behavior.

why better

One definition, multiple surfaces.

Tool schemas, descriptions, handlers, CLI execution, and MCP exposure come from the same TypeScript app, reducing drift between docs, commands, and runtime behavior.

when to use it

Agent-maintained project tooling.

Use Ohtools for repo-specific operations, workflows, and maintenance commands that need typed inputs, side-effect-aware discovery, and a clear project contract.