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

# CLI and Configuration Reference

> CLI commands, configuration values, trigger bindings, input limits, and common errors.

## CLI

| Command | Use |
| - | - |
| `deepline setup --json` | Install skills. Connect the machine. Check the connection. |
| `deepline auth status --json` | Check the host, user, and workspace. |
| `deepline auth register` | Reconnect this machine only |
| `deepline doctor --json` | Diagnose a failed setup |
| `deepline org list` | See available workspaces |
| `deepline org set "$ORG_NAME"` | Set the active workspace |
| `deepline search "$QUERY"` | Find tools, Plays, Monitors, and docs. Filter with `--type`. |
| `deepline describe "$NAME" --json` | Inspect a tool, monitor type, or play by name |
| `deepline plays check "$PLAY_FILE"` | Validate a play without running it |
| `deepline plays run "$PLAY_FILE"` | Run a local play file |
| `deepline plays run -e "$CODE"` | Run code inline as a play function's body |
| `deepline plays publish "$PLAY_FILE"` | Publish a Play revision |
| `deepline plays deploy "$PLAY_DIR"` | Deploy every Play in a directory together |
| `deepline plays deployments "$DEPLOYMENT_ID"` | Read one deployment's results |

## Config

| Name | Use |
| - | - |
| `DEEPLINE_API_KEY` | Workspace API key |
| `DEEPLINE_HOST_URL` | Deepline host override |
| `.env.deepline` | Per-folder file containing only `DEEPLINE_HOST_URL` and `DEEPLINE_API_KEY` |

For automation, save `DEEPLINE_HOST_URL` and `DEEPLINE_API_KEY` in the folder's `.env.deepline`.
Run `deepline ...` commands from that folder.

## Input size limits

| Input size | Behavior |
| - | - |
| Up to 100 KB | Stored inline in coordinator retry state |
| 100 KB to 1 MiB | Stored as a short-lived artifact-backed retry payload |
| Over 1 MiB | The API rejects the input. Use staged files or `deepline.csv` inputs. |

Play input should contain parameters, filters, and file references.
Pass large tables, lead lists, research corpora, and documents through a file path.
Read the file inside the Play with `deepline.csv(path)` or the appropriate file reader.

## Bindings

Triggers and limits go in `export const config = { ... }`, once, at the top of the play:

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import deepline from 'deepline';

export const config = {
  webhook: {},
  cron: { schedule: '0 9 * * *', timezone: 'America/New_York' },
  billing: { maxCreditsPerRun: 25 },
};

export default async function () {
  return { ok: true };
}
```

## Common fixes

| Symptom | Try |
| - | - |
| Missing API key | `deepline setup` or add `DEEPLINE_API_KEY` to `.env.deepline` |
| Wrong workspace | `deepline auth status` |
| Play syntax fails | `deepline plays check <file>` |
| Prebuilt called as a tool | Use `deepline plays run` or `deepline.runPlay` |
| Background job used wrong org | Run from the folder with the correct `.env.deepline` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.