Einja CLI - .claude設定とテンプレート同期をnpxでインストール
npm install @einja/dev-cliClaude Code用の.claude設定ディレクトリをnpxでインストールできるCLI。
``bash`
npx @einja/dev-cli init
`bashnpx(推奨)
npx @einja/dev-cli init
コマンド
$3
.claudeディレクトリをセットアップします。`bash
npx @einja/dev-cli init
`オプション:
| オプション | 説明 |
|-----------|------|
|
-f, --force | 上書き確認をスキップ |
| --dry-run | 実行内容をプレビュー |
| --no-backup | バックアップを作成しない |自動追加されるnpm scripts:
init 実行時に package.json の scripts に以下が自動追加されます:`json
{
"scripts": {
"task:loop": "npx @einja/dev-cli task:loop",
"einja:sync": "npx @einja/dev-cli sync"
}
}
`これにより、以下のコマンドが使用可能になります:
-
pnpm task:loop 123 - タスクループ実行
- pnpm einja:sync - テンプレート同期$3
テンプレートから更新を同期します。
`bash
全カテゴリを同期
npx @einja/dev-cli sync特定カテゴリのみ同期
npx @einja/dev-cli sync --only commands,agents
npx @einja/dev-cli sync --only hooks
`オプション:
| オプション | 説明 |
|-----------|------|
|
-o, --only | 同期するカテゴリをカンマ区切りで指定 |
| -d, --dry-run | 実際の変更を行わず、差分のみ表示 |
| -f, --force | ローカル変更を無視してテンプレートで上書き |
| -y, --yes | 確認プロンプトをスキップ |
| --no-backup | 変更前にバックアップを作成しない |同期可能なカテゴリ:
-
commands - Claude Code コマンド
- agents - エージェント定義
- skills - スキル定義
- hooks - Git Hooks
- docs - ステアリングドキュメント
- env - 環境設定ファイル(.envrc)マーカーによる部分同期:
ファイルには、同期動作を制御するマーカーがあります:
-
@einja:managed - 常にテンプレート版で上書き(共通ルール)
- @einja:seed - 初回のみ追加、以降はローカル編集を保持(プロジェクト固有設定)
- @einja:excluded - テンプレートのみに存在し、syncでコピーされない(テンプレート専用設定)詳細は マーカー仕様書 を参照してください。
JSONマージ設定:
.einja-sync.jsonにjsonPathsを設定することで、JSONファイルのマージ動作を制御できます:`json
{
"version": "1.0.0",
"lastSync": "2024-01-11T00:00:00Z",
"templateVersion": "1.0.0",
"files": {},
"jsonPaths": {
"managed": {
"package.json": ["scripts.dev", "scripts.build", "scripts.lint"]
},
"seed": {
"package.json": ["scripts.custom"]
}
}
}
`- managed パス: 常にテンプレート値で上書き
- seed パス: ローカルに存在しない場合のみテンプレート値をコピー
- その他: ローカル優先(ユーザー追加分を保持)
注意:
jsonPaths設定はcreate-einja-app addコマンドと共通です。$3
GitHub Issueのタスクを自動実行します(Claude Code経由)。
`bash
pnpm scripts経由(推奨)
pnpm task:loop 123
pnpm task:loop 123 --max-group 1.3npx直接実行
npx @einja/dev-cli task:loop 123
`オプション:
| オプション | 説明 |
|-----------|------|
|
-m, --max-group | 最大タスクグループ番号 |
| -b, --branch | ベースブランチ |前提条件:
-
gh CLI がインストール済み(GitHub Issue操作に必要)
- Vibe-Kanbanが起動している(npx vibe-kanban)配布内容
Einja ATDDワークフロー構成(Next.js、Vibe-Kanban統合)を配布します。
`
.claude/
├── settings.json
├── agents/
│ ├── specs/ # 仕様書生成 (3)
│ ├── task/ # タスク実行 (6)
│ └── einja/frontend/ # フロントエンド (3)
├── commands/
│ ├── spec-create.md
│ ├── task-exec.md
│ └── einja-*/ # Einja固有コマンド
├── skills/
│ └── einja-*/ # コーディング規約、設計ガイド
└── hooks/ # Git Hooks (9個)
├── biome-format.sh
├── typecheck.sh
└── ...docs/
├── templates/ # ドキュメントテンプレート
└── steering/ # プロジェクト基本方針
`含まれるMCPサーバー設定:
- codex, context7, playwright, serena, github, vibe_kanban
カスタマイズ
$3
プロジェクト固有の設定は
settings.local.jsonに記述します。`json
{
"permissions": {
"allow": ["Bash(custom-script:*)"]
}
}
`$3
プロジェクトルートに
CLAUDE.mdを作成してプロジェクト固有の指示を追加できます。開発
`bash
ビルド
pnpm buildテスト
pnpm test型チェック
pnpm typecheck
`前提となるコマンド
サブエージェント(task-qa、task-commit、task-reviewer等)が以下のコマンドの存在を前提としています。
| コマンド | 使用者 | 用途 |
|---------|--------|------|
|
prepush | task-commit | コミット前の品質チェック |
| test | task-qa, task-reviewer | ユニットテスト実行 |
| lint | task-qa, task-reviewer | Biome lintチェック |
| typecheck | task-qa, task-reviewer | TypeScript型チェック |
| build | task-qa, task-reviewer | ビルド確認 |
| dev | CLAUDE.md | 開発サーバー起動 |
| dev:bg | CLAUDE.md | バックグラウンド開発サーバー |推奨: これらのコマンドがすべて含まれる
create-einja-app でプロジェクトを作成してください。`bash
npx create-einja-app my-project
``- Node.js >= 20.0.0
MIT