Skip to main content
🚧 Expanding soon — full Paperclip Plugin documentation is in progress.

What is the Paperclip plugin?

Paperclip is an agent harness for running AI workflows. The BossMode Paperclip plugin connects your Paperclip environment to BossMode’s operational context — standing orders, buyer profiles, signal feed, and Guardian state — so your Paperclip agents have business context on every run.

Installation

npm i @acelabs/bossmode-paperclip-plugin

Configuration

Add to your Paperclip config:
{
  "plugins": [
    {
      "name": "@acelabs/bossmode-paperclip-plugin",
      "config": {
        "token": "${BOSSMODE_API_TOKEN}",
        "contextOnInit": true,
        "standingOrdersAsSystemPrompt": true
      }
    }
  ]
}

What gets injected

When contextOnInit: true, the plugin fetches your BossMode context on agent initialization and injects:
  • Standing orders as system prompt rules
  • Buyer profiles as context for audience-facing tasks
  • Current Guardian state as execution constraints
  • Active signals as business intelligence

Usage in Paperclip agents

Once the plugin is loaded, reference BossMode context in your agent prompts:
{{bossmode.standingOrders}}
{{bossmode.buyerProfiles}}
{{bossmode.signals}}

Logging back to BossMode

Moves executed via Paperclip can be logged to the BossMode audit feed:
await bossmode.logMove({
  capo: 'capo_marketing',
  action: 'email-drafted',
  description: 'Follow-up email drafted for cold lead batch',
  requiresApproval: true
});

Requirements

  • Paperclip v0.8.0 or higher
  • BossMode Pro account
  • BOSSMODE_API_TOKEN environment variable set