CLI and Configuration Reference

CLI

Command	Use
`deepline setup --json`	Install skills, connect, verify
`deepline auth status --json`	Confirm 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 switch "$ORG_NAME"`	Switch interactively
`deepline plays search "$QUERY" --json`	Find prebuilt and saved plays
`deepline plays describe "$PLAY_NAME" --json`	Inspect inputs and outputs
`deepline plays check "$PLAY_FILE"`	Validate a play without running it
`deepline plays run --file "$PLAY_FILE" --watch`	Run a local play file
`deepline plays publish "$PLAY_FILE"`	Publish a Play revision

Config

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

For automation, put DEEPLINE_HOST_URL and DEEPLINE_API_KEY in the workspace folder’s .env.deepline, then run plain 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	Rejected; use staged files or `ctx.csv` inputs

Play input should contain parameters, filters, and file references. For large tables, lead lists, research corpora, or documents, pass a file path and read it inside the play with ctx.csv(input.csv) or the relevant file reader.

Bindings

import { definePlay } from 'deepline';

export default definePlay(
  'inbound',
  async (_ctx, input: { email: string }) => {
    return { email: input.email };
  },
  {
    webhook: {},
  },
);

import { definePlay } from 'deepline';

export default definePlay(
  'daily',
  async () => {
    return { ok: true };
  },
  {
    cron: { schedule: '0 9 * * *', timezone: 'America/New_York' },
  },
);

import { definePlay } from 'deepline';

export default definePlay(
  'capped',
  async () => {
    return { ok: true };
  },
  {
    billing: { maxCreditsPerRun: 25 },
  },
);

Common fixes

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

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

CLI and Configuration Reference

CLI

Config

Input size limits

Bindings

Common fixes

​CLI

​Config

​Input size limits

​Bindings

​Common fixes

CLI

Config

Input size limits

Bindings

Common fixes