TimechoCLI Deployment

1. Introduction

TimechoCLI is a unified command-line tool from Timecho designed for end users, automation scripts, and AI Agents. Paired with official Skills, it uses natural language to connect the product workflows of TimechoDB, Apache IoTDB, and TimechoAI, lowering the barrier to entry and bridging the last mile of DB × AI.

For TimechoDB, the CLI provides end-to-end capabilities covering deployment and activation, SQL execution, data import/export, and operations diagnostics. For TimechoAI, it supports data loading, model inference scheduling, and result visualization, while the bundled Skills help prevent hallucinated commands and misused parameters, improving operational accuracy.

TimechoCLI is compatible with mainstream Agent environments such as Codex, Claude Code, and Hermes, providing a low-barrier Agent entry point for the entire Timecho product line.

2. Installation

2.1 Requirements

• Target machine: Linux / macOS / Windows (amd64, arm64)

• Zero-dependency static binary (CGO_ENABLED=0); no need to pre-install Node/Python/JRE

• To connect to TimechoDB, TimechoAI, or TsFile, make sure the network is reachable

2.2 One-Line Installation (via Agent)

Send the following message to your Agent, and the Agent will complete the installation automatically:

Install Timecho CLI for me: https://timecho.com/timecho-cli/installation-guide.md

2.3 One-Click Installation

One-click installation via npm (cross-platform: Windows, Mac, and Linux):

npm install -g @timecho/timecho-cli

2.4 Verification

timecho-cli version
timecho-cli --help