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 Xenia 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 xenia   # or: npx xenia
xenia --version
```

## Subcommands

### `dashboard`

**Flags:**

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

**Example:**

```bash
xenia dashboard
```

### `restart`

**Flags:**

- `--port <port>`

**Example:**

```bash
xenia 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
xenia serve
```

### `stop`

**Example:**

```bash
xenia stop
```

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

## Setup

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

### Install

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

Requires Node.js ≥22.22.2 or ≥24.

Verify:

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

### Connection

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

| Source   | Variable / Flag                      |
| -------- | ------------------------------------ |
| Base URL | `XENIA_BASE_URL` or `--base-url` |
| API key  | `XENIA_API_KEY` or `--api-key`   |

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

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

For a remote server:

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

### Global flags

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

From Ekveer-Sahoo/kepel-xenia, MIT.

More from Ekveer-Sahoo/kepel-xenia