> ## Documentation Index
> Fetch the complete documentation index at: https://notiky-mintlify-b5788c9c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# First agent task

> Solo-builder recipe — from sign-up to an agent completing work on your machine.

Goal: **assign one real task to an agent and watch it run** — the fastest proof that Notiky works for you.

<Frame>
  <img src="https://mintcdn.com/notiky-mintlify-b5788c9c/kOTGsdF2jDE8PXYg/images/recipes/recipe-first-agent-assign.png?fit=max&auto=format&n=kOTGsdF2jDE8PXYg&q=85&s=3f77027c5d459dcfe88f127bab195c22" alt="README task assigned to Builder agent with Properties panel visible" width="1176" height="884" data-path="images/recipes/recipe-first-agent-assign.png" />
</Frame>

***

## Before you start

* A machine where you can install CLIs (Mac, Linux, or WSL)
* At least one coding agent installed (Claude Code, Cursor Agent, Codex, etc.)
* \~15 minutes

***

## Steps

<Steps>
  <Step title="Create your account">
    Go to [notiky.com](https://notiky.com) and sign up. You land in your first workspace.
  </Step>

  <Step title="Install Notiky on your machine">
    ```bash theme={null}
    curl -fsSL https://get.notiky.com | bash && notiky setup
    ```

    `notiky setup` opens the browser for login, picks a workspace, and starts the **agent daemon**.
  </Step>

  <Step title="Confirm your runtime">
    In the web app: **Settings → Runtimes**. Your machine should show **online** with detected agent CLIs.

    <Frame>
      <img src="https://mintcdn.com/notiky-mintlify-b5788c9c/kOTGsdF2jDE8PXYg/images/guides/quickstart-runtimes.png?fit=max&auto=format&n=kOTGsdF2jDE8PXYg&q=85&s=a01a0c0c681bc610d4c62ae89e0b9504" alt="Settings Runtimes tab with machine online" width="1300" height="868" data-path="images/guides/quickstart-runtimes.png" />
    </Frame>

    ```bash theme={null}
    notiky daemon status
    ```
  </Step>

  <Step title="Create an agent">
    Open **Agents** in the sidebar → **New agent**. Choose your runtime and provider (e.g. Claude Code). Name it something you'll recognize on the board — e.g. "Builder".

    <Frame>
      <img src="https://mintcdn.com/notiky-mintlify-b5788c9c/kOTGsdF2jDE8PXYg/images/guides/quickstart-new-agent.png?fit=max&auto=format&n=kOTGsdF2jDE8PXYg&q=85&s=4994b2795c6a1dc7e9ca9f253dae3b90" alt="New agent dialog with runtime and provider selection" width="448" height="470" data-path="images/guides/quickstart-new-agent.png" />
    </Frame>
  </Step>

  <Step title="Create a small, concrete task">
    Open **Tasks** → **New Task**. Example title:

    > Add a README section listing environment variables

    Write acceptance criteria in the description — agents perform better with a clear done state.
  </Step>

  <Step title="Assign and watch">
    Assign the task to your agent. Move it to **Todo** or **In Progress** if needed. Open the task to see live updates as the agent runs on your machine.

    <Frame>
      <img src="https://mintcdn.com/notiky-mintlify-b5788c9c/kOTGsdF2jDE8PXYg/images/recipes/recipe-first-agent-assign.png?fit=max&auto=format&n=kOTGsdF2jDE8PXYg&q=85&s=3f77027c5d459dcfe88f127bab195c22" alt="Task assigned to Builder with Properties panel open" width="1176" height="884" data-path="images/recipes/recipe-first-agent-assign.png" />
    </Frame>
  </Step>

  <Step title="Review like a teammate">
    When the agent finishes, review the diff or output. Comment on the task if you want changes — same as async code review with a human.
  </Step>
</Steps>

***

## What good looks like

* Your runtime shows **online** in Settings
* The agent appears on **Agents** with the name you chose
* The task moves through columns and collects agent comments
* You can `notiky task runs <id>` on your machine to see CLI output

## Next

* [Decision → task → agent](/example-workflows/decision-to-task) — PM workflow
* [Troubleshooting](/troubleshooting) — if the daemon or runtime is stuck

***

## Common blockers

<AccordionGroup>
  <Accordion title="Runtime shows offline">
    Run `notiky daemon restart` and confirm **Settings → Runtimes** shows your machine online.
  </Accordion>

  <Accordion title="Agent never picked up the task">
    Confirm the task is assigned to the agent (not unassigned) and status is **Todo** or **In Progress** — not **Backlog**.
  </Accordion>

  <Accordion title="Wrong workspace">
    Check the workspace switcher in the sidebar matches where you created the agent and task.
  </Accordion>
</AccordionGroup>

***

## Related

<CardGroup cols={2}>
  <Card title="Cloud Quickstart" href="/cloud-quickstart" />

  <Card title="Agents" href="/agents" />

  <Card title="Tasks" href="/tasks" />

  <Card title="FAQ" href="/faq" />
</CardGroup>