{
  "name": "Paperclip",
  "slug": "paperclip",
  "categories": [
    20
  ],
  "date_created": "2026-04-15",
  "type": "ct",
  "updateable": true,
  "privileged": false,
  "interface_port": 3100,
  "documentation": "https://docs.paperclip.ing/",
  "website": "https://paperclip.ing/",
  "logo": "https://github.com/paperclipai.png",
  "description": "Paperclip is an open-source orchestration platform for managing autonomous AI agent teams with goals, routines, governance, and a browser-based control plane.",
  "install_methods": [
    {
      "type": "default",
      "script": "ct/paperclip.sh",
      "config_path": "/opt/paperclip/.env",
      "resources": {
        "cpu": 4,
        "ram": 8192,
        "hdd": 20,
        "os": "Debian",
        "version": "13"
      }
    }
  ],
  "default_credentials": {
    "username": null,
    "password": null
  },
  "notes": [
    {
      "text": "The installer attempts Paperclip authenticated/private onboarding for LAN access. If a Paperclip release falls back to local quickstart behavior, first access will not require login and you can switch modes later with `pnpm paperclipai configure --section server`.",
      "type": "info"
    },
    {
      "text": "Persistent Paperclip runtime data is stored in `/opt/paperclip-data`, while the application code lives in `/opt/paperclip`.",
      "type": "info"
    },
    {
      "text": "Database credentials are stored in `~/paperclip.creds`. These are PostgreSQL credentials generated by the shared helper, not the Paperclip web login or Codex/Claude authentication.",
      "type": "info"
    },
    {
      "text": "If authenticated mode is active, the installer saves the current CEO bootstrap invite in `~/paperclip.creds`. Open that invite to finish the initial admin setup. You can generate a fresh invite later with `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai auth bootstrap-ceo`.",
      "type": "info"
    },
    {
      "text": "If you access Paperclip from a different hostname, update `PAPERCLIP_PUBLIC_URL` in `/opt/paperclip/.env` and restart the `paperclip` service. For authenticated/private hostname access, run `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai allowed-hostname <hostname>` after the first startup.",
      "type": "info"
    },
    {
      "text": "If you want to change Paperclip's deployment mode later, run `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai configure --section server`.",
      "type": "info"
    },
    {
      "text": "Codex and Claude Code are preinstalled. Because the Paperclip service runs as root, authenticate them as root inside the container so Paperclip can reuse those credentials.",
      "type": "info"
    },
    {
      "text": "For Codex, run `codex` and choose ChatGPT login for interactive use, or use API-key authentication for more programmatic workflows. Claude Code can be authenticated by running `claude` and using `/login`, or by providing Anthropic API credentials.",
      "type": "info"
    }
  ]
}