# Agent quickstart

> Connect ChatGPT or Claude to Eddy, paste one prompt, and let it run an edit with you.

Source: https://eddystudio.ai/docs/agent-quickstart/ · Written from the app's source code, last checked 3 November 2026; generated tables are rebuilt from the source on every build; not every behaviour hand-tested in the beta build

Three steps: connect your agent to Eddy, paste the prompt below, then answer its questions. Eddy Studio has to be open on your Mac the whole time.

## 1. Connect your agent

**ChatGPT or claude.ai in the browser** (remote access):

1. In Eddy, open the **Doctor** sheet and turn on **Use Eddy from ChatGPT and claude.ai**.
2. In ChatGPT, add Eddy as a developer mode connector. In claude.ai, add it as a custom connector. Use the address the Doctor card shows.
3. A sign-in page asks for the 8-character code shown on your Mac. It works once and expires after 10 minutes.

A remote agent gets the 15 creator tools only. [More about remote access](https://eddystudio.ai/docs/for-agents/#connect-chatgpt-or-claude-ai-remote-access).

> **Unknown:** Which ChatGPT and Claude plans allow adding your own connectors. Check your plan's settings.

**Claude Desktop, Claude Code or Codex on the same Mac:** open the **Doctor** sheet and click your app in the **Connect your agent** card. [More about local agents](https://eddystudio.ai/docs/for-agents/#connect-an-agent-on-the-same-mac).

## 2. Paste this prompt

It works the same in ChatGPT and in Claude. Fill in the two bits in square brackets, or delete them.

```text
You're driving Eddy Studio, the video editor on my Mac, through its eddy_ tools.

1. Call eddy_get_started first and fix whatever it says is missing. If my AI editor isn't signed in, call eddy_sign_in and tell me to approve the page that opens on my Mac.
2. Find my footage with eddy_find_footage, or use this path: [path to my recording]. Tell me which file you picked and wait for my OK.
3. Read everything I said with eddy_read_transcript (a long recording comes in parts). Ask me up to three questions about the cut, quoting my words with their times, and wait for my answers.
4. Start the edit with eddy_edit_this: a long video plus [1 to 3] Shorts, with my answers, in my own words, as its notes.
5. Check it with eddy_get_edit every few minutes, not more often, and tell me when the stage changes. Don't promise a finish time: an edit takes hours, and no edit time has been measured yet.
6. When it's ready, look at it with eddy_watch before you describe it. Ask what I'd change, and pass my words to eddy_refine exactly as I said them.
7. Never tell me a video is published or uploaded. Uploading is my own click in Eddy.
```

In an app with a prompt menu, such as Claude Desktop, you can pick **Edit this video with Eddy** instead. It asks for the path to your footage and how many Shorts you want.

## 3. While it runs

- Leave Eddy Studio open and your Mac on. Eddy keeps the Mac awake during the edit.
- If the agent says the edit stopped, ask it to call `eddy_resume_edit`. The edit carries on from the stage it stopped in.
- When it's done, your files are in your folder (see [What you get](https://eddystudio.ai/docs/how-it-works/#what-you-get)). Nothing is uploaded.

## How we test these docs on an agent

A fresh AI agent that had never seen Eddy was given only this website and the 10 questions below. Its answers were marked against an answer key written from the app's source code before the run.

**Score: 10 out of 10** (3 November 2026, on the docs as they are now).

1. What Mac, macOS version and memory does Eddy need?
2. What does Eddy download on first use, and how big is each download? Does either one have its own macOS requirement?
3. Which AI account does Eddy need, and where does a creator apply for the beta?
4. How long does an edit take, and has that time been measured?
5. Which MCP tool should an agent call first, and which tool starts an edit?
6. Can an agent publish or upload the finished video to YouTube?
7. How many Shorts can one edit make, and what shape are they?
8. Which one-click AI Tool removes repeated takes, and can its changes be undone?
9. What is the default caption style, how many words does it show at once, and is Eddy's built-in house style final?
10. How does ChatGPT or claude.ai in the browser connect to Eddy, and which tools does a remote agent get?

If your agent gets one of these wrong after reading the docs, tell us at [support@eddystudio.ai](mailto:support@eddystudio.ai): the page needs fixing, not your agent.