CLI Reference
Complete reference for all Centy CLI commands.
Global Options
These options are available for most commands:
| Option | Description |
|---|---|
--help, -h | Show help for a command |
--version, -v | Show Centy version |
--json | Output results as JSON |
Project Management
centy init
Initialize Centy in the current directory.
centy init [options]
Options:
| Option | Description | Default |
|---|---|---|
--force, -f | Skip interactive prompts and use defaults | false |
Examples:
centy init
centy init --force
centy info
Get Centy daemon info and version.
centy info [options]
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy version
Get project version info and comparison with daemon.
centy version [options]
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy config
Get the project configuration.
centy config [options]
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy manifest
Get the project manifest.
centy manifest [options]
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy update
Update project to a target version (runs migrations).
centy update [options]
Options:
| Option | Description | Default |
|---|---|---|
--target, -t | Target version to update to | Daemon version |
--force, -f | Skip confirmation prompt | false |
Examples:
centy update
centy update --target 0.2.0
centy update --force
Daemon Commands
centy start
Start the Centy daemon.
centy start [options]
Options:
| Option | Description |
|---|---|
--foreground, -f | Run daemon in foreground (blocks terminal) |
centy restart
Restart the Centy daemon.
centy restart [options]
Options:
| Option | Description | Default |
|---|---|---|
--delay, -d | Delay in seconds before restart | 0 |
centy shutdown
Shutdown the Centy daemon gracefully.
centy shutdown [options]
Options:
| Option | Description | Default |
|---|---|---|
--delay, -d | Delay in seconds before shutdown | 0 |
Issue Commands
centy create issue
Create a new issue.
centy create issue [options]
Options:
| Option | Description | Default |
|---|---|---|
--title, -t | Issue title | Interactive prompt |
--description, -d | Issue description | None |
--priority, -p | Priority level (low/medium/high) | Config default |
--status, -s | Initial status | open |
Examples:
centy create issue
centy create issue --title "Fix login bug"
centy create issue --title "Fix login bug" --priority high
centy create issue -t "Add dark mode" -d "Implement dark theme support" -p medium
centy list issues
List all issues in the project.
centy list issues [options]
Options:
| Option | Description | Default |
|---|---|---|
--status, -s | Filter by status | All |
--priority, -p | Filter by priority level (1 = highest) | All |
--json | Output as JSON | false |
Examples:
centy list issues
centy list issues --status open
centy list issues --priority 1
centy list issues --json
centy get issue
Display details of a specific issue.
centy get issue <id> [options]
Arguments:
id: Issue display number or UUID
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
Examples:
centy get issue 1
centy get issue 6a740dbd-ec2d-45f9-9927-fdcb6c3d3801
centy get issue 1 --json
centy update issue
Update issue metadata.
centy update issue <id> [options]
Arguments:
id: Issue display number or UUID
Options:
| Option | Description |
|---|---|
--title, -t | New title |
--description, -d | New description |
--status, -s | New status (e.g., open, in-progress, closed) |
--priority, -p | New priority (low/medium/high or 1-3) |
Examples:
centy update issue 1 --status in-progress
centy update issue 1 --status closed
centy update issue 1 --title "Updated title" --priority high
centy delete issue
Delete an issue permanently.
centy delete issue <id> [options]
Arguments:
id: Issue display number or UUID
Options:
| Option | Description | Default |
|---|---|---|
--force, -f | Skip confirmation | false |
Examples:
centy delete issue 1
centy delete issue 1 --force
Documentation Commands
centy create doc
Create a new document.
centy create doc [options]
Options:
| Option | Description | Required |
|---|---|---|
--title, -t | Doc title | Yes |
--content, -c | Doc content (markdown) | No |
--slug | Custom URL-friendly slug | No (auto-generated) |
--template | Template name to use | No |
Examples:
centy create doc --title "API Reference"
centy create doc -t "Getting Started" -c "# Welcome"
centy create doc --title "Users API" --slug users
centy list docs
List all documents.
centy list docs [options]
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy get doc
Display a document.
centy get doc <slug> [options]
Arguments:
slug: Document slug
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
Examples:
centy get doc getting-started
centy get doc api-reference --json
centy update doc
Update an existing document.
centy update doc <slug> [options]
Arguments:
slug: Document slug
Options:
| Option | Description |
|---|---|
--title, -t | New title |
--content, -c | New content (markdown) |
--new-slug | Rename to a new slug |
Examples:
centy update doc getting-started --title "New Title"
centy update doc api-docs --new-slug api-reference
centy delete doc
Delete a document.
centy delete doc <slug> [options]
Arguments:
slug: Document slug
Options:
| Option | Description | Default |
|---|---|---|
--force, -f | Skip confirmation | false |
Asset Commands
centy add asset
Add an asset to an issue or as a shared asset.
centy add asset <file> [options]
Arguments:
file: Path to the file to add
Options:
| Option | Description |
|---|---|
--issue, -i | Issue ID or display number to attach the asset to |
--shared, -s | Add as a shared asset (accessible by all issues) |
--name, -n | Custom filename (defaults to original filename) |
Examples:
centy add asset screenshot.png --issue 1
centy add asset diagram.svg --shared
centy add asset ./error-log.txt -i 1 -n "debug-log.txt"
centy list assets
List assets for an issue or shared assets.
centy list assets [options]
Options:
| Option | Description |
|---|---|
--issue, -i | Issue ID or display number |
--shared, -s | List only shared assets |
--include-shared | Include shared assets when listing issue assets |
--json | Output as JSON |
Examples:
centy list assets --issue 1
centy list assets --shared
centy list assets -i 1 --include-shared
centy get asset
Get an asset and save it to a file.
centy get asset <filename> [options]
Arguments:
filename: Asset filename
Options:
| Option | Description |
|---|---|
--issue, -i | Issue ID or display number |
--shared, -s | Get a shared asset |
--output, -o | Output file path (defaults to asset filename) |
Examples:
centy get asset screenshot.png --issue 1
centy get asset logo.svg --shared --output ./my-logo.svg
centy delete asset
Delete an asset.
centy delete asset <filename> [options]
Arguments:
filename: Asset filename
Options:
| Option | Description |
|---|---|
--issue, -i | Issue ID or display number |
--shared, -s | Delete a shared asset |
--force, -f | Skip confirmation prompt |
Examples:
centy delete asset screenshot.png --issue 1
centy delete asset logo.svg --shared --force
Project Commands
centy list projects
List all tracked Centy projects.
centy list projects [options]
Options:
| Option | Description |
|---|---|
--include-stale | Include projects where path no longer exists |
--json | Output as JSON |
centy get project
Get info about a specific project.
centy get project [path] [options]
Arguments:
path: Path to the project (defaults to current directory)
Options:
| Option | Description |
|---|---|
--json | Output as JSON |
centy register project
Register a project for tracking.
centy register project [path]
Arguments:
path: Path to the project (defaults to current directory)
centy untrack project
Remove a project from tracking.
centy untrack project [path] [options]
Arguments:
path: Path to the project (defaults to current directory)
Options:
| Option | Description | Default |
|---|---|---|
--force, -f | Skip confirmation prompt | false |
Exit Codes
| Code | Description |
|---|---|
0 | Success |
1 | General error |
2 | Invalid arguments |
Next Steps
- Configuration - Configure Centy behavior
- LLM Integration - AI assistant integration