loopkit

Loopkit is an autonomous agent CLI implementing the Ralph loop technique. It reads issues from a configured source, builds a PRD batch, and iterates one story at a time through your chosen LLM runner.

Requirements

• Node.js >= 18
• Optional: GitHub CLI (gh) when using the GitHub source

Quickstart

Run in any repo:

npx @romkaltu/loopkit init

This creates:

• loopkit.config.json (configuration)
• .loopkit/ (runtime data: prompt, prd, progress, batches)

Generate a batch PRD:

npx @romkaltu/loopkit batch

Run the loop:

npx @romkaltu/loopkit run

Run quality gates for a specific story:

npx @romkaltu/loopkit quality --story STORY_ID

Archive a completed batch:

npx @romkaltu/loopkit archive

Config

Loopkit loads config from loopkit.config.json, loopkit.config.cjs, or loopkit.config.mjs in the current repo. The generated config includes defaults for runner, batch source, and output paths under .loopkit/.

A sample config is available at examples/loopkit.config.json.

Release

1. npm login
2. npm run build
3. npm publish --access public (add --otp=123456 if your account requires 2FA)

If you prefer tokens, generate a granular access token with publish permissions and 2FA bypass, then set:

npm config set //registry.npmjs.org/:_authToken=YOUR_TOKEN