whatisgithub

What is claude-imps?

johnlindquist/claude-imps — explained in plain English

Analysis updated 2026-05-18

14JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A set of small, isolated command line AI agents, each dedicated to one CLI tool like git, docker, or ffmpeg.

Mindmap

mindmap
  root((repo))
    What it does
      One agent per CLI tool
      Isolated configs
      Interactive or scripted runs
    Tech stack
      JavaScript
      Bun
      Claude Agent SDK
    Use cases
      Automate git or docker tasks
      Pipe data into jq or ffmpeg
    Audience
      Developers
      Ops engineers

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 build with it?

USE CASE 1

Ask a focused AI agent to summarize recent git changes or manage branches.

USE CASE 2

Pipe a JSON file into the jq imp and ask questions about the data in plain English.

USE CASE 3

Run guarded, scriptable commands against Docker, Kubernetes, or cloud providers without full system access.

USE CASE 4

Route a single request across multiple CLI tools automatically using the claude-imp router.

What is it built with?

JavaScriptTypeScriptBunClaude Agent SDK

How does it compare?

johnlindquist/claude-impsabdulrdeveloper/chai-aur-reactanasnakawa/kalendae-skins
Stars141414
LanguageJavaScriptJavaScriptJavaScript
Last pushed2013-12-07
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencedevelopervibe coderdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the Bun runtime and a configured Claude or Anthropic API credential.

So what is it?

claude-imps is a collection of small command line agents, called imps, each one built to work with exactly one existing CLI tool such as git, docker, npm, kubectl, aws, or ffmpeg. Instead of giving an AI assistant access to everything on your machine, each imp is a single file that wraps one tool with a narrow, focused Claude powered agent that only knows how to talk to that tool. Every imp loads none of your personal configuration, meaning no plugins, skills, hooks, saved memories, or other connected services carry over. Each one runs with its own isolated settings and credentials, and unused capabilities like email, chat, web browsing, or image generation are switched off unless that specific imp needs them. Some imps, like the one for ripgrep, are read only, while others such as the ones for jq or ffmpeg are allowed to write within your project folder but cannot overwrite your original files. There are dozens of these imps covering tools people commonly use day to day, including version control, containers, cloud providers, Kubernetes, databases, JSON processing, video and image editing, GitHub, and more. Some are guarded, meaning risky actions like deleting cloud resources or applying infrastructure changes require extra care built into the tool. You can use each imp in two ways: an interactive mode that opens a chat like interface in your terminal, or a non interactive run mode that streams output for scripting and automation. Data can also be piped in from another command, so you could pipe a JSON file into the jq imp and ask it a question about the data, or pipe your git log into the git imp and ask for a summary of recent changes. There is also a router command called claude-imp that reads what you typed and picks the right imp for the job using keyword matching rather than an AI call, so it responds instantly and predictably. If your request touches more than one tool, it can even split the request and run each part through the matching imp in order. Installing the project requires the Bun JavaScript runtime, and setup is done by cloning the repository, running the install command, and linking the tools so they become available from your terminal.

Copy-paste prompts

Prompt 1
Help me install claude-imps with Bun and link the imps to my terminal.
Prompt 2
Show me how to pipe my git log into claude-imp-git and get a summary of what changed this week.
Prompt 3
Explain how the claude-imp router picks which tool to use from my prompt.
Prompt 4
Walk me through building my own custom imp using the imp-minimal template.

Frequently asked questions

What is claude-imps?

A set of small, isolated command line AI agents, each dedicated to one CLI tool like git, docker, or ffmpeg.

What language is claude-imps written in?

Mainly JavaScript. The stack also includes JavaScript, TypeScript, Bun.

How hard is claude-imps to set up?

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

Who is claude-imps for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.