Pastoralist は、依存性オーバーライドを維持しながら、プロジェクトをより安全に保ちます。

appendix で各オーバーライドを追跡します。パッケージはそれに依存します。 最初に記録され、削除できるかどうか。

オーバーライドトラッキング

既存の [qs] オーバーライドすると、[pastoralist]] を実行して、このレコードを追加します。

この例では[express → qsを使用します。 依存関係と日付が生成されます。 示されているバージョンはフィクスチャー入力です。

クイックスタート

npm または Homebrew でグローバル CLI をインストールします。

プロジェクトの場合、 dev の dependency としてインストールします。

[doctor] プレビューの変更。 pastoralistを実行して、付録を更新します。

npx pastoralist init agent-skillでバンドルされたエージェントのスキルをインストールします。 [npx pastoralist --setup-hook] を使用して、[postinstall]] に追加します。

セットアップ用のドキュメントを参照してください。 構成、ワークスペース、セキュリティ、インタラクティブな例。

##CLI API の使い方

以下のコマンドは、プロジェクトから[pastoralistと仮定します

Pastoralist

Pastoralist keeps projects more secure while maintaining dependency overrides.

It tracks each override in an appendix: which packages depend on it, when it was first recorded, and whether it can be removed.

Packages you install bring dependencies of their own. Overrides let you choose a different version or replacement package—for example, to address a security issue.

Override Tracking

With an existing qs override, running pastoralist adds this record:

--- package.json
+++ package.json
@@ -5,5 +5,17 @@
   },
   "overrides": {
     "qs": "6.11.2"
+  },
+  "pastoralist": {
+    "appendix": {
+      "[email protected]": {
+        "dependents": {
+          "shepherd-cli": "qs (required by express)"
+        },
+        "ledger": {
+          "addedDate": "2026-10-16"
+        }
+      }
+    }
   }
 }

This example uses express → qs. The dependents and date are generated; the versions shown are fixture inputs.

Quick Start

Install the global CLI with npm or Homebrew:

npm install --global pastoralist
# or
brew install yowainwright/tap/pastoralist

For a project, install it as a dev dependency:

npm install pastoralist --save-dev
npx pastoralist doctor
npx pastoralist

doctor previews changes. Running pastoralist updates the appendix.

Install the bundled agent skill with npx pastoralist init agent-skill. Use npx pastoralist --setup-hook to add it to postinstall.

See the docs for setup, configuration, workspaces, security, and interactive examples.

CLI API

The direct commands below assume pastoralist is available from a project script, global npm install, or Homebrew install. Use npx pastoralist ... for one-off project setup.

pastoralist

Type: command

Updates the target package manifest’s override appendix. It reads npm overrides, pnpm pnpm.overrides or pnpm-workspace.yaml (pnpm 11+),