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

# Your first Deepline workflow

> Install Deepline, run the funded-company starter, and review the evidence from that same run.

In this lesson, you will ask your agent to find recently funded AI companies
and founder contacts. You will learn to inspect the request, save its run ID,
and distinguish a completed run from a useful result.

## Before you start

Use a coding agent that can run shell commands. You need permission to install
Deepline and authorize a workspace. The research request uses provider-backed
work and can incur usage. Check access and price before starting it.

> [!NOTE]
>
> For an agent without a shell, complete [MCP setup](https://deepline.com/docs/mcp/setup.md) first. For
> Claude Cowork, use the [Cowork setup guide](https://deepline.com/docs/claude-cowork.md).

## 1. Install and connect

Paste this instruction into your coding agent:

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
Install and set up the official Deepline CLI globally from npm (package: deepline) by following https://code.deepline.com/INSTALL.md.
```

Complete the browser authorization that setup requests. Then ask your agent
to check its effective connection:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline auth status --json
```

> [!TIP]
>
> The response has `connected: true`. Its `workspace` identifies the workspace
> you intend to use. Installation alone does not confirm authorization.

If this check fails, stop here. Follow the diagnostic or retry instructions
from setup. [Coding-agent setup](https://deepline.com/docs/sdk-v2/coding-agents.md) covers installation recovery.

## 2. Inspect the starter

Ask your agent to inspect and check this maintained Play:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline describe prebuilt/starter-funded-ai-founders --json
deepline plays check prebuilt/starter-funded-ai-founders
```

Notice `target_count` and `days`. Their defaults are three requested results
and a 30-day window. The Play finds candidates, checks funding and AI evidence,
and looks for current founders with verified work emails.

Ask your agent to explain required provider access and applicable pricing.
These inspection commands do not start the research.

> [!TIP]
>
> You can identify the requested count and time window. The Play check passes,
> and you understand the access and usage required to run it.

## 3. Start one request

Paste the primary starter prompt into your agent:

```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
/deepline-gtm Find 3 AI companies funded in the last 30 days, with founder contacts and verified work emails.
```

Ask it to use the inspected starter. Have it retain the returned run ID and
show the result from that run. The prompt is the same one offered after setup.
Do not submit it again while the first run is still processing.

The run ID identifies this execution. The Play name identifies reusable logic.
Keep both, so you can inspect existing work without starting another run.

## 4. Review the recorded result

Ask your agent to inspect the saved run. In a terminal, replace `<run-id>` with
the actual ID it returned:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline runs get <run-id> --full --json
```

If the status is still `running` or `queued`, inspect that same ID later.
A `failed` or `cancelled` run needs diagnosis. Do not treat it as an empty result.

For a completed run, ask your agent to show the result dataset and check:

1. The company matches the AI evidence.
2. The funding announcement falls within the returned window.
3. The contact is a current founder of that company.
4. The work email has the returned verification evidence.

The Play returns `count`, `requested_count`, and `shortfall_count`.
It can return fewer than three accepted rows. Preserve that shortfall instead
of adding unsupported companies or contacts.

> [!TIP]
>
> You can trace the displayed rows to one saved run. Each accepted row has the
> required evidence. Missing matches and failures remain visible.

You completed the first workflow: authorize a workspace, inspect a maintained
Play, start it once, and review its evidence.

## Check your understanding

A company has a verified founder email, but its funding announcement is 45 days old.
Does it satisfy this 30-day request?

> **Show the answer**
>
> No. A verified email does not establish recent funding. Check the funding
> evidence against the run's time window. Keep the row outside the accepted set.

Later, explain the difference between a Play name and a run ID without rereading
this page. Ask your agent to correct any gap in that explanation.

## Continue

* [Start the same workflow from TypeScript](https://deepline.com/docs/sdk-v2/quickstart.md).
* [Prepare a CSV pilot](https://deepline.com/docs/sdk-v2/batch-csv.md) when you are ready to use your own list.
* [Read the Play model](https://deepline.com/docs/plays/plays-overview.md) for the concepts behind this lesson.

> **Other starter prompts for your next session**
>
> Use these after you finish the first lesson. Each prompt starts new work and
> can incur usage. The menu is generated from the same source as setup.
>
> ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
> /deepline-gtm Find 3 AI companies funded in the last 30 days, with founder contacts and verified work emails.
> ```
>
> ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
> /deepline-gtm Find 10 CTOs at B2B SaaS companies and enrich them with email addresses.
> ```
>
> ```text theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
> /deepline-gtm Find 3 fintech companies with live SDR openings and six-month headcount growth. Show dated evidence for both.
> ```


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