### Quick Start Example

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/TESTING.md

A quick start guide for setting up and running tests, including installing dependencies, running all tests, and viewing the coverage report.

```bash
# 1. 安装依赖
pip install -e ".[test]"

# 2. 运行所有测试
./run_tests.sh

# 3. 查看覆盖率报告
open htmlcov/index.html  # macOS
```

--------------------------------

### Skill Installation Examples

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/SlashCommands.md

Examples of how to install skills from different sources.

```bash
/skills install <skill>
```

```bash
/skills install <skill@marketplace>
```

```bash
/skills install <path_or_url>
```

--------------------------------

### Pip Install - Initialize and Start JiuwenSwarm

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Initializes JiuwenSwarm for the first time and then starts the service.

```bash
# Initialize JiuwenSwarm (first time setup)
jiuwenswarm-init

# Start JiuwenSwarm
jiuwenswarm-start
```

--------------------------------

### First launch

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Commands to initialize and start JiuwenSwarm for the first time.

```bash
# Initialize JiuwenSwarm (first run)
jiuwenswarm-init
# Start
jiuwenswarm-start
```

--------------------------------

### Install Frontend Dependencies

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart.md

Navigate to the frontend directory and install dependencies using npm.

```bash
cd jiuwenswarm/channels/web/frontend
npm install
```

--------------------------------

### Pip Install - First Launch

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Commands to initialize and start JiuwenSwarm after installation via pip.

```bash
# Initialize JiuwenSwarm (first run)
jiuwenswarm-init
# Start JiuwenSwarm
jiuwenswarm-start
```

--------------------------------

### Install from Source (uv) - Start TUI

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Starts the TUI application in development mode.

```bash
npm run dev
```

--------------------------------

### Pip Install - Installation Steps

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Steps to install JiuwenSwarm using pip, including virtual environment setup.

```bash
# Create a virtual environment (recommended)
python -m venv jiuwenswarm-env

# Activate the virtual environment
# Windows:
jiuwenswarm-env\Scripts\activate
# macOS/Linux:
source jiuwenswarm-env/bin/activate

# Install JiuwenSwarm
pip install jiuwenswarm
```

--------------------------------

### Install from Source (uv) - Clone and Install

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Commands to clone the repository and install dependencies using uv.

```bash
# Clone the repository
git clone https://gitcode.com/openJiuwen/jiuwenswarm.git

# Enter project directory
cd jiuwenswarm

# Create venv and install dependencies with uv
uv venv
uv pip install -e .
```

--------------------------------

### Pip Install - Start JiuwenSwarm-tui

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Starts the JiuwenSwarm TUI application.

```bash
# Start JiuwenSwarm
jiuwenswarm-tui
```

--------------------------------

### Installation and Initialization

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/README.md

Commands to install, initialize, and start JiuwenSwarm, as well as install and start the text-based user interface.

```bash
pip install jiuwenswarm

jiuwenswarm-init

jiuwenswarm-start

pip install jiuwenswarm-tui

jiuwenswarm-tui
```

--------------------------------

### Install from Source (uv) - Install TUI Dependencies

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Installs TUI frontend dependencies using npm.

```bash
cd jiuwenswarm/channels/tui/frontend
npm install
```

--------------------------------

### Pip Install - Install JiuwenSwarm and JiuwenSwarm-tui

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Installs the JiuwenSwarm and JiuwenSwarm-tui packages using pip.

```bash
pip install jiuwenswarm

pip install jiuwenswarm-tui
```

--------------------------------

### Install from Source (uv) - Build the Front End

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Commands to build the front end for a source installation using npm.

```bash
# Enter front-end directory (repo root is jiuwenswarm)
cd jiuwenswarm/channels/web

# Install front-end dependencies
npm install

# Build
npm run build

# Copy build output into the user workspace
# Windows:
xcopy /E /I dist %USERPROFILE%\.jiuwenswarm\channels\web\frontend\dist
# macOS/Linux:
cp -r dist ~/.jiuwenswarm/channels/web/frontend/dist

# Back to repo root
cd ..

```

--------------------------------

### Install uv

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/developer_guide.md

Install the uv package manager. Instructions are provided for macOS/Linux and Windows.

```bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

--------------------------------

### Install from Source (conda) - Environment Setup

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Command to check if conda is installed.

```bash
# Check that conda is installed
conda --version
# Expect: conda 23.x.x or newer
```

--------------------------------

### Install from Source (uv) - Run Static Frontend Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Builds the frontend and starts the static frontend service.

```bash
npm run build
cd ../../
uv run jiuwenswarm-init
uv run jiuwenswarm-start
```

--------------------------------

### Install from Source (uv) - Environment Setup

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Command to check if uv is installed.

```bash
# Check that uv is installed
uv --version
# Expect: uv 0.x.x
```

--------------------------------

### Install from Source (uv) - Run Dynamic Frontend Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Starts the dynamic frontend service for development and debugging.

```bash
cd ../../
uv run jiuwenswarm-init
uv run jiuwenswarm-start dev
```

--------------------------------

### Install JiuwenSwarm using pip

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart.md

Steps to create a virtual environment, activate it, and install JiuwenSwarm using pip.

```bash
# Create virtual environment
python -m venv jiuwenswarm

# Activate virtual environment
# Windows:
jiuwenswarm\Scripts\activate
# Linux/Mac:
source jiuwenswarm/bin/activate

# Install JiuwenSwarm
pip install jiuwenswarm
```

--------------------------------

### Pip Install - Restarting the Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Command to restart JiuwenSwarm after it has been initially started.

```bash
# Start again
jiuwenswarm-start
```

--------------------------------

### Verify migration

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Commands to start the service and watch logs for configuration errors after migration.

```bash
# Start the service
jiuwenswarm-start

# Watch logs for config errors
# Logs: ~/.jiuwenswarm/logs/
```

--------------------------------

### Install from Source (conda) - Run Static Frontend Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Builds the frontend and starts the static frontend service.

```bash
npm run build
cd ../../
jiuwenswarm-init
jiuwenswarm-start
```

--------------------------------

### First Launch and Restart Commands

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Commands to initialize and start JiuwenSwarm for the first time, and to restart it later.

```bash
# Initialize JiuwenSwarm (first run)
jiuwenswarm-init
# Start JiuwenSwarm
jiuwenswarm-start

# Start again
jiuwenswarm-start
```

--------------------------------

### Using the Windows build - First run: Initialize

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/PackExeGuide.md

Initializes the jiuwenswarm workspace and configuration.

```bash
jiuwenswarm.exe init
```

--------------------------------

### Install from Source (uv) - Run uv sync

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Synchronizes dependencies using uv in the project root directory.

```bash
uv sync
```

--------------------------------

### Using the Windows build - Start

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/PackExeGuide.md

Starts the jiuwenswarm desktop application, including the backend and static UI.

```bash
jiuwenswarm.exe
```

--------------------------------

### Source install upgrade

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Upgrade JiuwenSwarm installed from source.

```bash
# Enter project directory
cd jiuwenswarm

# Pull latest
git pull

# Reinstall
pip install -e .

# Rebuild the front end (when it changed)
cd jiuwenswarm/channels/web
npm install
npm run build

# Copy build output
# Windows:
xcopy /E /I dist %USERPROFILE%\.jiuwenswarm\channels\web\frontend\dist
# macOS/Linux:
cp -r dist ~/.jiuwenswarm/channels/web/frontend/dist

cd ..

```

--------------------------------

### Install from Source (conda) - Run Dynamic Frontend Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Starts the dynamic frontend service for development and debugging.

```bash
cd ../../
# Start directly (without using uv run)
jiuwenswarm-init
jiuwenswarm-start dev
```

--------------------------------

### Check Node.js Version

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart.md

Command to verify the installed Node.js version.

```bash
node --version
# Expected output: v18.x.x or higher
```

--------------------------------

### Install from Marketplace / third-party sources - Example Source URL

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Skills.md

Example of a source URL for a skill marketplace.

```text
https://github.com/xxx/skill-marketplace
```

--------------------------------

### Install Miniconda on Linux

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Commands to download and install Miniconda on Linux.

```bash
# Download and install Miniconda
curl -sSL https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -o miniconda.sh
bash miniconda.sh -b -p $HOME/miniconda3

# Add to PATH
export PATH="$HOME/miniconda3/bin:$PATH"

# Initialize conda (optional; takes effect after restarting the shell)
conda init
```

--------------------------------

### Check Conda Installation

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Command to check if Conda is installed on the system.

```bash
conda --version
```

--------------------------------

### Download JiuwenSwarm code

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart_tui.md

Clones the JiuwenSwarm repository from GitCode.

```bash
git clone https://gitcode.com/openjiuwen/jiuwenswarm.git
```

--------------------------------

### Check installed version

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Command to check the installed version of jiuwenswarm.

```bash
jiuwenswarm --version
```

--------------------------------

### Install uv on macOS/Linux

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Command to install uv (a fast Python package installer) on macOS and Linux.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

--------------------------------

### Build the front end

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/InstallGuide.md

Steps to manually build the front end for a source install, including installing dependencies, building, and copying output.

```bash
# Enter front-end directory (repo root is jiuwenswarm)
cd jiuwenswarm/channels/web

# Install front-end dependencies
npm install

# Build
npm run build

# Copy build output into the user workspace
# Windows:
xcopy /E /I dist %USERPROFILE%\.jiuwenswarm\channels\web\frontend\dist
# macOS/Linux:
cp -r dist ~/.jiuwenswarm/channels/web/frontend/dist

# Back to repo root
cd ..
```

--------------------------------

### Windows Option B: manual - Build the web UI

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/PackExeGuide.md

Installs Node.js dependencies and builds the frontend for the web UI.

```bash
cd jiuwenswarm/channels/web/frontend
npm install
npm run build
cd ../..
```

--------------------------------

### Install uv on Windows (PowerShell)

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/install.md

Command to install uv (a fast Python package installer) on Windows using PowerShell.

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

--------------------------------

### Start JiuwenSwarm Service

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/Quickstart.md

Commands to initialize and start the JiuwenSwarm service.

```bash
# Initialize (first run)
jiuwenswarm-init

# Start service
jiuwenswarm-start
```

--------------------------------

### `/auto-harness schedule start` Usage and Examples

Source: https://github.com/openjiuwen-ai/jiuwenswarm/blob/develop/docs/en/SlashCommands.md

Illustrates the usage and provides examples for the `/auto-harness schedule start` command, used to create scheduled tasks.

```bash
/auto-harness schedule start --interval <hours> [--pipeline <pipeline>] <query>
```

```bash
/auto-harness schedule start --interval 4 Optimize context compression
```

```bash
/auto-harness schedule start -i 2 -p optimize_meta_harness Submit database optimization PR
```