> ## 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.

# How It Works

> From a plain-English description to a running automation

Aident turns a short description into a working automation. Here's what happens from the moment you land on **Home** to the point where your playbook runs on its own.

## The Journey

<Steps>
  <Step title="Describe your job on Home">
    The **Home** screen in the left sidebar has one big input. Type what you want done in plain English — as specific or as general as you like. When you send it, Aident opens the editor for a new playbook.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/home-input.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=05ab5b01999fa0715a9be28185d8616b" alt="The Home screen with the big input where you describe a new automation" width="2516" height="1522" data-path="images/how-it-works/home-input.png" />
    </Frame>
  </Step>

  <Step title="Aiden drafts the playbook">
    **Aiden** is the chat in the side panel of the editor. It writes the first draft of your playbook — the **🎯 Goal**, the **⚙️ Integrations** it needs, and the **📄 Plan** (an **Input** card, ordered **Steps**, and an **Output** card). You can edit any section directly, or ask Aiden to rework it.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/aiden-drafts.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=d5a5e8ccfd6eddf2774a3553920b16dc" alt="Aiden drafting a playbook in the editor with Goal, Integrations, and Plan sections" width="2508" height="1526" data-path="images/how-it-works/aiden-drafts.png" />
    </Frame>
  </Step>

  <Step title="Connect the apps you need">
    Look at the integration pills under **⚙️ Integrations**. Orange means you haven't signed in yet — click the pill to connect. Red means Aiden couldn't resolve a reference; click **Ask Agent to Fix** and Aiden will repair it. White means ready to go.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/connect-apps.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=207ca9b9174c63a9feb9eb235dee593f" alt="Integration pills in the editor showing connection status for each app" width="2510" height="1534" data-path="images/how-it-works/connect-apps.png" />
    </Frame>
  </Step>

  <Step title="Set up a Trigger — or just run it now">
    Open the **Triggers** tab at the top to choose when your playbook runs. Pick a **Time Trigger** for a schedule, or an **External Event** trigger to run when something happens in Gmail, Slack, or another connected app. You can also run it on demand with **Test Run** while you're testing.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/setup-trigger.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=517ec4338c66d60d673b7fd3f2abd5a5" alt="Triggers tab showing Time Trigger and External Event options" width="2512" height="1520" data-path="images/how-it-works/setup-trigger.png" />
    </Frame>
  </Step>

  <Step title="Watch it on the Dashboard">
    The **Dashboard** in the left sidebar shows every playbook you've built, its current status, active trigger state, and last run. Open a playbook to review its full results history.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/dashboard.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=22d664f036cafc9ab018a45f78fceca2" alt="Dashboard listing your playbooks with status labels and recent runs" width="2508" height="1520" data-path="images/how-it-works/dashboard.png" />
    </Frame>
  </Step>

  <Step title="Keep refining with Aiden">
    Aiden stays available in the side chat of the editor. Ask it to add a step, tighten the Goal, switch integrations, or explain why something ran the way it did. The playbook updates in place.

    <Frame>
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/how-it-works/refine-with-aiden.png?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=811a91a5f6c8c1e8c763e60905872f65" alt="Aiden refining a playbook in the side chat of the editor" width="2514" height="1524" data-path="images/how-it-works/refine-with-aiden.png" />
    </Frame>
  </Step>
</Steps>

## The Three Tabs

Every playbook has three tabs at the top of its page. You'll switch between them as you design, schedule, and review.

<div className="not-prose my-6 grid grid-cols-1 gap-4 md:grid-cols-3">
  <a href="/documentation/playbooks" className="group block rounded-2xl border border-gray-200 bg-white p-5 transition-colors hover:border-primary dark:border-gray-800 dark:bg-zinc-900">
    <div className="mb-2 flex items-center gap-2">
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/tab-playbook.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=f3712906eb2f86ee6b6201512f5b8b83" alt="" className="h-5 w-5" width="20" height="20" data-path="images/icons/tab-playbook.svg" />

      <span className="font-semibold text-gray-900 dark:text-zinc-50">Playbook</span>
    </div>

    <p className="m-0 mb-2 text-sm text-gray-600 dark:text-zinc-400">
      The main canvas, plus Aiden in the side chat. Design and refine here.
    </p>

    <ul className="m-0 list-none space-y-1 p-0 text-sm text-gray-600 dark:text-zinc-400">
      <li>🎯 Goal</li>
      <li>⚙️ Integrations</li>
      <li>📄 Plan</li>
    </ul>
  </a>

  <a href="/documentation/triggers" className="group block rounded-2xl border border-gray-200 bg-white p-5 transition-colors hover:border-primary dark:border-gray-800 dark:bg-zinc-900">
    <div className="mb-2 flex items-center gap-2">
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/tab-trigger.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=e18372f7ff23b1e4048f62007a587f09" alt="" className="h-5 w-5" width="20" height="20" data-path="images/icons/tab-trigger.svg" />

      <span className="font-semibold text-gray-900 dark:text-zinc-50">Triggers</span>
    </div>

    <p className="m-0 text-sm text-gray-600 dark:text-zinc-400">
      Configure when the playbook runs — a Time Trigger for a schedule, or an External Event for something in a connected app. The Input and Output live here too.
    </p>
  </a>

  <div className="rounded-2xl border border-gray-200 bg-white p-5 dark:border-gray-800 dark:bg-zinc-900">
    <div className="mb-2 flex items-center gap-2">
      <img src="https://mintcdn.com/aidentai/crni0s_EV3xqJFqx/images/icons/tab-history.svg?fit=max&auto=format&n=crni0s_EV3xqJFqx&q=85&s=be630be5f0fd494747d5ce581f3a5ec5" alt="" className="h-5 w-5" width="20" height="20" data-path="images/icons/tab-history.svg" />

      <span className="font-semibold text-gray-900 dark:text-zinc-50">Results</span>
    </div>

    <p className="m-0 text-sm text-gray-600 dark:text-zinc-400">
      The full history of past runs. Click any run to see what Aiden did, the input it received, and the output it produced.
    </p>
  </div>
</div>

## Dashboard Status at a Glance

When you look at your list on the Dashboard, each playbook shows one of these labels.

<AccordionGroup>
  <Accordion title="Healthy — triggers active and running" 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 playbook has active triggers and recent runs are succeeding. Nothing to do.
  </Accordion>

  <Accordion title="Running — execution in progress" 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 happening right now. Open it to watch live.
  </Accordion>

  <Accordion title="Awaiting — needs your input or approval" 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 paused and is waiting on you. Open it to respond.
  </Accordion>

  <Accordion title="Failed — last execution errored" 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. Open it to see what went wrong, or ask Aiden to fix it.
  </Accordion>

  <Accordion title="Not Ready — no active triggers configured" 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">
    The playbook exists but has no trigger turned on. Open the Triggers tab to add one.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/get-started">
    Build your first playbook from Home
  </Card>

  <Card title="Playbooks" icon="book" href="/documentation/playbooks">
    Tour the three sections of the canvas
  </Card>

  <Card title="Triggers" icon="clock" href="/documentation/triggers">
    Choose when your playbook runs
  </Card>

  <Card title="Connect Your Tools" icon="plug" href="/documentation/integrations">
    Sign in to the apps your playbook uses
  </Card>
</CardGroup>
