Skip to main content
comet update keeps your Comet installation current by updating both the npm package and the skill files deployed to your AI coding platforms.

​
Usage

comet update [path]
path defaults to . (the current directory) when omitted. You can also update the package directly without refreshing skills: 
npm install -g @rpamis/comet@latest

​
What update Does

  1. Updates the npm package — Runs npm install -g @rpamis/comet@latest (global install) or npm install @rpamis/comet@latest (project install), depending on how Comet was originally installed. If the npm update fails, the command continues with the bundled skill files from the currently installed package.
  2. Detects installed targets — Scans both the project directory and the home directory for platforms that already have Comet skills installed (files starting with comet inside the platform’s skills/ directory).
  3. Detects installed language — Reads each target’s existing skill files to determine whether en or zh skills are installed, and preserves that language unless overridden with --language.
  4. Refreshes Comet skill files — Copies the latest skill files from the updated package’s assets to each detected target, always overwriting.
If no installed targets are found, comet update exits with a prompt to run comet init first.

​
Flags

​
--json
boolean
Suppress progress output and print a single structured JSON result when the command finishes. See JSON output below.
​
--language
string
Override the auto-detected skill language for all targets. Accepted values: en (English) or zh (Chinese). Without this flag, each target’s existing language is preserved individually.
​
--scope
string
Limit the update to a single scope. Accepted values: project or global. Without this flag, both scopes are scanned and updated.

​
Example Output

  Comet Update v1.3.0

  Updating npm package (global scope)...
    $ npm install -g @rpamis/comet@latest
  npm package: updated to latest @rpamis/comet

  Updating comet skills on 2 installed target(s):
    - Claude Code (project (/your/project), en)
      $ copy assets/skills -> .claude/skills/ (project)
    - Cursor (global, en)
      $ copy assets/skills -> ~/.cursor/skills/ (global)

  Copying 8 skill files...

  Claude Code (project, skills): 8 copied, 0 skipped
  Cursor (global, skills): 8 copied, 0 skipped

  Summary:
    npm: updated (global)
    skills: 2 target(s), 16 files updated
    scope: project, global
    language: en

  Update complete.

​
JSON Output

comet update --json

{
  "npm": {
    "scope": "global",
    "status": "updated",
    "command": "npm install -g @rpamis/comet@latest"
  },
  "skills": {
    "totalCopied": 16,
    "targets": [
      {
        "scope": "project",
        "platform": "claude",
        "platformName": "Claude Code",
        "language": "en",
        "source": "skills",
        "copied": 8,
        "skipped": 0,
        "command": "copy assets/skills -> .claude/skills/ (project)"
      },
      {
        "scope": "global",
        "platform": "cursor",
        "platformName": "Cursor",
        "language": "en",
        "source": "skills",
        "copied": 8,
        "skipped": 0,
        "command": "copy assets/skills -> ~/.cursor/skills/ (global)"
      }
    ]
  }
}
The npm.status field is one of:
ValueMeaning
updatedThe npm package was updated successfully.
failedThe npm update command exited with a non-zero code; skill files from the current package were used instead.
skippedThe npm update step was skipped.
Run comet update regularly to get the latest skill improvements, new phase commands, and bug fixes. Skill files are always overwritten — there is no conflict prompt.
comet update only refreshes Comet skill files. OpenSpec and Superpowers skills are managed by their own separate packages and are not touched by this command.