| name | backlog-cli |
| description | CLI for Backlog project management (by Nulab). Use this skill when:
(1) Listing, creating, editing, closing, or commenting on issues
(2) Creating, listing, merging, or commenting on pull requests
(3) Viewing, creating, or editing Wiki pages
(4) Querying project settings (issue types, statuses, categories, milestones, members)
(5) Checking notifications, stars, or watches
(6) Making raw API requests via `backlog api`
|
backlog-cli
CLI tool for managing Backlog projects via the backlog command.
Authentication
Run backlog auth login before use. Verify with backlog auth status.
Switch between spaces with --space <hostname> or BACKLOG_SPACE env var.
Key Concepts
Avoid Interactive Prompts
Some commands prompt interactively for missing required fields. Always specify all required flags explicitly to prevent hanging.
Name Resolution
The CLI automatically resolves human-readable names to IDs:
- Status names → status ID
- Issue type names → issue type ID
- Priority names (
高/中/低) → priority ID
- Usernames → user ID (
@me refers to the authenticated user)
Status and issue type names are project-specific. Query them first if unknown:
backlog issue-type list -p PROJECT_KEY
backlog status list -p PROJECT_KEY
Issue Keys
Format: PROJECT_KEY-number (e.g., PROJ-123). Since the key embeds the project, --project is not needed for issue view / issue edit.
Project Key
