paperclip-plugin-claude-config-editor

A Paperclip plugin that lets instance administrators edit Claude Code configuration files (.claude.json and .credentials.json) through the Paperclip settings UI.

Features

• Edit ~/.claude.json (Claude Code settings) and ~/.claude/.credentials.json (API credentials) from the admin settings page
• JSON validation before saving
• Atomic file writes to prevent partial updates
• Confirmation prompt before overwriting credentials

Installation

npm install paperclip-plugin-claude-config-editor

Then register the plugin in your Paperclip instance configuration.

Development

# Install dependencies
npm install

# Build the plugin
npm run build

# Watch mode (rebuilds on changes)
npm run dev

# Start the plugin dev server for UI development
npm run dev:ui

# Type-check without emitting
npm run typecheck

How it works

The plugin registers a settings page slot in Paperclip's admin UI. It exposes:

• Data source (claude-config) — reads the current contents of both config files
• Action (save-claude-config) — validates and writes updated JSON back to disk

Access is gated by the instance.settings.register capability, so only instance admins can view or modify the configuration.

License

MIT