> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Paperclip Plugin

> The BossMode Paperclip plugin adds the consigliere context directly into your Paperclip agent harness. Get operational intelligence without leaving your workflow.

<Warning>🚧 Expanding soon — full Paperclip Plugin documentation is in progress.</Warning>

## 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

```bash theme={null}
npm i @acelabs/bossmode-paperclip-plugin
```

## Configuration

Add to your Paperclip config:

```json theme={null}
{
  "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:

```javascript theme={null}
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