@arrhq/crate-cli

Crate のプロジェクト運用を CLI で行うための公式クライアントです。

Install

npm i -g @arrhq/crate-cli

Quick Start

crate auth login --crate-url https://crateio.com
crate context init
crate tool list
crate session list --visibility active --lifecycle-status active --limit 20

• crate auth login はユーザー認証を行います。
• crate context init は repository root に .crate/config.json を作成し、リポジトリ単位で project_id と github_repo を固定します。
• crate context init は --project-id 省略時に、認証済みの対話環境ならブラウザでプロジェクト選択を開きます。非対話環境では --project-id <uuid> を指定してください。

.crate/config.json の例:

{
  "project_id": "11111111-1111-4111-8111-111111111111",
  "github_repo": "arrhq/crate"
}

Common Commands

crate auth status
crate context show
crate issue list --status in_progress --limit 20
crate issue create --title "CLI redesign" --summary "gh 風の command surface へ寄せる"
crate issue start --issue 123
crate issue plan show --issue 123
crate issue plan sync --issue 123 --checklist-file ./plan.md
crate issue checklist update --issue 123 --item-title "検証を完了する" --status done
crate issue complete --summary "CLI surface を整理した" --artifact-url https://github.com/arrhq/crate/pull/999
crate session view
crate session list --visibility active --lifecycle-status active --limit 20
crate session archive --all --except-session-id t/9123210a97c3079bddca5142a71c04bba50cabec --dry-run
crate session archive --all --except-session-id t/9123210a97c3079bddca5142a71c04bba50cabec
crate session progress --state "実装を進めている" --now "README を整理している" --next "PR を作成する"
crate session checkpoint --kind pr_opened --summary "PR #999 を作成した" --reason "レビュー共有の基点を残す" --next-action "CI の結果を確認する" --reference-url https://github.com/arrhq/crate/pull/999
crate session cleanup

crate session list は lifecycle 判定付きの一覧取得、crate session archive は単体または一括 archive に対応します。t/<40hex> の history alias も --session-id / --except-session-id にそのまま指定できます。

日常利用では crate issue ... と crate session ... が中心です。より細かい制御や開発者向けの low-level command は repository README を参照してください。

CI / Headless

export CRATE_URL="https://crateio.com"
export CRATE_TOKEN="<crate_mt_...>"
export CRATE_PROJECT_ID="<project_uuid>" # optional

More Docs

• 詳細な運用仕様: repository README
• パッケージ情報: npm package page