paperclip-adapters

KO | EN

gitlite — search

#python #ai #go #android #rust #deep-learning #docker #java #cli #kubernetes #vue #ios #openai #open-source

paperclip-adapters

(★ 9)

External adapter pack for paperclipai/paperclip — cline, qwen, and more.

paperclip-adapters Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# paperclip-adapters

External adapter pack for [paperclipai/paperclip](https://github.com/paperclipai/paperclip) — adds runtime support for new agent CLIs beyond the builtin set.

Each adapter ships as its own npm package under `@superbiche/*`. They plug into a Paperclip instance via the external adapter plugin system (`POST /api/adapters/install`).

## Packages

| Package | Wraps | Version |
|---|---|---|
| [`@superbiche/cline-paperclip-adapter`](./packages/cline-local) | [Cline CLI 2.x](https://github.com/cline/cline) | [![npm](https://img.shields.io/npm/v/@superbiche/cline-paperclip-adapter.svg)](https://www.npmjs.com/package/@superbiche/cline-paperclip-adapter) |
| [`@superbiche/copilot-paperclip-adapter`](./packages/copilot-local) | [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli) | [![npm](https://img.shields.io/npm/v/@superbiche/copilot-paperclip-adapter.svg)](https://www.npmjs.com/package/@superbiche/copilot-paperclip-adapter) |
| [`@superbiche/qwen-paperclip-adapter`](./packages/qwen-local) | [Qwen Code CLI](https://github.com/QwenLM/qwen-code) | [![npm](https://img.shields.io/npm/v/@superbiche/qwen-paperclip-adapter.svg)](https://www.npmjs.com/package/@superbiche/qwen-paperclip-adapter) |

Every adapter declares `sessionManagement` with `supportsSessionResume: true`. Their CLI-native session handles (`cline -T <taskId>`, `copilot --resume=<sessionId>`, `qwen -r <sessionId>`) round-trip through Paperclip's `agent_task_sessions` table and resume across heartbeats.

## Quickstart

```bash
pnpm install
pnpm build
pnpm test
```

## Installing an adapter into a Paperclip instance

**Local path (dev / Berceuse smoke):**

```bash
curl -X POST http://127.0.0.1:3100/api/adapters/install \
  -H 'content-type: application/json' \
  -d '{"packageName":"/absolute/path/to/paperclip-adapters/packages/cline-local","isLocalPath":true}'
```

On paperclip built from commit `3d15798` or later (ships in `canary/v2026.423.0-canary.2` and the next stable), hot-install picks up `sessionManagement` without a restart. On older releases (v2026.416.0 and prior, pre-[paperclipai/paperclip#4324](https://github.com/paperclipai/paperclip/pull/4324)), restart Paperclip once after install so the IIFE path can register it.

**npm (once published):**

```bash
curl -X POST http://127.0.0.1:3100/api/adapters/install \
  -H 'content-type: application/json' \
  -d '{"packageName":"@superbiche/cline-paperclip-adapter"}'
```

## Adapter authoring notes

Gaps in Paperclip's plugin system that affect adapter authors — branches on [`superbiche/paperclip`](https://github.com/superbiche/paperclip), open/upstream PRs, deferred items — live in [`docs/authoring-gaps.md`](./docs/authoring-gaps.md).

## Release process

Versioning and publishing are automated via [changesets](https://github.com/changesets/changesets) + GitHub Actions + npm [trusted publishers](https://docs.npmjs.com/trusted-publishers) (OIDC, no long-lived tokens).

To ship a change:

1. Make your code change on a branch.
2. Run `pnpm exec changeset` and answer the prompts — select the affected packages, pick the bump level (`patch` / `minor` / `major`), write a short human-readable summary. This generates `.changeset/<slug>.md`.
3. Commit the changeset file alongside your code change. Open a PR, review, merge to `main`.
4. The Release workflow (`.github/workflows/release.yml`) opens a **"chore(release): version packages"** PR that rolls up all pending changesets into version bumps + CHANGELOG entries.
5. Merge that release PR → the workflow re-runs, detects no pending changesets, publishes to npm with provenance attestation.

No manual `npm publish`, no `NPM_TOKEN` in the repo. Provenance attestations are visible on the npm package page under **Provenance**.

## License

MIT

paperclip-adapters

paperclip-adapters Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

paperclip-adapters

paperclip-adapters Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README