> ## 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.

# Coding Agents

> Run Deepline from Codex, Claude Code, Cursor, Gemini CLI, Antigravity, Hermes, and other coding agents that can use a shell.

Use this when you want an agent to run GTM work without opening the Deepline UI.

## Pick the integration path

| Agent environment             | Best path            | Notes                                                                                            |
| ----------------------------- | -------------------- | ------------------------------------------------------------------------------------------------ |
| Claude Code                   | Deepline skill + CLI | Best covered today. See [Claude Code](/sdk-v2/claude-code).                                      |
| Codex                         | Deepline skill + CLI | Install the hosted skills, then run commands from the agent terminal.                            |
| Cursor                        | Deepline skill + CLI | Install hosted skills, or point Cursor at the skill markdown files.                              |
| Gemini CLI                    | Deepline skill + CLI | Supported by the hosted skill installer.                                                         |
| Antigravity                   | Deepline skill + CLI | Supported by the hosted skill installer.                                                         |
| Hermes Agent / Hermes IDE     | CLI                  | Use the Deepline CLI from the shell. Deepline does not publish a hosted Hermes skill target yet. |
| Any other shell-capable agent | CLI                  | Install, authenticate, then give the agent the exact command to run.                             |

The rule is simple: if the agent can run shell commands, it can run Deepline.
Use skills where the agent supports them. Use the plain CLI everywhere else.

## Install Deepline once

```bash theme={null}
curl -fsSL "https://code.deepline.com/api/v2/cli/install" | bash
deepline auth register --wait auto
deepline auth status
```

If the agent runs inside a sandbox, make sure its shell can see the installed
`deepline` binary before asking it to enrich a CSV.

```bash theme={null}
deepline -h
```

## Install hosted skills where supported

```bash theme={null}
npx skills add "https://code.deepline.com/.well-known/skills/index.json" --agents codex claude-code cursor gemini-cli antigravity --global --yes --skill '*' --full-depth
```

This installs the same Deepline skill bundle for the supported agent targets.
The hosted installer does not currently include Hermes as a target. For Hermes,
use the CLI path above and link the agent to this page or to the GTM agent repo.

## Give the agent a concrete job

Good agent instructions name the file, output file, run name, row range, and
tool payload.

```bash theme={null}
deepline enrich --input leads.csv --output enriched.csv --name "email-pilot" --rows 0:4 \
  --with '{"alias":"email","tool":"name_and_domain_to_email_waterfall","payload":{"first_name":"{{first_name}}","last_name":"{{last_name}}","domain":"{{domain}}"}}'
```

If the pilot looks right, run the same command without the row range:

```bash theme={null}
deepline enrich --input leads.csv --output enriched.csv --name "email-full" \
  --with '{"alias":"email","tool":"name_and_domain_to_email_waterfall","payload":{"first_name":"{{first_name}}","last_name":"{{last_name}}","domain":"{{domain}}"}}'
```

Do not ask the agent to guess flags. The canonical command shape is:

```bash theme={null}
deepline enrich --input <file.csv> --output <file.csv> --name <run-name> --with <json> [--rows start:end]
```

## Use the GTM agent repo

For repo-backed agent workflows, start from the Deepline GTM agent project:

<Card title="deepline-gtm-agent" icon="github" href="https://github.com/getaero-io/deepline-gtm-agent">
  Reference repo for improving Deepline GTM agent workflows across coding
  agents.
</Card>

Use that repo when you want versioned prompts, reusable workflows, or a shared
agent setup that works across Codex, Claude Code, and other shell-capable
coding agents.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The agent says deepline is not found">
    Open the agent terminal and run `deepline -h`. If that fails, reinstall the
    CLI in the same sandbox or add the install prefix to the agent shell's
    `PATH`.
  </Accordion>

  <Accordion title="The hosted skill install command rejects an agent name">
    Use only the supported hosted targets: `codex`, `claude-code`, `cursor`,
    `gemini-cli`, and `antigravity`. For Hermes or another agent, use the CLI
    directly.
  </Accordion>

  <Accordion title="The agent invented a Deepline command">
    Stop and check [Content canonicals](https://github.com/getaero-io/deepline-api/blob/main/docs/CONTENT_CANONICALS.md)
    before running it. For enrichment, use the command shape on this page.
  </Accordion>
</AccordionGroup>