@einja/dev-cli

Claude Code用の.claude設定ディレクトリをnpxでインストールできるCLI。

クイックスタート

``bash
npx @einja/dev-cli init
`

インストール

`bash


npx（推奨）

npx @einja/dev-cli init

グローバルインストール

npm install -g @einja/dev-cli
@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.3

npx直接実行

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