farhoodlabs/paperclip-adapter-opencode-k8s

T

Chris Farhood 72f7950da6 Add getConfigSchema to surface adapter config fields in UI

- src/server/config-schema.ts: define schema with Core, Kubernetes,
  and Operational field groups matching agentConfigurationDoc
- src/server/config-schema.test.ts: 10 tests covering field types,
  defaults, options, and group structure
- src/server/index.ts: attach getConfigSchema to ServerAdapterModule
- Revert k8s-client.ts loadFromConfig change (not available in installed
  @kubernetes/client-node version)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-12 10:35:31 -04:00

.github/workflows

Fix CI publish: write .npmrc before npm publish

2026-04-12 08:32:33 -04:00

src

Add getConfigSchema to surface adapter config fields in UI

2026-04-12 10:35:31 -04:00

.gitignore

Add tests, free-text model field, and K8s job improvements

2026-04-12 08:14:57 -04:00

package-lock.json

Add tests, free-text model field, and K8s job improvements

2026-04-12 08:14:57 -04:00

package.json

Bump version to 0.1.10

2026-04-12 09:52:09 -04:00

README.md

Update package name to @farhoodliquor scope and refresh README

2026-04-11 23:18:12 -04:00

tsconfig.json

Initial commit

2026-04-11 23:08:05 -04:00

vitest.config.ts

Add tests, free-text model field, and K8s job improvements

2026-04-12 08:14:57 -04:00

README.md

@farhoodliquor/paperclip-adapter-opencode-k8s

Paperclip adapter plugin that runs OpenCode agents as isolated Kubernetes Jobs instead of inside the main Paperclip process.

Features

Spawns agent runs as K8s Jobs with full pod isolation
Inherits container image, secrets, DNS, and PVC from the Paperclip Deployment automatically
Real-time log streaming from Job pods back to the Paperclip UI
Session resume via shared RWX PVC
Per-agent concurrency guard
Configurable resources, namespace, kubeconfig
Runtime config injection for permission bypass

Installation

Via Paperclip Adapter Manager

curl -X POST http://localhost:3100/api/adapters \
  -H "Content-Type: application/json" \
  -d '{"packageName": "@farhoodliquor/paperclip-adapter-opencode-k8s"}'

Local Development

curl -X POST http://localhost:3100/api/adapters \
  -H "Content-Type: application/json" \
  -d '{"localPath": "/path/to/paperclip-adapter-opencode-k8s"}'

Configuration

See the agent configuration documentation for all available fields:

model (required) — OpenCode model in provider/model format
variant — reasoning profile variant
namespace — K8s namespace for Jobs
image — Override container image
kubeconfig — Path to kubeconfig file
resources — CPU/memory requests and limits
timeoutSec — Run timeout (0 = no timeout)
retainJobs — Keep completed Jobs for debugging

Requirements

Paperclip must be deployed on a Kubernetes cluster with a shared RWX PVC mounted at /paperclip — this is required for session resume and workspace sharing between the Paperclip pod and agent Job pods
Kubernetes cluster with RBAC permissions to create Jobs, list Pods, and read Pod logs
@paperclipai/adapter-utils >= 0.3.0

License

MIT