papercrane

CLI for Papercrane — give your AI agent access to your APIs, then ask it to build dashboards.

Papercrane connects to your SaaS tools (Google Analytics, Search Console, Stripe, HubSpot, and more) and exposes them as a unified API your AI can discover and call. Once you're set up, your AI handles the rest — exploring your data, writing dashboards, and building custom integrations.

Install

npm install -g @papercraneai/cli

Setup

# Sign in — opens a browser to authenticate
papercrane login

# Connect your integrations
papercrane add

# List what's available
papercrane

That's it. From here, your AI takes over.

What your AI can do

Explore integrations — your AI can list connected modules, describe endpoints, and call them directly to understand the data before building anything.

Build dashboards — dashboards are Next.js routes that your AI writes and hot-reloads locally via papercrane dev. When ready, papercrane push publishes them to the cloud.

Create custom integrations — if an integration isn't built-in, or if your data source is only reachable locally (behind a VPN, on a private network, etc.), your AI can create a local handler: a TypeScript file in app/_handlers/ that works like any other integration. Your AI has instructions for this built-in (papercrane local-integration-guide).

Workspaces

Dashboards live in workspaces. Pull a workspace to work on it locally, push to share it.

papercrane workspaces list
papercrane workspaces use <id>
papercrane pull
papercrane dev       # local dev server with HMR
papercrane push      # publish to the cloud

Commands

| Command | Description | |---------|-------------| | papercrane | List connected modules and endpoints | | papercrane login | Sign in (browser) or --api-key <key> | | papercrane logout | Sign out | | papercrane describe <path> | Describe a module or endpoint (--flat for all paths) | | papercrane call <path> [params] | Call an endpoint and print the result | | papercrane add [integration] | Connect a new integration | | papercrane workspaces list | List your workspaces | | papercrane workspaces use <id> | Set the active workspace | | papercrane pull | Pull workspace files to ~/.papercrane/workspaces/<id>/ | | papercrane push | Push local changes back to the cloud | | papercrane dev | Start a local Next.js dev server with HMR | | papercrane scaffold | Pre-scaffold a workspace directory (no login required) | | papercrane dashboard-guide | Dashboard building reference (for AI consumption) | | papercrane local-integration-guide | Local handler reference (for AI consumption) |

Configuration

Credentials and config live in ~/.papercrane/:

~/.papercrane/
├── config.json            # API URL, auth token
└── workspaces/<id>/       # pulled workspace files

To point at a different API host, set apiBaseUrl in ~/.papercrane/config.json.

Requirements

• Node.js 22.x
• npm 10.x

License

Elastic License 2.0. You may use, modify, and distribute this software freely, with two main restrictions: you may not offer it as a hosted or managed service to third parties, and you may not circumvent license key functionality.