Complete reference for the @ntdev204/copilot-kit CLI.
Package
@ntdev204/copilot-kit
Version
1.1.0
Node.js
≥ 22
copilot-kit initScaffolds the complete .github/ configuration directory into the current working directory.
npx @ntdev204/copilot-kit initnpm install -g @ntdev204/copilot-kit
copilot-kit initNo .github/ exists
Downloads tarball from main branch, extracts to .github/
.github/ already exists
Prompts: ? Overwrite existing .github/? (y/N)
User confirms overwrite
Replaces entire .github/ directory with latest content
User declines
Exits without changes
No args / unknown command
Prints usage help
Network error
Exits with error message, no files modified
Always-latest content
init always gets the newest skills, rules, and prompts — no npm update needed for content changes.copilot-kit updateChecks whether your local .github/ is behind the remote HEAD. If a new version is available, shows an old → new SHA diff and asks for confirmation before overwriting.
npx @ntdev204/copilot-kit update.github/ not found
Exits with error — run init first
Already up-to-date
Prints SHA and exits without downloading
New version available
Shows current SHA → latest SHA diff, prompts (y/N)
User confirms
Wipes old .github/, downloads and extracts latest, writes new SHA
User declines
Exits without changes
GitHub API unreachable
Exits with error — cannot determine if update is needed
ℹ Current : abc1234
ℹ Latest : e339ca5 ← new version available
? Update .github/ to the latest version? (y/N) y
✔ .github/ updated successfully!
From abc1234 → e339ca5SHA tracking
init or update, the CLI writes a .github/.copilot-kit-sha file. This is how update detects whether your copy is current.copilot-kit statusDisplays the installation health of .github/, lists each expected component with item counts, and compares the local SHA against the remote HEAD.
npx @ntdev204/copilot-kit status| Section | What it checks |
|---|---|
| Installation | .github/ directory presence and path |
| Components | copilot-instructions.md, skills/, rules/, prompts/, agent/, scripts/ |
| Version | Local SHA (.copilot-kit-sha) vs. remote HEAD SHA from GitHub API |
| Verdict | Green (up-to-date) / Yellow (update available) / Red (missing components) |
| Code | Meaning |
|---|---|
0 | Success |
1 | Error (network failure, file system error, unknown command) |