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

# Get Started

> Your first automation, written and working.

It takes about five minutes to get you setup your own AI automation end-to-end without a single line of code just by plain language. Open up [app.aident.ai](https://app.aident.ai) in another tab and follow along.

## Create your first automation

Aident turns a plain-English description into a **Playbook** — a reusable automation you can run on demand, on a schedule, or when something happens in another app. Here's the path from idea to running playbook.

<Steps>
  <Step title="Describe what you want">
    On **Home** in the left sidebar, you'll see a big input with the placeholder *"Describe your job and automation here to get started..."*. Type a short paragraph describing the job — what should happen, which apps are involved, and how you'll know it worked. Press **Enter** to send. You can attach up to 10 images if a screenshot helps explain.

    <Tip>
      **Good starting descriptions:**

      * "Every morning at 8am, summarize my client emails from Gmail and post the digest in #updates on Slack."
      * "When a new row is added to my Google Sheet, create a task in Linear and notify the owner in Teams."
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/create-automation-light.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=9340d1ce0542a8125a7c9d8926531eb6" alt="The Home input where you describe your automation" className="block dark:hidden" width="2368" height="600" data-path="images/get-started/create-automation-light.png" />

      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/create-automation-dark.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=b34110d510e63055054c286a7ad1186e" alt="The Home input where you describe your automation" className="hidden dark:block" width="2368" height="600" data-path="images/get-started/create-automation-dark.png" />
    </Frame>
  </Step>

  <Step title="Meet your Playbook">
    Aiden — the AI assistant — drafts a Playbook and opens it in the editor. You'll see three stacked sections on the canvas:

    * **🎯 Goal** — what the playbook should accomplish and what "done" looks like. Edit it like a rich-text field.
    * **⚙️ Integrations** — pills for the apps your playbook will use, inferred from your Goal and Plan.
    * **📄 Plan** — an **Input** card, the ordered **Steps**, and an **Output** card.

    Aiden sits in a side chat that's always available — ask it to reword your Goal, add a step, or rework any section. The initial draft can take a moment; hang tight while it finishes.
  </Step>

  <Step title="Connect the apps">
    Look at the integration pills in **⚙️ Integrations**:

    * **White pill** — connected and ready to use.
    * **Orange pill** — you haven't signed in yet. Click the pill to connect.
    * **Red pill** — something's unresolved. Click **Ask Agent to Fix** and Aiden will repair the reference.

    You can also manage app connections from **Capabilities** in the sidebar. **Connections** is for MCP access, reusable skills, channels, and sandbox-related setup.

    <Frame>
      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/connect-tools-light.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=22c9926865bea814cfbec1b8760e27f0" alt="Connecting integrations from the playbook editor" className="block dark:hidden" width="736" height="194" data-path="images/get-started/connect-tools-light.png" />

      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/connect-tools-dark.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=989870903b3960d62c0e120ed366931a" alt="Connecting integrations from the playbook editor" className="hidden dark:block" width="736" height="194" data-path="images/get-started/connect-tools-dark.png" />
    </Frame>

    <Info>
      Don't see the app you need? [Request an integration](https://discord.gg/D9SuaZAQaJ) and we'll look into adding it.
    </Info>
  </Step>

  <Step title="Run it">
    Once all pills are white, it's time to try it out.

    * Click **Test Run** to trigger an on-demand run right now. Use this to confirm the Plan does what you expect.
    * Open the **Triggers** tab to configure automatic runs: add a **Time Trigger** for schedules or an **External Event** trigger for events in connected apps, such as a new email or a new row in a sheet. You can also set the **Input** it receives and the **Output** it returns.

    <Frame>
      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/test-automation-light.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=67675d07cc98971ae565abb55c1d43f7" alt="Test Run button in the playbook editor" className="block dark:hidden" width="581" height="274" data-path="images/get-started/test-automation-light.png" />

      <img src="https://mintcdn.com/aidentai/5HAdYQskiMRnjEWG/images/get-started/test-automation-dark.png?fit=max&auto=format&n=5HAdYQskiMRnjEWG&q=85&s=30b4e895252d12530693f072d5cf1cd2" alt="Test Run button in the playbook editor" className="hidden dark:block" width="581" height="274" data-path="images/get-started/test-automation-dark.png" />
    </Frame>
  </Step>

  <Step title="Watch it on the Dashboard">
    Open **Dashboard** in the sidebar to see every playbook you own. A status label next to each one tells you what's going on:

    <AccordionGroup>
      <Accordion title="Running" icon="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/status-running.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=f9cab42bce34182917c7388345d539db" width="20" height="20" data-path="images/icons/status-running.svg">
        A run is in progress right now.
      </Accordion>

      <Accordion title="Healthy" icon="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/status-healthy.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=47446e10038380b1ca7b1c57aca439f5" width="20" height="20" data-path="images/icons/status-healthy.svg">
        The steady state — the playbook is set up and recent runs succeeded.
      </Accordion>

      <Accordion title="Awaiting" icon="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/status-awaiting.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=ce9fa24a37e36089866891bb4c538b3e" width="20" height="20" data-path="images/icons/status-awaiting.svg">
        The playbook is paused waiting for you — usually an approval or a piece of input. Click in to respond.
      </Accordion>

      <Accordion title="Failed" icon="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/status-failed.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=3b71ab053eb3f71ec9d08c1981fa4f53" width="20" height="20" data-path="images/icons/status-failed.svg">
        The last run didn't finish successfully. Click in to see what happened.
      </Accordion>

      <Accordion title="Not Ready" icon="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/status-not-ready.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=f6f40050db0c9b6078f10724c82ba2f9" width="20" height="20" data-path="images/icons/status-not-ready.svg">
        No triggers are active yet. Open the **Triggers** tab to turn one on.
      </Accordion>
    </AccordionGroup>

    Click any playbook to see its run history, open awaiting approvals, or jump back into the editor.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/get-started/dashboard.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=5b2c605a995cdfe9f7491222e53d918f" alt="Dashboard showing playbook statuses" width="2394" height="1140" data-path="images/get-started/dashboard.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Need another automation? Click **New Playbook** in the sidebar to start fresh, or head back to **Home** and describe something new.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="A playbook shows Failed — what now?">
    Open the playbook to see which step failed and why. Common fixes: reconnect an orange integration pill, click **Ask Agent to Fix** on a red pill, or ask Aiden in the side chat to repair the step. Then try another **Test Run**.
  </Accordion>

  <Accordion title="My scheduled run didn't trigger">
    Open the playbook and go to the **Triggers** tab. Confirm a **Time Trigger** or **External Event** is configured and active. If Dashboard shows **Not Ready**, there are no active triggers yet. You can also ask Aiden to set triggers up for you from the side chat.
  </Accordion>

  <Accordion title="The playbook needs my approval to keep going">
    That's the **Awaiting** status on the Dashboard. Click into the playbook to review the run, approve or edit the pending item, and let it continue.
  </Accordion>

  <Accordion title="The results aren't quite what I wanted">
    Edit **🎯 Goal** to sharpen what "done" means, tweak the **Steps** in **📄 Plan**, or ask Aiden in the side chat to adjust a specific part. Run **Test Run** again to check. You're in control — the playbook is yours to shape.
  </Accordion>

  <Accordion title="I hit something that looks like a bug">
    We're in active beta and want to hear about it. [File a bug in Discord](https://discord.gg/kb6wpECN9W) and we'll take a look.
  </Accordion>
</AccordionGroup>
