Balanov/shim

Tiny local-first AI harness: any model, MCP and Agent Skills, natural-language CLI. Zero dependencies. MIT.

Open original source ↗

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

A tiny, local-first AI harness for people who prefer a terminal. One static binary. Zero dependencies. No TUI. No telemetry. MIT. Model-agnostic coding agents are everywhere. Setting them up is still too hard: provider IDs, API endpoints, MCP JSON, skills directories, and a new interface for every tool. Shim is the small adapter between you and all of that. Measured on the maintainer's Windows machine for v0.1.0: 7.29 MiB stripped binary and 9.96 ms median process startup for shim --version over 30 runs. This is a local measurement, not a cross-platform performance guarantee. Get a static binary for Windows, macOS, or Linux from Releases, put it on your PATH, then run: On PowerShell, use .\shim.exe when running the binary from the current directory. Go 1.25+: Windows also has scripts/build.ps1; Unix has scripts/build.sh. Shim has deterministic offline phrases for common English and Russian management commands. For other languages, assign a local…

Balanov/shim on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-11-03T13:01:26.404Z

Inside the original README — Document outline
  1. Why Shim?
  2. Install
  3. Download
  4. With Go
  5. From source
  6. Two ways to use it
  7. Just talk
  8. Use the complete CLI
  9. Model providers
  10. Skills
  11. MCP
  12. Permissions and safety

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

Tiny local-first AI harness: any model, MCP and Agent Skills, natural-language CLI. Zero dependencies. MIT.

Repository facts

Owner
Balanov
Primary language
Go
Stars
415
Forks
0
Open issues + pull requests
0
License
MIT
Archived
No
Default branch
main
Created
2026-11-02T17:54:29.000Z
Last push
2026-11-02T17:54:55.000Z

Topics and intended use

No topics were included in the latest source metadata.

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-11-03T12:18:30.805Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

avelino/awesome-go

ollama/ollama

golang/go

kubernetes/kubernetes

JuliusBrussee/caveman

netdata/netdata