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

# toolkit autostart — Configure System Startup Behavior

> toolkit autostart enable, disable, and status commands — register the Toolkit daemon to run at login on Windows, Linux, and macOS with three startup modes.

The `toolkit autostart` command group registers, removes, and inspects the OS-level startup entry for the Toolkit daemon. When autostart is enabled, the daemon launches automatically at login — no terminal session required — so your local proxy and web dashboard are ready the moment you start your machine. You can choose from three startup modes to control how the daemon behaves and whether it gives you visual feedback when it comes up.

***

## toolkit autostart status

Displays whether autostart is currently enabled, the active startup mode, the detected platform, and the target dashboard URL.

**Syntax**

```bash theme={null}
toolkit autostart status [options]
```

**Options**

| Option   | Type    | Default | Description                                     |
| :------- | :------ | :------ | :---------------------------------------------- |
| `--json` | boolean | `false` | Emit the full status object as structured JSON. |

**Examples**

```bash theme={null}
# Check autostart status in a human-readable format
toolkit autostart status

# Output structured JSON
toolkit autostart status --json
```

***

## toolkit autostart enable

Registers the Toolkit daemon with your operating system's startup mechanism so it launches automatically at every login.

**Syntax**

```bash theme={null}
toolkit autostart enable [options]
```

**Options**

| Option              | Type    | Default         | Description                                                              |
| :------------------ | :------ | :-------------- | :----------------------------------------------------------------------- |
| `-m, --mode <mode>` | string  | `daemon_notify` | Startup behavior: `daemon_notify`, `daemon_silent`, or `browser_launch`. |
| `--json`            | boolean | `false`         | Emit the result of the operation as structured JSON.                     |

**Examples**

```bash theme={null}
# Enable autostart with the default mode (daemon + desktop notification)
toolkit autostart enable

# Enable in silent mode — no desktop notifications on startup
toolkit autostart enable --mode daemon_silent

# Enable in browser-launch mode — opens the dashboard automatically at login
toolkit autostart enable --mode browser_launch

# Enable and receive a JSON confirmation
toolkit autostart enable --mode daemon_notify --json
```

***

## toolkit autostart disable

Removes the Toolkit startup entry from your operating system, stopping the daemon from launching at login.

**Syntax**

```bash theme={null}
toolkit autostart disable [options]
```

**Options**

| Option   | Type    | Default | Description                                          |
| :------- | :------ | :------ | :--------------------------------------------------- |
| `--json` | boolean | `false` | Emit the result of the operation as structured JSON. |

**Examples**

```bash theme={null}
# Disable autostart
toolkit autostart disable

# Disable and receive a JSON confirmation
toolkit autostart disable --json
```

***

## Startup mode descriptions

The `--mode` flag controls what happens immediately after the daemon finishes starting up at login.

| Mode             | Behavior                                                                                          |
| :--------------- | :------------------------------------------------------------------------------------------------ |
| `daemon_notify`  | Starts the daemon and shows a native desktop notification when the proxy and dashboard are ready. |
| `daemon_silent`  | Starts the daemon silently with no UI feedback — the proxy is available but nothing is displayed. |
| `browser_launch` | Starts the daemon and automatically opens the web dashboard in your default browser.              |

***

## Platform support

Toolkit writes the startup entry to the appropriate location for each operating system.

| Platform    | Mechanism                       | Entry location                                                           |
| :---------- | :------------------------------ | :----------------------------------------------------------------------- |
| **macOS**   | Launch Agent (launchd)          | `~/Library/LaunchAgents/com.allinone.toolkit.plist`                      |
| **Linux**   | XDG Autostart (`.desktop` file) | `~/.config/autostart/all-in-one-toolkit.desktop`                         |
| **Windows** | Registry Run key                | `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` → `AllInOneToolkit` |

<Warning>
  On some systems, writing the startup entry may require elevated permissions. If registration fails, re-run the command with administrator or root privileges.
</Warning>