Li+のセットアップは、ワークスペースに設定ファイルを1つ配置するだけです。 初回セッションでAIが環境を自動検出し、必要なファイルを生成します。

このページは Quickstart です。各設定値の詳細は B. Configuration、更新同期手続きの詳細は C. Update を参照します。

Li+config.md は各リリースに添付されています。→ 最新リリース

• AIエージェント環境（Claude Code / CODEX 等）
• GitHubアカウント
• GitHub Personal Access Token（GH_TOKEN）
• CODEX (Windows ネイティブ環境) の場合のみ: gh CLI を事前にインストール

  • Claude 側（Linux/Mac）は SessionStart hook が ~/.local/bin/gh を自動配置しますが、CODEX の Windows ネイティブ環境ではこの自動インストール経路は使えません（プラットフォーム違い）。

  • Windows ターミナルで以下を一度だけ実行します（bootstrap は代行しません。明示的にユーザーが実行）：

    winget install --id GitHub.cli
    

  • 既に gh が入っていればスキップして構いません。

1. GitHubの Settings → Developer settings → Personal access tokens → Fine-grained tokens へ移動
2. Generate new token をクリック
3. 以下の権限を付与：
   • Repository access: 作業リポジトリ（Li+本体はpublicリポジトリのため追加不要）
   • Permissions: Contents: Read and write、Issues: Read and write、Pull requests: Read and write、Metadata: Read-only
4. 生成されたトークンをコピーして控えておく

最新リリース のAssetsから Li+config.md をダウンロードし、ワークスペースフォルダに配置します。

詳細な意味は B. Configuration を参照し、ここでは初回セットアップに必要な項目だけ確認します。

Li+ は ブランチ → PR → CI → マージ のフローで動作します。 GitHub 側にルールセットを設定しておくと、AI・人間ともに main への直接 push を防げます。

この手順は GitHub の Web UI で行います。

1. リポジトリの Settings タブを開く
2. 左メニューの Rules → Rulesets を選択
3. New ruleset → New branch ruleset をクリック

1. Ruleset Name に名前を入力（例: Branch protection rules）
2. Enforcement status を Active に設定
3. Bypass list は空のままにする（オーナーを含め誰もバイパスできない状態を推奨）

1. Target branches セクションで Add target をクリック
2. Default branch を選択（main ブランチが保護対象になる）

Rules セクションで以下のルールにチェックを入れます：

Restrict deletions

• デフォルトブランチの削除を禁止します

Require a pull request before merging

• main への直接 push を禁止し、PR 経由のマージを強制します
• チェックを入れると追加設定が表示されます：
  • Required approvals: 0（AI主体リポジトリの最小構成。チーム開発では 1 以上を推奨）
  • Allowed merge methods: プロジェクトに合わせて選択（デフォルトの Merge, Squash, Rebase すべて有効で OK）

Require status checks to pass

• CI が通らないとマージできなくなります
• チェックを入れると追加設定が表示されます：
  • Add checks をクリックし、リポジトリの CI ジョブ名を追加（例: CI）
  • CI ジョブ名は GitHub Actions ワークフローの jobs.<job_id>.name と一致させてください

ページ下部の Create ボタンをクリックして保存します。

補足

• ルールセットは Settings → Rules → Rulesets からいつでも変更できます
• CI ジョブが未作成の場合は、先にワークフローを追加してからステータスチェックを設定してください

新しいセッションを開始し、AIに Li+config.md の読み込みと実行を依頼します。

例：

Li+config.md を読んで実行して

AIが自動的に：

1. 環境を検出（Claude / CODEX）
2. Li+config.md のパーミッションを保護（Linux/Mac: chmod 600）
3. 基本言語とプロジェクト言語が未設定なら対話で確認して Li+config.md へ保存
4. gh CLI を確認（Claude / Linux・Mac は初回のみ自動配置。CODEX / Windows ネイティブは winget 前提条件として事前インストール。上記「前提条件」参照）
5. GH_TOKENで認証
6. LI_PLUS_CHANNEL に対応する対象バージョンを確認
7. 既存 clone と対象バージョンがずれていれば、人間に更新するか確認
8. rules/**/*.md を常時ロード（L1–L4 の常時ロード分、subdir 含む常に必須。L5 Notifications と L6 Adapter は rules/<layer>/ を持たない予約スロット。詳細は 判断構造 layer-reorg-rationale）。Claude は .claude/rules/ フォルダの自動ロード、CODEX は SessionStart hook の additionalContext 注入で常時ロードを実現します。skills/**/SKILL.md は両ホストとも description マッチによる自動発火（手動トリガー表は廃止済み）
9. 環境に応じた設定ファイルを自動生成

詳細な更新同期ステップ定義は C. Update を参照します。

設定ファイルが自動で読み込まれるため、以下のように送るだけで起動します：

Li+適応。

セッション開始後、AIに話しかけると Lin または Lay として応答が返ってきます。 名前が表示されていればLi+の適用が成功しています。

Claude Code は .claude/CLAUDE.md / .claude/settings.json / .mcp.json 等を内部的に sensitive file として扱い、Edit / Write 時に独立した許可プロンプトを出します。これは以下の手段では override できません。

• "permissions": {"allow": ["Edit(**)", "Write(**)"]} 設定
• --dangerously-skip-permissions フラグ

Li+ clone mode bootstrap は毎セッション、tag 差分があれば .claude/CLAUDE.md / .claude/hooks/*.sh を上書きします。tag 更新の度に許可プロンプトが出るため、頻繁な更新時の UX 負債になります。

長期的な解決方向: プラグイン化 (~/.claude/plugins/ への移動) により harness 内部 file ops 経路を経由させ、sensitive-file gate を回避します。allowlist や bypass mode では .claude/ 配下の摩擦は解消されないため、回避策提案前に実機検証を行ってください。

同構造の他 sensitive file 候補: .claude/settings.json, .mcp.json, .claude/skills/** および .claude/rules/** の一部の可能性があります (要個別検証)。

CODEX ホストでは bootstrap が以下を生成します（Claude の .claude/ 配下に相当する Codex ネイティブ配置）：

Claude の hook と違い、Codex の hook は実行前に一度だけ GUI で trust が必要です（実機検証済み #1502）。

1. bootstrap が .codex/hooks.json と .codex/hooks/* を書いた後、Codex App → 設定 (Settings) → フック (Hooks) → 当該プロジェクトの行 → 信頼する (trust) をトグルします。
   • CLI の /hooks コマンドは Codex App には存在しません。trust は GUI 専用です。
2. trust は hook の内容ハッシュ単位です。Li+ の build 更新で hook 本体が変わる（tag bump で *.ps1 / *.sh が再生成される）たびに、Codex は 再度 trust を要求します。build 更新のたびに再 trust してください。
3. trust 前は hook は走らず、ログも書かれません（＝発見失敗ではなく trust ゲートでの停止）。skill は trust ゲートの影響を受けません（trust 不要で発火）。

trust が無いと SessionStart の rules 注入と毎ターンの Trigger Check Gate 再注入が無音で何もしません＝Codex 上の Li+「常時オン」挙動の硬い前提条件です。

.codex/hooks/*.ps1 は BOM 付き UTF-8（先頭 3 バイト EF BB BF）です。これを呼び出す Windows PowerShell 5.1 は BOM 無しの非 ASCII .ps1 を誤読するため、bootstrap は BOM を含めてバイト単位でコピーします。リポジトリ側も .gitattributes の *.ps1 -text で clone / checkout 時の改行正規化を無効化し、BOM とバイト列を保全しています。手動でこれらを編集する場合は BOM を維持してください。

• GH_TOKEN はチャットに表示されません（セキュリティ上の設計）
• LI_PLUS_MODE=clone の初回セッションはリポジトリのcloneのため数秒かかります
• LI_PLUS_MODE=clone の次回以降のセッションでは、AI が起動時に対象タグとの差分を確認し、更新があれば人間に確認します
• 作業リポジトリを持たない場合は USER_REPO1 以降をデフォルト値のままにしてください（または行ごと残しておけば bootstrap がスキップします）
• 設定ファイルの自動生成は初回のみ実行され、既存ファイルを上書きしません
• LI_PLUS_BASE_LANGUAGE と LI_PLUS_PROJECT_LANGUAGE は配布先workspace専用です。liplus-language 本体の日本語運用ルールとは分離されます
• LI_PLUS_MODE=api は軽量ですが、trigger-based re-readなどの継続機能は保証されません。継続利用には clone を推奨します
• local webhook fallback を使うなら LI_PLUS_MODE=clone を推奨します。bundled helper は liplus-language/ clone を前提にします
• Windows環境では python3 コマンドがMicrosoft Storeスタブになっている場合があります。hookテンプレートは command -v で python3 → python の順にフォールバック解決します

• B. Configuration — 設定リファレンス
• C. Update — アダプター / 設定の更新同期手続き
• 1. Model — Li+の中核仕様