chrono-setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Chrono CLI

Chrono CLI allows you to interact with the Developer Platform without accessing the dashboard.

Chrono CLI 让您无需访问控制台即可与开发者平台进行交互。

Quick Start

快速开始

Get started with chrono-cli in minutes:

bash

undefined

几分钟内快速上手chrono-cli：

bash

undefined

1. Check if chrono is installed

chrono --version

2. If not installed, install via curl

curl -sSL https://raw.githubusercontent.com/ChronoAIProject/chrono-cli/main/install.sh | sh

3. Navigate to your project and initialize

cd /path/to/project chrono init

4. Login to authenticate

chrono login

5. Setup MCP integration with your AI editor

chrono mcp-setup

undefined

chrono mcp-setup

undefined

Installation

安装

Via curl (Recommended)

通过curl安装（推荐）

bash

curl -sSL https://raw.githubusercontent.com/ChronoAIProject/chrono-cli/main/install.sh | sh

bash

curl -sSL https://raw.githubusercontent.com/ChronoAIProject/chrono-cli/main/install.sh | sh

Verify Installation

验证安装

bash

chrono --version

bash

chrono --version

Available Commands

可用命令

Authentication

身份验证

Login - Authenticate via Keycloak device flow

bash

chrono login

Logout - Clear local credentials

bash

chrono logout

Status - Show current login status

bash

chrono status

Login - 通过Keycloak设备流进行身份验证

bash

chrono login

Logout - 清除本地凭证

bash

chrono logout

Status - 显示当前登录状态

bash

chrono status

Project Setup

项目设置

Init - Initialize Chrono configuration for your project

bash

chrono init

Creates

.chrono/config.yaml

with project settings.

Detect - Analyze project and detect tech stack

bash

chrono detect [--save]

```
--save
```
- Save detected configuration as metadata

Init - 为您的项目初始化Chrono配置

bash

chrono init

创建包含项目设置的

.chrono/config.yaml

文件。

Detect - 分析项目并检测技术栈

bash

chrono detect [--save]

```
--save
```
- 将检测到的配置保存为元数据

AI Editor Integration

AI编辑器集成

MCP Setup - Configure AI editor to use Chrono as an MCP server

bash

chrono mcp-setup [editor]

Supported editors:

```
cursor
```
(default) - Cursor IDE
```
claude-code
```
- Claude Code
```
codex
```
- Codex
```
gemini
```
- Gemini CLI

This command:

Creates API token automatically
Configures editor's MCP settings
Verifies MCP connection

MCP Setup - 配置AI编辑器以将Chrono用作MCP服务器

bash

chrono mcp-setup [editor]

支持的编辑器：

```
cursor
```
（默认）- Cursor IDE
```
claude-code
```
- Claude Code
```
codex
```
- Codex
```
gemini
```
- Gemini CLI

该命令会：

自动创建API令牌
配置编辑器的MCP设置
验证MCP连接

Configuration Files

配置文件

~/.chrono/config.yaml     # Main CLI config
.chrono/config.yaml       # Project-specific config
.chrono/metadata.yaml      # Auto-generated project metadata
.cursor/mcp.json          # Cursor MCP config (auto-generated)
.mcp.json                 # Claude Code MCP config (auto-generated)

~/.chrono/config.yaml     # 主CLI配置文件
.chrono/config.yaml       # 项目专属配置文件
.chrono/metadata.yaml      # 自动生成的项目元数据
.cursor/mcp.json          # Cursor MCP配置文件（自动生成）
.mcp.json                 # Claude Code MCP配置文件（自动生成）

Common Workflows

常见工作流程

First-time setup for a new project:

新项目首次设置：

bash

1. cd /path/to/project
2. chrono init
3. chrono login
4. chrono detect --save
5. chrono mcp-setup

bash

1. cd /path/to/project
2. chrono init
3. chrono login
4. chrono detect --save
5. chrono mcp-setup

Deploy current project:

部署当前项目：

bash

undefined

bash

undefined

Use the MCP tools via your AI editor

通过您的AI编辑器使用MCP工具

list_projects
create_pipeline
trigger_pipeline_run
get_run_status

undefined

list_projects
create_pipeline
trigger_pipeline_run
get_run_status

undefined

Global Flags

全局标志

```
--api-url string
```
- API server URL (overrides config)
```
--config string
```
- Config file path
```
--debug
```
- Enable debug output
```
-h, --help
```
- Help for any command
```
-v, --version
```
- Show version

```
--api-url string
```
- API服务器URL（覆盖配置）
```
--config string
```
- 配置文件路径
```
--debug
```
- 启用调试输出
```
-h, --help
```
- 获取任意命令的帮助信息
```
-v, --version
```
- 显示版本信息