Skip to content
Ticos Docs

CLI

@ticos/cli is the command-line entry point for developers and AI programming agents (such as Claude Code, Cursor, Windsurf). It allows you to integrate Ticos platform capabilities directly into your local development environment or CI/CD pipelines.

Quick Start

No global installation needed, run directly with npx:

Terminal window
npx -y @ticos/cli --help

Core Commands

1. npx -y @ticos/cli mcp

Start the Ticos MCP Server.

Purpose: Allow AI programming tools (like Claude Code) to directly read your robot list, model configurations, and agent status.

  • Claude Code: Configure in ~/.claude-code/config.json.
  • Cursor/Windsurf: Add this command in the MCP section of your settings.

2. npx -y @ticos/cli deploy

Trigger the configuration deployment workflow.

Purpose: Automatically sync your local configuration files (e.g., agent prompts, tool definitions) to the Ticos cloud in CI/CD environments. This ensures your production environment configuration stays in sync with your code repository.

Environment Variables

Configure CLI behavior through environment variables to avoid explicitly passing sensitive information in commands:

VariableDescriptionDefault
TICOS_API_URLTicos backend API addresshttps://api.ticos.cn
TICOS_API_KEYYour platform API key(None)

Example: Integrating with Claude Code

Run the following command in your project to let Claude help you manage robots:

Terminal window
# Temporary run
npx -y @ticos/cli mcp


# Or configure permanently as a Claude Code tool
# Edit ~/.claude-code/config.json
{
  "mcpServers": {
    "ticos": {
      "command": "npx",
      "args": ["-y", "@ticos/cli", "mcp"],
      "env": {
        "TICOS_API_URL": "https://api.ticos.cn",
        "TICOS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}