CloudCC Command Line Interface

2.5.2 · active · verified Wed Apr 22

cloudcc-cli is a command-line interface tool designed to streamline interaction with the CloudCC platform, enabling developers to manage project resources, objects, and perform various maintenance tasks. Currently at version 2.5.2, the CLI receives active updates, as evidenced by multiple releases on the same day in the recent changelog. A key differentiator is its dual command naming convention, offering both `cloudcc` (recommended to avoid conflicts on Unix-like systems) and `cc` for backward compatibility, both pointing to the same binary. It also features integrated release note display during updates and an optional Cursor Agent Skill to assist AI development workflows by providing contextual documentation access. This CLI focuses on simplifying CloudCC-related development and operational tasks through a structured command system.

Common errors

```
cloudcc: command not found
```
cause The `cloudcc-cli` package was not installed globally, or the npm global bin directory is not in your system's PATH.

fix Run `npm i -g cloudcc-cli` to install the CLI globally. If the issue persists, ensure your system's PATH environment variable includes the directory where npm installs global packages (e.g., `~/.npm-global/bin` on Unix-like systems).
```
Assertion crash during `cloudcc create project` or template scaffolding failure.
```
cause Specific issues with template file copying logic or missing expected template files (e.g., `AGENTS.md`, `CLAUDE.md`) in older CLI versions.

fix Update `cloudcc-cli` to the latest version (`npm update -g cloudcc-cli`). Version 2.5.1 and newer include hardening for template scaffold copying and improved fallback logic for critical files.

Warnings

gotcha Using the `cc` command alias on macOS/Linux may conflict with the system C compiler (`clang`, `gcc`, etc.).
Fix: Always prefer using `cloudcc` as the command name on Unix-like systems to avoid name collisions and ensure you are executing the intended CloudCC CLI. The `cc` alias remains for backward compatibility.
breaking The default configuration file format has migrated from JavaScript (`cloudcc-cli.config.js`) to JSON (`cloudcc-cli.config.json`). The legacy JavaScript file is no longer included in package sources.
Fix: If you have an existing `cloudcc-cli.config.js` file, you must manually migrate its content to the new `cloudcc-cli.config.json` format. The CLI will no longer recognize or bundle the `.js` version.
gotcha After installing the Cursor Agent Skill, you might need to restart Cursor or reload the editor window for the skill to become active and visible.
Fix: Restart your Cursor editor or use the 'Reload Window' command within Cursor to ensure the newly installed skill is properly loaded and recognized.

Install

npm install cloudcc-cli npm
yarn add cloudcc-cli yarn
pnpm add cloudcc-cli pnpm

Imports

cloudcc (CLI command)
wrong:
```
import { cloudcc } from 'cloudcc-cli'
```
correct:
```
npm i -g cloudcc-cli
cloudcc get version
```
This package primarily provides global command-line executables. Direct programmatic import is not the intended use case. Access commands via `cloudcc` or `cc` after global installation.
cc (CLI command alias)
wrong:
```
const cc = require('cloudcc-cli')
```
correct:
```
npm i -g cloudcc-cli
cc help version
```
`cc` is an alias for `cloudcc`. On macOS/Linux, `cloudcc` is recommended to avoid potential conflicts with system C compilers (e.g., `clang` or `gcc`), which often also use the `cc` command name. Use `cloudcc` for consistency across platforms and to prevent conflicts.
Cursor Agent Skill
wrong:
```
npm i -g cloudcc-dev-skill
```
correct:
```
cloudcc install skill
```
The `cloudcc-dev-skill` is bundled with `cloudcc-cli` and installed via the CLI's `install skill` command, not directly as a separate npm package.

Quickstart

Installs the CloudCC CLI globally and demonstrates how to check its version and install the Cursor Agent Skill.

npm i -g cloudcc-cli

# Verify installation and get the current version
cloudcc get version

# Get general help information
cloudcc help version

# Install the optional Cursor AI agent skill
cloudcc install skill

view raw JSON →