cli-serve

Files (1)

• SKILL.md

SKILL.md (first lines)

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Start, stop, and restart the AIRoute server from the CLI. Manage daemon mode, port configuration, auto-recovery, system tray integration, and the dashboard open shortcut.

## Quick install

```bash
npm install -g AIRoute   # or: npx AIRoute
AIRoute --version
```

## Subcommands

### `dashboard`

**Flags:**

- `--url`
- `--port <port>`
- `--tui`

**Example:**

```bash
AIRoute dashboard
```

### `restart`

**Flags:**

- `--port <port>`

**Example:**

```bash
AIRoute restart
```

### `serve`

**Flags:**

- `--port <port>`
- `--no-open`
- `--daemon`
- `--log`
- `--no-recovery`
- `--max-restarts <n>`
- `--tray`
- `--no-tray`
- `--tls-cert <path>`
- `--tls-key <path>`

**Example:**

```bash
AIRoute serve
```

### `stop`

**Example:**

```bash
AIRoute stop
```

<!-- skill:custom-start -->
<!-- Aggregated from: AIRoute-cli (setup + index), AIRoute-cli-admin (lifecycle/setup/backup/tunnel) -->

## Setup

The `AIRoute` binary ships with the AIRoute server. It is both the server launcher and a full management CLI with 250+ commands across 39 groups.

### Install

```bash
npm install -g AIRoute          # npm registry
# or: use the binary bundled with the desktop app
```

Requires Node.js ≥22.22.2 or ≥24.

Verify:

```bash
AIRoute --version   # prints installed version
AIRoute --help      # full command tree
```

### Connection

Every CLI command that talks to the server reads two values:

| Source   | Variable / Flag                      |
| -------- | ------------------------------------ |
| Base URL | `AIRoute_BASE_URL` or `--base-url` |
| API key  | `AIRoute_API_KEY` or `--api-key`   |

Default base URL: `http://localhost:20128`

```bash
export AIRoute_BASE_URL="http://localhost:20128"
export AIRoute_API_KEY="sk-..."          # from Dashboard → API Manager
```

For a remote server:

```bash
export AIRoute_BASE_URL="https://your-server.com"
```

### Global flags

| Flag                | Description                                              |
| ------------------- | -------------------------------------------------------- |
| `--base-url <url>`  | Override server URL for this invocation                  |

From jaccen/AIRoute, Apache-2.0.

More from jaccen/AIRoute