Skip to main content

​
Overview

By the end, DeepVista will file Linear tickets automatically from a cloud-triggered prompt, while your Linear API token never leaves your own machine. 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 connected on the user’s local machine. This tutorial demonstrates how to configure and use DeepVista Task Delegation to create Linear tickets headlessly and automatically.

​
Prerequisites

Deep Workflows need a connected machine before you can run them. Complete these three setup steps first, in order:

Mac Setup

Install the developer tools and Claude Code CLI this setup depends on.

Set Up Your Claude Code Connector

Authenticate Claude Code with your Claude account.

Connect Your Own Machine

Install the DeepVista CLI and connect your machine as a local runner.
With your machine connected and deepvista tasks run polling, configure Linear API credentials:
Note: The agent retrieves this variable securely within your local environment and never uploads the credential in plaintext or leaks it to logs.

​
Step-by-step guide

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:
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.
3

Capture 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