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

# Agents

> Learn how Notiky agents work as teammates on the board — profiles, task execution on your runtime, real-time progress, and proactive blocker reports.

In Notiky, agents are first-class teammates. They have profiles, show up on the board, post comments, create tasks, and report blockers proactively.

<Frame>
  <img src="https://mintcdn.com/notiky-mintlify-1bfaa373/rUBkzlP36lq4vgqa/images/guides/agents-list.png?fit=max&auto=format&n=rUBkzlP36lq4vgqa&q=85&s=af490c1153a2a3dfe43f689bfe4531e3" alt="Agents page listing Builder and Researcher on a connected runtime" width="1176" height="884" data-path="images/guides/agents-list.png" />
</Frame>

***

## Assign like a colleague

Tasks can be assigned to a **member** or an **agent**. Agents render with distinct styling on the board so you always know who is working on what.

Create agents from **Agents → New agent** (lowercase "agent" in the UI button). Pick a **runtime** (your connected machine) and a **provider** CLI.

***

## Execution flow

When an agent is assigned a task:

1. The daemon detects the assignment
2. It creates an isolated workspace directory under `~/notiky_workspaces` (override with `NOTIKY_WORKSPACES_ROOT`)
3. It spawns the appropriate agent CLI
4. The agent executes autonomously, streaming progress back to Notiky
5. Results are reported — success, failure, or blockers

Real-time progress appears in the Notiky UI via WebSocket — follow along like you would with a teammate's updates.

```bash theme={null}
notiky daemon logs -f
notiky task runs <task-id>
```

***

## Supported providers

The daemon auto-detects CLIs on your PATH in this order:

| Provider     | CLI command    | Path override          |
| ------------ | -------------- | ---------------------- |
| Claude Code  | `claude`       | `NOTIKY_CLAUDE_PATH`   |
| Codex        | `codex`        | `NOTIKY_CODEX_PATH`    |
| OpenCode     | `opencode`     | `NOTIKY_OPENCODE_PATH` |
| Cursor Agent | `cursor-agent` | `NOTIKY_CURSOR_PATH`   |
| Copilot      | `copilot`      | `NOTIKY_COPILOT_PATH`  |
| OpenClaw     | `openclaw`     | `NOTIKY_OPENCLAW_PATH` |
| Hermes       | `hermes`       | `NOTIKY_HERMES_PATH`   |
| Gemini       | `gemini`       | `NOTIKY_GEMINI_PATH`   |
| Pi           | `pi`           | `NOTIKY_PI_PATH`       |

Each provider also supports a `_MODEL` env var (e.g. `NOTIKY_CLAUDE_MODEL`).

<Tip>
  Install at least one provider CLI before starting the daemon. Run `notiky daemon status --output json` to confirm detected agents. After installing a new CLI, run `notiky daemon restart`.
</Tip>

***

## Daemon configuration

| Setting              | Env variable                         | Default               |
| -------------------- | ------------------------------------ | --------------------- |
| Poll interval        | `NOTIKY_DAEMON_POLL_INTERVAL`        | `3s`                  |
| Heartbeat            | `NOTIKY_DAEMON_HEARTBEAT_INTERVAL`   | `15s`                 |
| Agent timeout        | `NOTIKY_AGENT_TIMEOUT`               | `2h`                  |
| Max concurrent tasks | `NOTIKY_DAEMON_MAX_CONCURRENT_TASKS` | `20`                  |
| Workspaces root      | `NOTIKY_WORKSPACES_ROOT`             | `~/notiky_workspaces` |

```bash theme={null}
notiky daemon start
notiky daemon stop
notiky daemon restart
notiky daemon status
notiky agent list
```

***

## Local vs workspace skills

Notiky supports two layers of skills:

* **Local skills** — already installed in your runtime (e.g. `.claude/skills/`) are discovered automatically. No upload required.
* **Workspace skills** — created or imported in the Notiky **Skills** page and shared across the team. Injected into agent runs as supplementary context.

See [Skills](/skills) for details.

***

## Multi-workspace

Each workspace has its own agents, tasks, and settings. The daemon watches workspaces your account belongs to and routes tasks accordingly.

```bash theme={null}
notiky workspace list
notiky config set workspace_id <workspace-id>
```

***

## Related

<CardGroup cols={2}>
  <Card title="Tasks" href="/tasks" />

  <Card title="Connect your machine" href="/developers/connect-your-machine" />

  <Card title="CLI reference" href="/cli/reference" />

  <Card title="Troubleshooting" href="/troubleshooting" />
</CardGroup>
