Pastoralist는 의존성을 유지하면서 더 안전하게 프로젝트를 유지합니다.

그것은 appendix에 각 override를 추적합니다. 패키지는 그것에 따라 달라집니다. 처음 기록되어 제거 할 수 있는지 여부.

오버라이드 추적

기존 qs override, 실행 pastoralist] 이 레코드를 추가:

이 예제는 express → qs를 사용합니다. 의존과 날짜가 생성됩니다; 표시된 버전은 정착물 입력입니다.

빠른 시작

npm 또는 Homebrew로 글로벌 CLI 설치:

프로젝트의 경우, dev 의존성으로 설치하십시오:

doctor 미리보기 변경. pastoralist] appendix 업데이트.

번들 에이전트 기술을 npx pastoralist init agent-skill에 설치하십시오. npx pastoralist --setup-hook] 을 postinstall] 에 추가합니다.

설정에 대한 docs를 참조, 구성, 작업 공간, 보안 및 대화형 예제.

클립

아래의 직접 명령은 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+),