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 AgentProxy 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 agentproxy   # or: npx agentproxy
agentproxy --version
```

## Subcommands

### `dashboard`

**Flags:**

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

**Example:**

```bash
agentproxy dashboard
```

### `restart`

**Flags:**

- `--port <port>`

**Example:**

```bash
agentproxy restart
```

### `serve`

**Flags:**

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

**Example:**

```bash
agentproxy serve
```

### `stop`

**Example:**

```bash
agentproxy stop
```

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

## Setup

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

### Install

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

Requires Node.js ≥22.22.2 or ≥24.

Verify:

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

### Connection

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

| Source   | Variable / Flag                      |
| -------- | ------------------------------------ |
| Base URL | `AGENTPROXY_BASE_URL` or `--base-url` |
| API key  | `AGENTPROXY_API_KEY` or `--api-key`   |

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

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

For a remote server:

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

### Global flags

| Flag                | Description                                              |
| ------------------- | -------------------------------------------------------- |

From khanhkit/AgentProxy, MIT.

More from khanhkit/AgentProxy