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:

``bash
npx @romkaltu/loopkit init
`

This creates:

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

Generate a batch PRD:

`bash
npx @romkaltu/loopkit batch
`

Run the loop:

`bash
npx @romkaltu/loopkit run
`

Run quality gates for a specific story:

`bash
npx @romkaltu/loopkit quality --story STORY_ID
`

Archive a completed batch:

`bash
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:

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