@curl-ticket/cli

English | 繁體中文

English

CLI tool for Curl Ticket — query issues and update status from your terminal.

Tip: All commands support the short alias ct — e.g. ct projects instead of curl-ticket projects.

Install

npm install -g @curl-ticket/cli
# or
pnpm add -g @curl-ticket/cli

Quick Start

Run any command to start the interactive setup:

ct projects

On first run, you'll be prompted to enter your Curl Ticket instance URL, then a browser window will open for authentication. Your credentials are saved locally at ~/.config/curl-ticket/config.json.

Commands

Issues

# List all accessible projects
ct projects

# List issues for a project
ct issues <projectId>

# Filter by status and type
ct issues <projectId> -s Open -t api_bug -n 10

# Get issue details (by ID or friendly ID like CT-42)
ct issue <projectId> <issueId>
ct issue <projectId> CT-42

# Update issue status
ct update-status <projectId> <issueId> Open
ct update-status <projectId> <issueId> in-progress
ct update-status <projectId> <issueId> Done
ct update-status <projectId> <issueId> Close

Authentication

# Login (with explicit URL)
ct auth login --url https://your-instance.example.com

# Check login status
ct auth status

# Logout
ct auth logout

Claude Code Integration

This CLI ships with a Claude Code Skill that lets Claude automatically query and analyze issues from your codebase.

# Install the skill into your project
ct init-skill

After setup, mention any issue (e.g. "look at CT-42") in Claude Code, and it will automatically fetch the issue details and help locate the relevant code.

Configuration

Authentication can be configured in two ways:

1. Interactive login (recommended): Run any command and follow the prompts
2. Environment variables: Set CURL_TICKET_URL and CURL_TICKET_TOKEN

Requirements

• Node.js >= 20
• A running Curl Ticket instance

繁體中文

Curl Ticket 的 CLI 工具 — 直接在終端機查詢 issue 並更新狀態。

提示： 所有指令都支援短指令 ct — 例如用 ct projects 取代 curl-ticket projects。

安裝

npm install -g @curl-ticket/cli
# 或
pnpm add -g @curl-ticket/cli

快速開始

執行任何指令即可啟動互動式設定：

ct projects

首次執行時，系統會提示你輸入 Curl Ticket 站台網址，接著開啟瀏覽器進行登入驗證。登入資訊會儲存在 ~/.config/curl-ticket/config.json。

指令

Issue 相關

# 列出所有可存取的專案
ct projects

# 列出專案的 issue
ct issues <projectId>

# 依狀態和類型過濾
ct issues <projectId> -s Open -t api_bug -n 10

# 取得 issue 詳情（支援 ID 或編號如 CT-42）
ct issue <projectId> <issueId>
ct issue <projectId> CT-42

# 更新 issue 狀態
ct update-status <projectId> <issueId> Open
ct update-status <projectId> <issueId> in-progress
ct update-status <projectId> <issueId> Done
ct update-status <projectId> <issueId> Close

認證

# 登入（手動指定網址）
ct auth login --url https://your-instance.example.com

# 查看登入狀態
ct auth status

# 登出
ct auth logout

Claude Code 整合

此 CLI 內建 Claude Code Skill，讓 Claude 能自動查詢 issue 並分析程式碼中的問題。

# 在專案中安裝 Skill
ct init-skill

安裝後，在 Claude Code 中提到任何 issue（例如「幫我看 CT-42」），Claude 就會自動取得 issue 詳情並協助定位相關程式碼。

設定方式

認證支援兩種方式：

1. 互動式登入（推薦）：執行任何指令，依提示操作即可
2. 環境變數：設定 CURL_TICKET_URL 和 CURL_TICKET_TOKEN

系統需求

• Node.js >= 20
• 一個已部署的 Curl Ticket 站台

License

MIT