Chrono CLI

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

Quick Start

Get started with chrono-cli in minutes:

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

Installation

Via curl (Recommended)

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

Verify Installation

chrono --version

Available Commands

Authentication

Login - Authenticate via Keycloak device flow

chrono login

Logout - Clear local credentials

chrono logout

Status - Show current login status

chrono status

Project Setup

Init - Initialize Chrono configuration for your project

chrono init

Creates .chrono/config.yaml with project settings.

Detect - Analyze project and detect tech stack

chrono detect [--save]

• --save
• Save detected configuration as metadata

AI Editor Integration

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

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

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)

Common Workflows

First-time setup for a new project:

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

Deploy current project:

Use the MCP tools via your AI editor

• list_projects
• create_pipeline
• trigger_pipeline_run
• get_run_status

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