{"id":16973,"library":"cloudcc-cli","title":"CloudCC Command Line Interface","description":"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.","status":"active","version":"2.5.2","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","cloudcc","cloudcc-cli"],"install":[{"cmd":"npm install cloudcc-cli","lang":"bash","label":"npm"},{"cmd":"yarn add cloudcc-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add cloudcc-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"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.","wrong":"import { cloudcc } from 'cloudcc-cli'","symbol":"cloudcc (CLI command)","correct":"npm i -g cloudcc-cli\ncloudcc get version"},{"note":"`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.","wrong":"const cc = require('cloudcc-cli')","symbol":"cc (CLI command alias)","correct":"npm i -g cloudcc-cli\ncc help version"},{"note":"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.","wrong":"npm i -g cloudcc-dev-skill","symbol":"Cursor Agent Skill","correct":"cloudcc install skill"}],"quickstart":{"code":"npm i -g cloudcc-cli\n\n# Verify installation and get the current version\ncloudcc get version\n\n# Get general help information\ncloudcc help version\n\n# Install the optional Cursor AI agent skill\ncloudcc install skill","lang":"bash","description":"Installs the CloudCC CLI globally and demonstrates how to check its version and install the Cursor Agent Skill."},"warnings":[{"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.","message":"Using the `cc` command alias on macOS/Linux may conflict with the system C compiler (`clang`, `gcc`, etc.).","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"breaking","affected_versions":">=2.5.2"},{"fix":"Restart your Cursor editor or use the 'Reload Window' command within Cursor to ensure the newly installed skill is properly loaded and recognized.","message":"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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"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).","cause":"The `cloudcc-cli` package was not installed globally, or the npm global bin directory is not in your system's PATH.","error":"cloudcc: command not found"},{"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.","cause":"Specific issues with template file copying logic or missing expected template files (e.g., `AGENTS.md`, `CLAUDE.md`) in older CLI versions.","error":"Assertion crash during `cloudcc create project` or template scaffolding failure."}],"ecosystem":"npm","meta_description":null}