Пасториалист сохраняет проекты более безопасными, сохраняя при этом зависимость.

Он отслеживает каждый оверрайд в приложении: какие пакеты зависят от него, когда он Был впервые записан, и можно ли его удалить.

Отслеживание ошибок

При этом [[4]], [[5]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]], [[T]] [[T]

В этом примере используется [6]. генерируются иждивенцы и дата; Показанные версии являются фиксирующими входами.

Быстрый старт

Установите глобальный CLI с помощью npm или Homebrew:

Для проекта установите его как зависимость от разработчика:

[7] Превью изменений. [8] Обновление приложения.

Установите мастерство агента с помощью npx pastoralist init agent-skill. Используйте [10], чтобы добавить его [11].

Смотрите документы для установки, конфигурации, рабочих пространств, безопасности и интерактивных примеров.

API CLI

Прямые команды ниже предполагают, что 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+),