# Papercrane CLI

Connect AI to your data for building shareable dashboards.

## Install
```
npm install -g @papercraneai/cli
```

## Login
```
papercrane login --url https://fly.papercrane.ai
```
Run this command. If a browser is available, it opens automatically and completes login. If no browser is available, it prints an authorization URL — show that URL to the user to open in their browser, then run `papercrane login --complete`.

## Handling URLs

Several commands (like `papercrane add`) print URLs that require the user to visit them in a browser. How you handle these depends on your environment:
- **Shell access on user's machine:** Open the URL directly (e.g. `open <url>` on macOS, `xdg-open <url>` on Linux).
- **Sandbox/container:** Show the URL to the user and ask them to open it.

## What's next

Run `papercrane --help` to see all available commands. Key ones:
- `papercrane` — list connected integrations and endpoints
- `papercrane add <integration>` — connect a new data source
- `papercrane describe <module>` — explore a module's endpoints
- `papercrane call <path>` — call an endpoint
- `papercrane dashboard-guide` — how to build and deploy dashboards
- `papercrane local-integration-guide` — how to build custom local API integrations