dev-server

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Dev Server Skill

Dev Server 技能

Centralized management of Next.js dev servers across multiple git worktrees. The daemon handles port allocation, environment variable injection, and log aggregation so that any agent can access dev server logs regardless of who started the server.

跨多个Git工作树集中管理Next.js开发服务器。守护进程负责端口分配、环境变量注入和日志聚合，让任意Agent都能访问开发服务器的日志，无论该服务器由谁启动。

Quick Start

快速开始

bash

undefined

bash

undefined

Check what's running

查看当前运行状态

node .claude/skills/dev-server/cli.mjs status

Start a dev server for current worktree

为当前工作树启动开发服务器

node .claude/skills/dev-server/cli.mjs start

Start for a specific worktree

为指定工作树启动开发服务器

node .claude/skills/dev-server/cli.mjs start /path/to/worktree

View logs

查看日志

node .claude/skills/dev-server/cli.mjs logs <session-id>

Stop a session

停止会话

node .claude/skills/dev-server/cli.mjs stop <session-id>


**Checking if server is ready:** After starting, poll the session status to check `ready: true`. The daemon marks sessions ready either via configured health check endpoint or by detecting "Ready" patterns in logs.

node .claude/skills/dev-server/cli.mjs stop <session-id>


**检查服务器是否就绪：**启动后，轮询会话状态以查看`ready: true`。守护进程会通过配置的健康检查端点或检测日志中的“Ready”标识来标记会话为就绪状态。

CLI Commands

CLI 命令

Command	Description
`status`	Check daemon status and list all sessions
`list`	List all dev sessions
`start [worktree]`	Start dev server (default: current directory)
`logs [session-id]`	Get logs for a session
`tail [session-id]`	Tail logs continuously
`stop <session-id>`	Stop a session
`restart <session-id>`	Restart a session
`shutdown`	Shutdown the daemon

命令	说明
`status`	查看守护进程状态并列出所有会话
`list`	列出所有开发会话
`start [worktree]`	启动开发服务器（默认：当前目录）
`logs [session-id]`	获取指定会话的日志
`tail [session-id]`	持续跟踪日志
`stop <session-id>`	停止指定会话
`restart <session-id>`	重启指定会话
`shutdown`	关闭守护进程

Session Object

会话对象

Each session includes:

json

{
  "id": "a1b2c3d4",
  "worktree": "/path/to/worktree",
  "branch": "feature/my-feature",
  "port": 3000,
  "status": "running",
  "ready": true,
  "readyAt": "2024-01-15T10:30:02.000Z",
  "startedAt": "2024-01-15T10:30:00.000Z",
  "url": "http://localhost:3000"
}

Status values:

starting

running

stopped

crashed

error

每个会话包含以下信息：

json

{
  "id": "a1b2c3d4",
  "worktree": "/path/to/worktree",
  "branch": "feature/my-feature",
  "port": 3000,
  "status": "running",
  "ready": true,
  "readyAt": "2024-01-15T10:30:02.000Z",
  "startedAt": "2024-01-15T10:30:00.000Z",
  "url": "http://localhost:3000"
}

状态值：

starting

（启动中）、

running

（运行中）、

stopped

（已停止）、

crashed

（已崩溃）、

error

（错误）

Log Entries

日志条目

json

{
  "index": 42,
  "timestamp": "2024-01-15T10:30:05.123Z",
  "level": "stdout",
  "message": "Ready on http://localhost:3000"
}

Log levels:

stdout

stderr

error

warn

info

json

{
  "index": 42,
  "timestamp": "2024-01-15T10:30:05.123Z",
  "level": "stdout",
  "message": "Ready on http://localhost:3000"
}

日志级别：

stdout

（标准输出）、

stderr

（标准错误）、

error

（错误）、

warn

（警告）、

info

（信息）

Notes

注意事项

The daemon starts automatically when you run CLI commands
Sessions persist until explicitly stopped or the daemon shuts down
Logs are kept in memory (up to 2000 lines per session)

运行CLI命令时，守护进程会自动启动
会话会持续存在，直到被显式停止或守护进程关闭
日志存储在内存中（每个会话最多2000行）