CLI リファレンス

rasen CLI（rasen）は、プロジェクトのセットアップ、検証、状態検査、および管理のための端末コマンドを提供します。これらのコマンドは、コマンドで説明されているAIスラッシュコマンド（/rasen:proposeなど）を補完します。

概要

人間とエージェントのコマンド

ほとんどのCLIコマンドは人間が端末で使用するように設計されています。一部のコマンドは JSON 出力を通じてエージェント/スクリプト使用もサポートしています。

人間専用コマンド

これらのコマンドはインタラクティブで、端末での使用向けに設計されています。

エージェント互換コマンド

これらのコマンドはAIエージェントおよびスクリプトによるプログラマティック使用のための--json出力をサポートしています。

グローバル オプション

これらのオプションはすべてのコマンドで機能します。

セットアップ コマンド

rasen init

プロジェクトでraseんを初期化します。フォルダ構造を作成し、AIツール統合を構成します。

デフォルトの動作はグローバル設定のデフォルトを使用します: プロファイル full（すべてのワークフロー）、交付方式 both。

rasen init [path] [options]

引数:

オプション:

--profile custom はグローバル設定で現在選択されているワークフロー（rasen config profile）を使用します。

サポートされているツールID（--tools）: amazon-q, antigravity, auggie, bob, claude, cline, codex, forgecode, codebuddy, continue, costrict, crush, cursor, factory, gemini, github-copilot, iflow, junie, kilocode, kimi, kiro, lingma, vibe, opencode, pi, qoder, qwen, roocode, trae, windsurf

このリストは src/core/config.ts の AI_TOOLS を反映しています。各ツールのスキルとコマンドパスについては、サポート対象ツールを参照してください。

例:

# インタラクティブ初期化
rasen init

# 特定のディレクトリで初期化します
rasen init ./my-project

# 非インタラクティブ: ClaudeとCursorに対して構成します
rasen init --tools claude,cursor

# すべてのサポートされているツール用に構成します
rasen init --tools all

# このrun用にプロファイルをオーバーライドします
rasen init --profile core

# プロンプトをスキップしてレガシーファイルを自動クリーンアップします
rasen init --force

作成内容:

rasen/
├── specs/              # 仕様（信頼できる情報源）
├── changes/            # 提案された変更
└── config.yaml         # プロジェクト設定

.claude/skills/         # Claude Code スキル（claudeを選択した場合）
.cursor/skills/         # Cursor スキル（cursorを選択した場合）
.cursor/commands/       # Cursor OPSX コマンド（交付方式がbothの場合）
... (その他のツール設定)

rasen update

CLIをアップグレード後にraseん指示ファイルを更新します。現在のグローバルプロファイル、選択されたワークフロー、および交付方式を使用してAIツール設定ファイルを再生成します。

rasen update [path] [options]

引数:

オプション:

例:

# npm アップグレード後に指示ファイルを更新します
npm update @atelierai/rasen
rasen update

ストア（スタンドアロンraseんリポジトリ）

ベータ版。 ストアおよびそれに基づいて構築された機能（参照、作業コンテキスト、ワークセット）は新しいもので、コマンド名、フラグ、ファイル形式、およびJSON出力はリリース間で変わる可能性があります。問題優先チュートリアルについては、ストアガイドを参照してください。

ストアはこのマシンに登録した スタンドアロンraseんリポジトリです—たとえば、プランニング リポジトリまたは契約リポジトリです。ストアを登録すると、通常のコマンド（list、show、status、validate、new change、archive、...）がどこからでも --store <id> を渡して実行できます。

rasen store setup

ローカル ストアを作成して登録します。端末でこれ以上の引数なしでRaseンはユーザーをセットアップ プロセスを通じて誘導します。エージェントおよびスクリプトは明示的な入力を渡し、--json を使用する必要があります。

rasen store setup [id] [options]

オプション:

非インタラクティブ実行（--json、スクリプト、エージェント）はストアIDと --path の両方を渡す必要があります。インタラクティブ端末では、セットアップがユーザーが所有する可視フォルダの編集可能な提案で位置情報をプロンプトします（たとえば ~/rasen/<id>）。raseんのマネージドデータディレクトリにはデフォルトの値は指定されません。

例:

rasen store setup
rasen store setup team-context
rasen store setup team-context --path ~/rasen/team-context --no-init-git
rasen store setup team-context --path ~/rasen/team-context --no-init-git --json

rasen store register

既存のローカル ストア フォルダを登録します。

rasen store register [path] [options]

オプション:

rasen store unregister

ファイルを削除せずにローカル ストア登録を忘れます。

rasen store unregister <id> [--json]

ストアが移動されたか、他の場所にクローンされたか、このマシンでraseんによって表示されなくなるべき場合に使用します。

rasen store remove

ローカル ストア登録を忘れて、そのローカル フォルダを削除します。

rasen store remove <id> [--yes] [--json]

remove はインタラクティブ端末で削除前に正確なフォルダを表示します。 エージェント、スクリプト、およびJSON呼び出し元は削除を確認するために --yes を渡す必要があります。 Raseんは一致するストアメタデータを含まないフォルダの削除を拒否します。

rasen store list

ローカルに登録されたストアをリストします。

rasen store list [--json]
rasen store ls [--json]

rasen store doctor

ローカル ストア登録、メタデータ、およびGit 存在をチェックします。

rasen store doctor [id] [--json]

Doctorは診断のみ。ストアを変更せずに、ルートの欠落、メタデータの不一致、および無効なローカルレジストリ状態を報告します。

プロジェクトからストアを参照

プロジェクト リポは rasen/config.yaml に作業が依存するストアを宣言できます。

schema: spec-driven
references:
  - team-context

その後、そのリポのrasen instructions出力（成果物別およびapplyサーフェスの両方、JSONおよび人間モード）は、参照される各ストアの仕様インデックスを保持します—仕様ID、各仕様のPurposeセクションからの1行の要約、およびフェッチコマンド（rasen show <spec-id> --type spec --store <id>）。インデックスは毎回実行されたとき登録されたチェックアウトからライブで構築され、仕様コンテンツは出力にコピーされることはありません。

参照は読み取り専用コンテキストです。コマンドが動作する場所を変更しません: 作業はリポの独自のルートに留まり、参照ストアへの書き込みは明示的な --store アクションのままです。解決できない参照（たとえば、このマシンに登録されていないストア）は、正確な修正を伴う警告にダウングレードされ、指示は引き続き生成されます。rasen doctor は1つの場所で参照の健全性をレポートします。

ストアのクローン元の記録

ストアはコミットされたID ファイルに正規クローン ソースを記録できるため、オンボーディングは「ストアを登録する」で行き止まりすることはありません。

rasen store setup team-context --path ~/rasen/team-context \
  --remote git@github.com:acme/team-context.git

リモートは初期コミット内の .rasen-store/store.yaml に配置されるため、すべてのクローンはそれを知らせて生まれます。既存のストアの場合、store.yaml を手動で編集してコミットします。store doctor は記録されたリモート（およびチェックアウトの観察されたGit オリジン）を表示します。セットアップ/レジスタ共有ガイダンスはそれに名前を付けます。レジスタはチェックアウトのオリジンをマシンローカルレジストリに記録します。

参照宣言はクローン ソースも保持できるため、ストアをまだ持っていないチームメイトは完全で、貼り付け可能な修正を取得します（git clone <remote> <path> && rasen store register <path> --id <id>）。

references:
  - { id: team-context, remote: "git@github.com:acme/team-context.git" }

リモートの記録は同期ではありません: Raseんは独自にクローン、プル、またはプッシュしません。

デフォルト ストアを宣言

プランニングが完全に外部化されたリポ—ローカル rasen/specs/ または rasen/changes/ なし—はストアを一度宣言でき、すべてのコマンドで --store を渡す必要がありません。

# rasen/config.yaml（rasen/の唯一のファイル）
store: team-context

通常のコマンドは宣言されたストアに自動的に解決されます。ルート バナーおよびJSON root ブロックはストアIDを持つ source: "declared" をレポートし、印刷されたヒントは引き続き --store <id> を保持します。宣言はフォールバックであり、上書きではありません。明示的な --store は常に勝ちます。実際のプランニング フォルダを含むディレクトリはポインタを無視します（警告付き）。ポインタ リポをローカル Raseん ルートに変換するには、store: 行を削除して rasen init を実行します。宣言が存在する場合、initはスキャフォールドを拒否します。

ドクター（関係性の健全性）

1つの読み取り専用質問、1つの場所: Raseんルートは健全で、それが参照するストアはこのマシンで利用可能ですか？

rasen doctor [--store <id>] [--json]

レポートはルートの健全性、ストアメタデータの健全性（記録されたリモートとチェックアウトのオリジンが異なるときの注記を含む）、および参照の健全性（指示が表示するのと同じ診断）を分離します。任意の重大度の健全性調査は終了コード0で終了します—エージェントは status 配列を読み取ります。コマンド障害（ルートなし、不明なストア）のみ終了コード1で終了します。Doctorはクローン、同期、または修復を行いません。組み立てられたセット自体ではなくその健全性を取得するには、rasen context を使用します。

作業コンテキスト（組み立てられたセット）

この作業がraseん宣言を通じて関連するすべてのもの、1つのワーキングセット内: Raseんルートおよびそれが参照するストア。

rasen context [--store <id>] [--json] [--code-workspace <path> [--force]]

JSONブリーフはエージェント消費可能（利用可能な参照ストアは各々フェッチレシピを保持。解決されないメンバーは指示とドクターが表示するのと同じ修正を保持）。--code-workspace はさらにルートと利用可能な参照ストア（ref:<id> フォルダ）を含むVS Code ワークスペース ファイルを書き込みます—このコマンドが実行する唯一の書き込みは、ファイルが存在する場合は --force なしで拒否されます。利用不可メンバーが報告されます。推測されることはありません。

「作業コンテキスト」は組み立てられたセットです。rasen/config.yaml 内の context: フィールドは指示に注入されたプロジェクト背景です—2つの異なるもの。rasen doctor はセットが健全かどうかを答えます。rasen context はセットが何かを答えます。

個人用ワークセット

ベータ版。 ワークセットは新しいベータ サーフェスの一部です。コマンド、フラグ、およびファイル形式はリリース間で変わる可能性があります。チュートリアルについては、ストアガイドを参照してください。

ワークセットは、一緒に作業するフォルダの個人的な名前付きビュー—プランニング ルートおよび選択した他のもの—をマシンに保持し、ツール内で名前でオープンし直します。それは純粋にローカルです: コミットされない、共有されない、宣言から導出されない、1つを削除してもメンバー フォルダに触れません。

rasen workset create [name] [--member <path> | --member <name>=<path>]... [--tool <id>] [--json]
rasen workset list [--json]
rasen workset open <name> [--tool <id>]
rasen workset remove <name> [--yes] [--json]

create は短いガイド付きフロー（または --member フラグを非インタラクティブに取得。最初のメンバーが主要）を実行します。open は選択したツールを起動します: エディタ（VS Code、Cursor）はすべてのメンバーと共にウィンドウをオープンして戻します。CLIエージェント（Claude Code、codex）はこの端末をセッションとして引き継ぎ、すべてのメンバーがアタッチされて、プリフィルされたプロンプトなしで、終了するときに終わります。オープン時にメンバー フォルダが見つからない場合はスキップされます。残りが開きます。保存されたツール設定は --tool でオープンごとにオーバーライドできます。

新しいツールをサポートするのは設定であり、コード ではありません。すべてのツールは2つの起動スタイル—workspace-file（生成された .code-workspace で起動）または attach-dirs（メンバーごとに1つのアタッチフラグ）—のいずれかで、グローバル config.json 内の openers キー（rasen config edit で開く）がツールを追加するか、フィールドごとに組み込みを調整します。

{
  "openers": {
    "zed": { "style": "workspace-file" },
    "claude": { "attach_flag": "--dir" }
  }
}

すべてのワークセット状態はグローバルデータディレクトリの worksets/ フォルダの下に存在します（保存されたビューおよび生成された <name>.code-workspace ファイル、毎回開くときに再生成）。そのフォルダを削除するとすべてのトレースが削除されます。

マシン データの場所: グローバルデータディレクトリ（ワークセット、ストア レジストリ、プロジェクト レジストリ、ユーザー スキーマ/パイプライン）およびグローバル設定ディレクトリ（config.json）は、すべてのプラットフォームでデフォルトで ~/.rasen に存在します。RASEN_HOME を設定してカスタム ディレクトリに両方を再配置します。XDG_DATA_HOME/XDG_CONFIG_HOME は依然として RASEN_HOME 以下で互換性エイリアスとして尊重されます。アップグレード後の最初の実行で、古いプラットフォーム固有の場所にあるデータは ~/.rasen に採用されます。

ブラウジング コマンド

rasen list

プロジェクト内の変更またはスペックをリストします。

rasen list [options]

オプション:

例:

# すべての活動している変更をリストします
rasen list

# すべてのスペックをリストします
rasen list --specs

# スクリプト用のJSON出力
rasen list --json

出力（テキスト）:

Changes:
  add-dark-mode     No tasks      just now

rasen view

仕様と変更を探索するためのインタラクティブ ダッシュボードを表示します。

rasen view

プロジェクトの仕様と変更をナビゲートするための端末ベースのインターフェースを開きます。

rasen show

変更またはスペックの詳細を表示します。

rasen show [item-name] [options]

引数:

オプション:

変更固有のオプション:

スペック固有のオプション:

例:

# インタラクティブ選択
rasen show

# 特定の変更を表示します
rasen show add-dark-mode

# 特定のスペックを表示します
rasen show auth --type spec

# 解析用のJSON出力
rasen show add-dark-mode --json

検証コマンド

rasen validate

構造的な問題がないか変更とスペックを検証します。

rasen validate [item-name] [options]

引数:

オプション:

例:

# インタラクティブ検証
rasen validate

# 特定の変更を検証します
rasen validate add-dark-mode

# すべての変更を検証します
rasen validate --changes

# JSON出力を使用してすべてを検証します（CI/スクリプト用）
rasen validate --all --json

# 並列度を上げて厳密な検証を行います
rasen validate --all --strict --concurrency 12

出力（テキスト）:

Validating add-dark-mode...
  ✓ proposal.md valid
  ✓ specs/ui/spec.md valid
  ⚠ design.md: missing "Technical Approach" section

1 warning found

出力（JSON）:

{
  "version": "1.0.0",
  "results": {
    "changes": [
      {
        "name": "add-dark-mode",
        "valid": true,
        "warnings": ["design.md: missing 'Technical Approach' section"]
      }
    ]
  },
  "summary": {
    "total": 1,
    "valid": 1,
    "invalid": 0
  }
}

ライフサイクル コマンド

rasen archive

完了した変更をアーカイブして、デルタ仕様をメイン仕様にマージします。

rasen archive [change-name] [options]

引数:

オプション:

例:

# インタラクティブ アーカイブ
rasen archive

# 特定の変更をアーカイブします
rasen archive add-dark-mode

# プロンプトなしでアーカイブします（CI/スクリプト）
rasen archive add-dark-mode --yes

# 仕様に影響しないツール変更をアーカイブします
rasen archive update-ci-config --skip-specs

実行内容:

1. 変更を検証します（--no-validate でない限り）
2. 確認をプロンプトします（--yes でない限り）
3. デルタ仕様を rasen/specs/ にマージします
4. 変更フォルダを rasen/changes/archive/YYYY-MM-DD-<name>/ に移動します

ワークフロー コマンド

これらのコマンドは、成果物駆動OPSXワークフローをサポートします。進行状況を確認している人間とエージェントが次のステップを決定するのに役立ちます。

rasen new change

変更ディレクトリおよび解決されたRaseんルート内のオプションのチェックインメタデータを作成します。

rasen new change <name> [options]

オプション:

例:

rasen new change add-billing-api
rasen new change add-billing-api --store team-context --json

rasen status

変更の成果物完了状態を表示します。

rasen status [options]

オプション:

例:

# インタラクティブ ステータス チェック
rasen status

# 特定の変更のステータス
rasen status --change add-dark-mode

# エージェント使用用のJSON
rasen status --change add-dark-mode --json

出力（テキスト）:

Change: add-dark-mode
Schema: spec-driven
Progress: 2/4 artifacts complete

[x] proposal
[ ] design
[x] specs
[-] tasks (blocked by: design)

出力（JSON）:

{
  "changeName": "add-dark-mode",
  "schemaName": "spec-driven",
  "isComplete": false,
  "applyRequires": ["tasks"],
  "artifacts": [
    {"id": "proposal", "outputPath": "proposal.md", "status": "done"},
    {"id": "design", "outputPath": "design.md", "status": "ready"},
    {"id": "specs", "outputPath": "specs/**/*.md", "status": "done"},
    {"id": "tasks", "outputPath": "tasks.md", "status": "blocked", "missingDeps": ["design"]}
  ]
}

rasen instructions

成果物を作成または実装タスクを適用するための充実した指示を取得します。AIエージェントが次に何を作成すべきかを理解するために使用されます。

rasen instructions [artifact] [options]

引数:

オプション:

特別な場合: タスク実装指示を取得するには、成果物として apply を使用します。

例:

# 次の成果物の指示を取得します
rasen instructions --change add-dark-mode

# 特定の成果物指示を取得します
rasen instructions design --change add-dark-mode

# 適用/実装指示を取得します
rasen instructions apply --change add-dark-mode

# エージェント消費用のJSON
rasen instructions design --change add-dark-mode --json

出力に含まれるもの:

• 成果物のテンプレートコンテンツ
• 設定のプロジェクト コンテキスト
• 依存成果物のコンテンツ
• 設定の成果物ごとのルール

rasen templates

スキーマ内のすべての成果物の解決されたテンプレート パスを表示します。

rasen templates [options]

オプション:

例:

# デフォルト スキーマのテンプレート パスを表示します
rasen templates

# カスタム スキーマのテンプレートを表示します
rasen templates --schema my-workflow

# プログラマティック使用用のJSON
rasen templates --json

出力（テキスト）:

Schema: spec-driven

Templates:
  proposal  → ~/.rasen/schemas/spec-driven/templates/proposal.md
  specs     → ~/.rasen/schemas/spec-driven/templates/specs.md
  design    → ~/.rasen/schemas/spec-driven/templates/design.md
  tasks     → ~/.rasen/schemas/spec-driven/templates/tasks.md

rasen schemas

利用可能なワークフロー スキーマと、その説明および成果物フローをリストします。

rasen schemas [options]

オプション:

例:

rasen schemas

出力:

Available schemas:

  spec-driven (package)
    The default spec-driven development workflow
    Flow: proposal → specs → design → tasks

  my-custom (project)
    Custom workflow for this project
    Flow: research → proposal → tasks

スキーマ コマンド

カスタム ワークフロー スキーマを作成および管理するためのコマンド。

rasen schema init

新しいプロジェクト ローカル スキーマを作成します。

rasen schema init <name> [options]

引数:

オプション:

例:

# インタラクティブ スキーマ作成
rasen schema init research-first

# 特定の成果物を使用した非インタラクティブ
rasen schema init rapid \
  --description "Rapid iteration workflow" \
  --artifacts "proposal,tasks" \
  --default

作成内容:

rasen/schemas/<name>/
├── schema.yaml           # スキーマ定義
└── templates/
    ├── proposal.md       # 各成果物のテンプレート
    ├── specs.md
    ├── design.md
    └── tasks.md

rasen schema fork

既存のスキーマをプロジェクトにコピーしてカスタマイズします。

rasen schema fork <source> [name] [options]

引数:

オプション:

例:

# 組み込みspec-drivenスキーマをフォークします
rasen schema fork spec-driven my-workflow

rasen schema validate

スキーマの構造とテンプレートを検証します。

rasen schema validate [name] [options]

引数:

オプション:

例:

# 特定のスキーマを検証します
rasen schema validate my-workflow

# すべてのスキーマを検証します
rasen schema validate

rasen schema which

スキーマがどこから解決されるかを表示します（優先度をデバッグするために便利）。

rasen schema which [name] [options]

引数:

オプション:

例:

# スキーマの出所を確認します
rasen schema which spec-driven

出力:

spec-driven resolves from: package
  Source: /usr/local/lib/node_modules/@atelierai/rasen/schemas/spec-driven

スキーマの優先度:

1. プロジェクト: rasen/schemas/<name>/
2. ユーザー: ~/.rasen/schemas/<name>/（または $RASEN_HOME/schemas/<name>/ が設定されている場合）
3. パッケージ: 組み込みスキーマ

設定コマンド

rasen config

グローバルraseん設定を表示および変更します。

rasen config <subcommand> [options]

サブコマンド:

例:

# 設定ファイル パスを表示します
rasen config path

# すべての設定を表示します
rasen config list

# 特定の値を取得します
rasen config get telemetry.enabled

# 値を設定します
rasen config set telemetry.enabled false

# 文字列値を明示的に設定します
rasen config set user.name "My Name" --string

# カスタム設定を削除します
rasen config unset user.name

# すべての設定をリセットします
rasen config reset --all --yes

# エディタで設定を編集します
rasen config edit

# アクションベースウィザードでプロファイルを構成します
rasen config profile

# 高速プリセット: ワークフローをコアに切り替えます（交付方式を保持）
rasen config profile core

rasen config profile は現在の状態の要約で始まり、次に選択できます。

• 交付方式とワークフローを変更します
• 交付方式のみを変更します
• ワークフローのみを変更します
• 現在の設定を保持します（終了）

現在の設定を保持する場合、変更は書き込まれず、更新プロンプトは表示されません。 設定に変更がない場合でも、現在のプロジェクト ファイルがグローバル プロファイル/交付方式と同期していない場合、raseんは警告を表示して rasen update を提案します。 Ctrl+C を押すとフロー が きれいにキャンセルされ（スタックトレースなし）、終了コード 130 で終了します。 ワークフロー チェックリストでは、[x] はワークフローがグローバル設定で選択されていることを意味します。これらの選択をプロジェクト ファイルに適用するには、rasen update を実行します（またはプロンプト内で Apply changes to this project now? を選択）。

インタラクティブ例:

# 交付方式のみの更新
rasen config profile
# 選択: 交付方式のみを変更します
# 交付方式を選択: スキルのみ

# ワークフローのみの更新
rasen config profile
# 選択: ワークフローのみを変更します
# チェックリストでワークフローを切り替えて、確認します

ユーティリティ コマンド

rasen feedback

raseんについてのフィードバックを送信します。GitHubイシューを作成します。

rasen feedback <message> [options]

引数:

オプション:

要件: GitHub CLI（gh）がインストールされ、認証されている必要があります。

例:

rasen feedback "Add support for custom artifact types" \
  --body "I'd like to define my own artifact types beyond the built-in ones."

rasen completion

raseん CLIのシェル補完を管理します。

rasen completion <subcommand> [shell]

サブコマンド:

サポートされているシェル: bash, zsh, fish, powershell

例:

# 補完をインストールします（シェルを自動検出）
rasen completion install

# 特定のシェル用にインストールします
rasen completion install zsh

# 手動インストール用にスクリプトを生成します
rasen completion generate bash > ~/.bash_completion.d/rasen

# アンインストール
rasen completion uninstall

終了コード

環境変数

関連ドキュメント

• コマンド - AIスラッシュコマンド（/rasen:propose, /rasen:applyなど）
• ワークフロー - 一般的なパターンおよび各コマンドを使用する場合
• カスタマイズ - カスタム スキーマおよびテンプレートを作成します
• はじめに - 初回セットアップ ガイド