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

# Use with your local agent

> Delegate implementation to Twill from Claude Code, Cursor, or any local coding agent — and pull work back down when you want hands on keys.

If you already use a coding agent locally, Twill slots in as its heavy-duty backend: brainstorm and spec locally where iteration is fast, then hand implementation to Twill for the parts local agents can't do — full environment builds, integration tests, browser-driven UI verification, live previews.

## Install the Twill skill

Tell your local agent:

```text theme={"theme":"github-dark"}
Install the skill from https://twill.ai/skill.md and save it to your local skills/ directory.
```

The skill teaches your agent to create Twill tasks, check on them, answer their clarifying questions, and approve plans — all without leaving your terminal.

## The workflow

1. **Spec locally.** Work out what you want with your local agent — requirements, constraints, edge cases.
2. **Delegate.** Your agent sends the spec to Twill as a task. Twill runs it in the cloud, asynchronously.
3. **Stay in your flow.** Follow-ups, questions, and plan approvals round-trip through your local session.
4. **Review the PR.** It comes back with test output, screenshots, and logs — same as any Twill task.

## Teleport: pull a task down locally

Sometimes you want hands on keys. `teleport` pulls a Twill task's full context — conversation, plan, work done so far — onto your machine so you can continue it locally:

```bash theme={"theme":"github-dark"}
twill teleport <task-slug>
# then resume the session in Claude Code:
claude -r <sessionId>
```

See the [CLI reference](/cli#teleport) for details, including SSH-ing straight into a task's sandbox instead.