External Paperclip adapter plugin for the current Kilo Code CLI.
📦 Available on JSR: jsr.io/@exocode/paperclip-kilocode-adapter
Repository: https://github.com/exocode/paperclip-kilocode-adapter
This package lets Paperclip run Kilo Code as a first-class external adapter plugin instead of hardcoding Kilo support into Paperclip core.
It targets the current Kilo Code CLI workflow documented in May 2026:
- install:
npm install -g @kilocode/cli - start:
kilo - non-interactive runs:
kilo run --auto "..." - update:
kilo upgrade - interactive provider setup:
/connect - config location:
~/.config/kilo/
Paperclip decides whether an adapter should render the local configuration UI from the adapter capabilities it exposes.
This adapter now explicitly opts into the local adapter UI contract so that Paperclip renders:
- the shared local model picker
- the shared local thinking-effort picker
- the adapter-specific Kilo fields
If you install an older version of this package, the model dropdown may be missing even though /adapters/kilocode_local/models already returns models.
Use version 0.2.1 or later.
This adapter exports the host-facing Paperclip plugin entrypoints expected by the external adapter loader:
createServerAdapter()./ui-parser
The adapter type is:
kilocode_local
src/index.ts— shared metadata and Paperclip export surfacesrc/server/module.ts—createServerAdapter()src/server/execute.ts— launches Kilo in autonomous modesrc/server/test.ts— lightweight environment checkssrc/server/session-codec.ts— session persistence codecsrc/server/config-schema.ts— declarative config schema for Paperclip UIsrc/server/detect-model.ts— best-effort model detection from Kilo config filessrc/ui-parser.ts— self-contained stdout transcript parser for Paperclip UI
npm install -g @kilocode/cli
kiloInside Kilo, finish provider setup with /connect if needed.
From JSR (recommended):
npx jsr add @exocode/paperclip-kilocode-adapterOr with deno:
deno add @exocode/paperclip-kilocode-adapterOr with pnpm:
pnpm dlx jsr add @exocode/paperclip-kilocode-adapterThen register it in Paperclip:
npx paperclipai adapter install @exocode/paperclip-kilocode-adapterIf you are developing locally from a checkout:
pnpm install
pnpm build
npx paperclipai adapter install /absolute/path/to/paperclip-kilocode-adapterIn the Paperclip agent configuration UI:
- choose adapter type
Kilocode (local) - choose a model in the shared
Modeldropdown - optionally set a specific
Kilo modeloverride
pnpm install
pnpm typecheck
pnpm buildIf pnpm on your machine points at an old PNPM_HOME, fix it temporarily before running commands:
export PNPM_HOME="$HOME/Library/pnpm"
export PATH="$PNPM_HOME:$PATH"Paperclip drives Kilo in autonomous mode with a prompt assembled from the current issue/task context.
The adapter intentionally uses the current Kilo CLI shape:
kilokilo run --auto --model <provider/model> "..."kilo --continuekilo upgrade
Recommended first model:
kilo/kilo-auto/balanced
You can list available models with:
kilo modelsUseful adapter config example:
{
"command": "kilo",
"model": "kilo/kilo-auto/balanced",
"cwd": "/absolute/path/to/workspace",
"timeoutSec": 1800,
"graceSec": 30,
"promptTemplate": "{{prompt}}"
}Kilo config is expected under:
~/.config/kilo/opencode.json~/.config/kilo/opencode.jsonc~/.config/kilo/kilo.jsonc~/.config/kilo/config.json
This repository includes .github/workflows/publish.yml for automated JSR publishing via GitHub Actions.
The workflow:
- runs on tags matching
v*or via manual workflow dispatch - uses OIDC authentication (no tokens needed!)
- runs
pnpm install,pnpm typecheck - publishes with
npx jsr publish --allow-slow-types
JSR uses GitHub OIDC for secure authentication in GitHub Actions. The workflow automatically authenticates using the repository's GitHub identity - no personal access tokens needed.
The id-token: write permission in the workflow file enables OIDC authentication.
For manual publishing from your local machine, JSR will prompt you to authorize via your browser the first time you run jsr publish.
- Bump
versionin bothpackage.jsonandjsr.json. - Commit to
main. - Create and push a Git tag:
git tag v0.2.2
git push origin main --tags- GitHub Actions publishes the package to JSR automatically.
You can also publish manually:
npm install -g jsr
jsr publish- Code comments are in English to help future maintainers.
- The implementation is intentionally conservative and only depends on the stable CLI contract documented by Kilo Code as of May 2026.
- If Kilo changes its CLI again, update
src/server/execute.tsand the README together.
MIT