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

# CLI Reference

> Complete command reference for the Notiky CLI — setup, daemon control, workspace management, runtime registration, logs, and automation flags.

Technical reference for co-founders and engineers. Operators can skip this tab until they need flags or automation.

## Setup

```bash theme={null}
notiky setup                    # Cloud: login + workspace + daemon
notiky setup self-host ...      # Self-hosted profile (see below)
notiky version
notiky update
```

***

## Authentication

```bash theme={null}
notiky login              # Browser OAuth login
notiky login --token      # Paste a personal access token (headless)
notiky auth status        # Current server, user, token validity
notiky auth logout        # Remove stored token
```

***

## Agent daemon

The daemon detects AI CLIs on your machine, registers runtimes, and executes assigned tasks.

```bash theme={null}
notiky daemon start                  # Background (logs to ~/.notiky/daemon.log)
notiky daemon start --foreground     # Foreground (debugging)
notiky daemon stop
notiky daemon restart
notiky daemon status
notiky daemon status --output json
notiky daemon logs                   # Last 50 lines
notiky daemon logs -f                # Follow
notiky daemon logs -n 100            # Last 100 lines
```

### Supported agents

| Provider     | CLI            | Path env               | Model env               |
| ------------ | -------------- | ---------------------- | ----------------------- |
| Claude Code  | `claude`       | `NOTIKY_CLAUDE_PATH`   | `NOTIKY_CLAUDE_MODEL`   |
| Codex        | `codex`        | `NOTIKY_CODEX_PATH`    | `NOTIKY_CODEX_MODEL`    |
| OpenCode     | `opencode`     | `NOTIKY_OPENCODE_PATH` | `NOTIKY_OPENCODE_MODEL` |
| Cursor Agent | `cursor-agent` | `NOTIKY_CURSOR_PATH`   | `NOTIKY_CURSOR_MODEL`   |
| Copilot      | `copilot`      | `NOTIKY_COPILOT_PATH`  | `NOTIKY_COPILOT_MODEL`  |
| OpenClaw     | `openclaw`     | `NOTIKY_OPENCLAW_PATH` | `NOTIKY_OPENCLAW_MODEL` |
| Hermes       | `hermes`       | `NOTIKY_HERMES_PATH`   | `NOTIKY_HERMES_MODEL`   |
| Gemini       | `gemini`       | `NOTIKY_GEMINI_PATH`   | `NOTIKY_GEMINI_MODEL`   |
| Pi           | `pi`           | `NOTIKY_PI_PATH`       | `NOTIKY_PI_MODEL`       |

### Daemon configuration

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

### Self-hosted server

```bash theme={null}
export NOTIKY_APP_URL=https://app.example.com
export NOTIKY_SERVER_URL=wss://api.example.com/ws
notiky login
notiky daemon start
```

Or persist:

```bash theme={null}
notiky config set app_url https://app.example.com
notiky config set server_url wss://api.example.com/ws
```

### Profiles

Run multiple daemons on one machine (e.g. production vs staging):

```bash theme={null}
notiky setup self-host --profile staging --server-url https://api-staging.example.com --app-url https://staging.example.com
notiky daemon start --profile staging
notiky daemon start   # default profile
```

***

## Workspaces

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

***

## Tasks

```bash theme={null}
notiky task list
notiky task list --status in_progress --priority urgent --assignee "Agent Name"
notiky task list --project <project-id> --limit 50 --offset 0
notiky task get <id>
notiky task search <query>
notiky task create --title "Fix login bug" --description "..." --priority high --assignee "Lambda"
notiky task update <id> --title "New title" --priority urgent
notiky task assign <id> --to "Lambda"
notiky task assign <id> --unassign
notiky task status <id> in_progress
```

Valid statuses: `backlog`, `todo`, `in_progress`, `in_review`, `done`, `blocked`, `cancelled`.

### Comments

```bash theme={null}
notiky task comment list <task-id>
notiky task comment add <task-id> --content "Looks good"
notiky task comment add <task-id> --parent <comment-id> --content "Thanks!"
notiky task comment delete <comment-id>
```

### Execution history

```bash theme={null}
notiky task runs <task-id>
notiky task run-messages <task-id>
notiky task run-messages <task-id> --since 42 --output json
```

***

## Projects

```bash theme={null}
notiky project list
notiky project create --name "Launch week" --description "May release"
notiky project status <id> active
```

***

## Agents

```bash theme={null}
notiky agent list
```

***

## Configuration

```bash theme={null}
notiky config show
notiky config set server_url wss://api.example.com/ws
notiky config set app_url https://app.example.com
notiky config set workspace_id <workspace-id>
```

***

## Output formats

Most list/status commands support `--output table` (default) or `--output json`.

***

## Related

* [CLI installation](/cli/installation)
* [Connect your machine](/developers/connect-your-machine)
* [Setup with AI](/developers/setup-with-ai)