Paperclip

Overview

Paperclip is a platform for orchestrating AI agents. The Open Accountant adapter (@openaccountant/adapter-paperclip) makes Wilson available as a selectable agent type — with pre-built CFO and Bookkeeper agents that run on daily or weekly heartbeats.

How It Works

The adapter acts as a bridge between Paperclip and Wilson CLI:

1. Paperclip routes a task to the Wilson agent type
2. The adapter builds a natural-language prompt from the task context
3. Wilson CLI executes in headless mode (--run)
4. Output streams back to Paperclip’s transcript viewer
5. The UI parser structures Wilson’s stdout into readable transcript entries

Installation

Install the adapter

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

Or install from a local development path:

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

Import the company template

The skills repository includes pre-built Paperclip agent templates:

npx paperclipai company import --from ./open-accountant

Download the skills

npx skills add openaccountant/skills

Prerequisites

Requirement	Check
Bun runtime	bun --version
Wilson CLI on PATH	wilson --version
SQLite database	Auto-created on first Wilson run at ~/.openaccountant/data.db

The adapter validates all prerequisites before running and surfaces clear error messages if anything is missing.

Configuration

Field	Type	Default	Purpose
wilsonPath	string	"wilson"	Path to Wilson CLI binary
dbPath	string	~/.openaccountant/data.db	SQLite database location
timeout	number	120000	Max execution time in milliseconds

Pre-built Agents

CFO (Weekly heartbeat)

Strategic financial analysis and reporting. Skills:

• profit-loss — Income statement generation
• cash-flow-forecast — 3-6 month projections
• runway-calculator — Months of runway at current burn rate
• quarterly-taxes — Estimated tax payment calculation
• contractor-tracking — 1099 payment tracking
• revenue-concentration — Client concentration risk analysis

Bookkeeper (Daily heartbeat)

Day-to-day transaction management. Skills:

• import-transactions — Automated transaction import
• smart-categorize — AI-powered batch categorization
• month-end-close — Monthly bookkeeping checklist
• expense-optimizer — Recurring expense reduction
• monthly-digest — Financial summary with highlights

Architecture

The adapter has three main modules:

Module	File	Purpose
Metadata	src/index.ts	Registers Wilson as an agent type in Paperclip
Executor	src/server/execute.ts	Spawns Wilson CLI and captures output
UI Parser	src/ui-parser.ts	Parses stdout into Paperclip transcript entries

The UI parser recognizes Wilson’s output patterns — report headers (=== ... ===), tool calls ([tool]), and results ([result]) — and converts them into structured transcript format for Paperclip’s viewer.