---
name: devflow:start
description: Ensure the DevFlow Dashboard runtime is ready and return its URL / 确保 DevFlow Dashboard 运行时就绪并返回 URL
required_mcp_tools: []
---

# DevFlow Start

Run the user-scoped runtime command and use the returned canonical URL:

```bash
npx devflow dashboard --json
```

The command returns one JSON document containing `url`, `projectId`, and `runtime`.
Use the `url` value, which always uses `http://127.0.0.1:<port>`.

Only open a browser when the user explicitly asks for it:

```bash
npx devflow dashboard --open
```

For an existing runtime only, without starting one:

```bash
npx devflow dashboard --no-start --json
```

The Runtime is user-scoped and serves both the API and Dashboard. A default-port conflict selects a loopback ephemeral port only when `--port` was not explicitly supplied.

## 中文说明

使用 `npx devflow dashboard --json` 确保用户级运行时已就绪，并读取 JSON 中的 `url`、`projectId` 与 `runtime`。URL 固定使用 `http://127.0.0.1:<port>`。

只有在用户明确要求时才使用 `npx devflow dashboard --open` 打开浏览器。使用 `--no-start` 时只复用已就绪的运行时，不会启动新的服务。