whatisgithub

What is loopkit?

archive228/loopkit — explained in plain English

Analysis updated 2026-05-18

712ShellAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

Loopkit is a drop-in .claude harness plus 49 markdown skills that give coding agents like Claude Code or Cursor a plan, act, verify workflow enforced by files on disk.

Mindmap

mindmap
  root((loopkit))
    What it does
      Drop-in .claude harness
      49 markdown skills
      Plan Act Verify loop
    Tech stack
      Shell
      Markdown
      YAML
      MCP
    Use cases
      Add harness to a project
      Cherry-pick single skills
      Enforce reviewable diffs
    Audience
      Coding agent users
      Claude Code and Cursor devs

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

Install a plan, act, verify harness into an existing project so a coding agent's changes get checked before shipping.

USE CASE 2

Cherry-pick a single skill, such as adversarial verification, without adopting the whole harness.

USE CASE 3

Give a coding agent a lightweight standing context and permission allowlist instead of letting it improvise.

What is it built with?

ShellMarkdownYAMLMCP

How does it compare?

archive228/loopkitasimovinc/asimov-1pyenv/pyenv-virtualenvwrapper
Stars712719678
LanguageShellShellShell
Last pushed2017-08-20
MaintenanceDormant
Setup difficultyeasyhardeasy
Complexity2/55/52/5
Audiencedeveloperresearcherdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

One-line curl install script drops the harness into an existing project directory.

MIT license: use, modify, and redistribute freely, including commercially, as long as the copyright notice is kept.

So what is it?

Loopkit is a drop-in set of files that gives a coding agent, such as Claude Code, Cursor, Codex, or Gemini CLI, a structured way of working: plan, act, then verify. It installs into a project's .claude folder with a single install script and does not run as a background service or daemon. Everything it adds is plain files on disk: settings, hooks, a verifier subagent, a loop runner script, and a library of 49 small skills. Each skill is a short markdown document with a YAML header describing what it does and when it should load. Skills only activate when a task actually triggers them, so the agent is not carrying every possible instruction at once. The skills are grouped into ten tracks covering things like agent behavior, long running multi session projects, debugging, and security review. The core loop the project enforces is plan, act, verify, and then revise if verification fails. Planning skills such as spec first and context budget load before work starts. Action skills for tasks like debugging, testing, refactoring, or git operations load while work happens. A separate verifier subagent, described as adversarial, checks the resulting change afterward, assuming it is broken until proven otherwise, and returns its findings as JSON rather than proposing fixes itself. A project using loopkit ends up with a small standing context file limited to 60 lines, a permissions file that allows safe read only commands while blocking risky ones like force pushes, a hooks folder that reminds the agent of the loop shape when a session starts, an MCP configuration file wired to GitHub and Context7 by default, and a memory file meant to be pruned regularly so it does not accumulate stale notes. The project describes itself as opinionated but not a methodology to learn or a vendor lock in. Since it is plain markdown and shell files under an MIT license, a user can keep only the pieces they want and discard the rest. It is aimed at developers who already use an AI coding agent and want a lightweight, file based structure for keeping that agent's work reviewable and verified rather than free form.

Copy-paste prompts

Prompt 1
Walk me through installing loopkit's .claude harness into my existing project using the install.sh script.
Prompt 2
Explain how loopkit's plan, act, verify loop works and which skills load at each stage.
Prompt 3
Show me how to cherry-pick just the adversarial-verify skill from loopkit using loopkit-add.
Prompt 4
How does loopkit's verifier subagent decide whether a change passes, and what does it return?

Frequently asked questions

What is loopkit?

Loopkit is a drop-in .claude harness plus 49 markdown skills that give coding agents like Claude Code or Cursor a plan, act, verify workflow enforced by files on disk.

What language is loopkit written in?

Mainly Shell. The stack also includes Shell, Markdown, YAML.

What license does loopkit use?

MIT license: use, modify, and redistribute freely, including commercially, as long as the copyright notice is kept.

How hard is loopkit to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is loopkit for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.