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

# Automating Linear Tickets via DeepVista Task Delegation

> Learn how to use DeepVista Task Delegation to let a locally-registered CLI agent create Linear tickets headlessly, keeping credentials on your own machine.

# Tutorial: Automating Linear Ticket Creation via DeepVista Task Delegation

## 1. Overview

DeepVista provides a powerful **Task Delegation** feature. When a cloud agent encounters an operation that requires a local environment, a specific CLI, or particular credentials (such as an API key), it can package the work as a `task` card and dispatch it to a CLI agent registered on the user's local machine.

This tutorial demonstrates how to configure and use DeepVista Task Delegation to create Linear tickets headlessly and automatically.

***

## 2. Prerequisites

1. **Register and run a local CLI Agent**:
   On your local machine (e.g., a Linux server, Mac, etc.), run the following commands to register the device and start the polling service:
   ```bash theme={null}
   deepvista agents register
   deepvista tasks run
   ```
2. **Configure Linear API credentials**:
   In the terminal where you run `deepvista tasks run`, or in your environment variable configuration file, export your Linear access token:
   ```bash theme={null}
   export LINEAR_TOKEN="your_linear_api_token"
   ```
   *Note: The agent retrieves this variable securely within your local environment and never uploads the credential in plaintext or leaks it to logs.*

***

## 3. Step-by-Step Guide

### Step 1: Create a Task-type Context Card

In DeepVista, a Task is essentially a Context Card with `type: "task"` and `status: "pending"`. Its `description` contains a YAML metadata prefix along with the specific prompt you want to execute.

**Example card configuration:**

* **Type**: `task`
* **Status**: `pending`
* **Title**: `Create a test Linear ticket`
* **Description**:

```yaml theme={null}
---
agent_id: "your-machine-id"  # Fill in the local Machine ID you registered
agent_role: "engineering"
---
Please create a test Linear ticket.

To do this:
1. Search the local machine (environment variables, config files, or helper tools) for any Linear API credentials (such as LINEAR_API_KEY, LINEAR_TOKEN, etc.).
2. If credentials are found, use the Linear GraphQL API (via curl or python) to create a new ticket in an active workspace.
   - Title: "DeepVista Test Ticket"
   - Description: "This is a test ticket filed automatically by DeepVista agent task delegation."
3. Report the status of the ticket, the ticket key/ID, or a URL to the ticket if successfully created.
```

### Step 2: Cloud Dispatch and Local Claim

1. The cloud agent stores this task card in the database.
2. The local CLI agent (polling via `deepvista tasks run`) retrieves the pending task and invokes Claude locally to execute the prompt:
   * Claude checks the local environment variable `LINEAR_TOKEN`.
   * It sends an `issueCreate` request to Linear via the GraphQL API.

### Step 3: Capturing the Results

Once execution completes, the local agent writes the run log (`## Run`) and the final result card (`type: "note"`) back to DeepVista, and automatically updates the Task's `status` to `completed`.

**Example final result**:

* **Key**: `DV-1373`
* **Title**: DeepVista Test Ticket
* **URL**: `https://linear.app/deepvista/issue/DV-1373/deepvista-test-ticket`

***

## 4. Summary & Next Steps

By delegating Tasks to a local CLI agent, you can:

* **Stay secure**: There's no need to upload various API tokens or SSH keys to the cloud — all sensitive operations and credentials remain in your local/private environment.
* **Access local resources**: The local agent can directly reach your local file system, databases, or internal services that are only accessible within your LAN.