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

# External agent

Run the Intuned agent locally in your own coding agent instead of the hosted agent. The Intuned Agent Plugin gives it the same skills and browser tooling the hosted agent uses, so you can build, edit, test, and debug automations from your own terminal and IDE.

Currently supported in Claude Code, with support for more coding agents coming soon.

## Requirements

* Node.js and npm — used to install the Intuned CLI.
* `uv` and Python on your `PATH` — the browser tooling launches via `uvx intuned-agent-mcp`.

## Install

Install the Intuned CLI and sign in:

```bash theme={null}
npm install -g @intuned/cli
intuned auth login
```

Add the marketplace and install the [Intuned Agent Plugin](https://github.com/Intuned/skills/tree/main/intuned-agent-plugin). Open Claude and run these commands:

```text theme={null}
/plugin marketplace add Intuned/skills
```

```text theme={null}
/plugin install intuned-agent-plugin@intuned-skills
```

```text theme={null}
/reload-plugins
```

Then run the following inside Claude for a guided overview of what the agent can do:

```text theme={null}
/intuned:agent
```

## Use it

Once installed, the agent loads its skills automatically from plain-English requests — you don't have to name them. Describe what you want and it picks the right workflow. You can also invoke a skill directly — skills are namespaced under `intuned`.

* Create a new automation for a site.

  ```text theme={null}
  /intuned:create-intuned-project create a scraper for Amendments on https://sandbox.intuned.dev/lists/table. Scrape ID, Name, Supplier Name, Supplier Phone Number (as a raw number), and Effective Date, filtered on Active Contract.
  ```

* Edit, fix, or extend an existing project.

  ```text theme={null}
  /intuned:edit-intuned-project for this project, filter the data based on the Deadline submission.
  ```

* Run and test automations.

  ```text theme={null}
  /intuned:test-intuned-project run an e2e test job for the "scrape-list" API in this project, pass {"max_pages":{}} as the parameter so it walks over all the pages.
  ```

* Diagnose and fix failing runs, including Playwright traces.

  ```text theme={null}
  /intuned:investigate-and-fix check why job jr_abcde had 5 failed runs and fix it.
  ```

## Works with Connected projects

The external agent works on the same project files as [local development](/main/02-features/local-development-cli). Connect a project locally with the CLI, then let the agent build and edit it in place — version control, your IDE, and your own tools all stay in the loop. When the project is ready, deploy it with the CLI.

## Related resources

<CardGroup cols={2}>
  <Card title="Intuned Agent overview" icon="robot" href="/main/02-intuned-agent/overview">
    The hosted agent and what it can do
  </Card>

  <Card title="Local development" icon="terminal" href="/main/02-features/local-development-cli">
    Build Connected projects with the local CLI
  </Card>

  <Card title="Using the agent" icon="book" href="/main/02-intuned-agent/using-the-agent">
    Workflows and prompt examples
  </Card>

  <Card title="CLI reference" icon="terminal" href="/main/05-references/cli/overview">
    Complete CLI command documentation
  </Card>
</CardGroup>