Rename git pkgs outdated to git pkgs stale

Author: andrew

CHANGELOG.md

@@ -1,7 +1,6 @@
 ## [Unreleased]
 
-## [0.3.0] - 2026-01-02
-
+- Renamed `git pkgs outdated` to `git pkgs stale` (outdated remains as alias)
 - `git pkgs log` command to list commits with dependency changes
 - `git pkgs schema` command to output database schema in text, SQL, JSON, or markdown
 - `git pkgs praise` alias for `blame`

README.md

@@ -226,6 +226,17 @@ git pkgs tree --ecosystem=rubygems
 
 This shows dependencies grouped by type (runtime, development, etc).
 
+### Find stale dependencies
+
+```bash
+git pkgs stale                  # list deps by how long since last touched
+git pkgs stale --days=365       # only show deps untouched for a year
+git pkgs stale --ecosystem=npm  # filter by ecosystem
+git pkgs outdated               # alias for stale
+```
+
+Shows dependencies sorted by how long since they were last changed in your repo. Useful for finding packages that may have been forgotten or need review.
+
 ### Diff between commits
 
 ```bash

lib/git/pkgs.rb

@@ -21,7 +21,7 @@
 require_relative "pkgs/commands/history"
 require_relative "pkgs/commands/why"
 require_relative "pkgs/commands/blame"
-require_relative "pkgs/commands/outdated"
+require_relative "pkgs/commands/stale"
 require_relative "pkgs/commands/stats"
 require_relative "pkgs/commands/diff"
 require_relative "pkgs/commands/tree"

lib/git/pkgs/cli.rb

@@ -5,8 +5,8 @@
 module Git
   module Pkgs
     class CLI
-      COMMANDS = %w[init update hooks info list tree history search why blame outdated stats diff branch show log upgrade schema].freeze
-      ALIASES = { "praise" => "blame" }.freeze
+      COMMANDS = %w[init update hooks info list tree history search why blame stale stats diff branch show log upgrade schema].freeze
+      ALIASES = { "praise" => "blame", "outdated" => "stale" }.freeze
 
       def self.run(args)
         new(args).run
@@ -59,7 +59,7 @@ def print_help
             search    Find a dependency across all history
             why       Explain why a dependency exists
             blame     Show who added each dependency
-            outdated  Show dependencies that haven't been updated
+            stale     Show dependencies that haven't been updated
             stats     Show dependency statistics
             diff      Show dependency changes between commits
             show      Show dependency changes in a commit

lib/git/pkgs/commands/outdated.rb lib/git/pkgs/commands/stale.rblib/git/pkgs/commands/outdated.rb renamed to lib/git/pkgs/commands/stale.rb

@@ -3,7 +3,7 @@
 module Git
   module Pkgs
     module Commands
-      class Outdated
+      class Stale
         def initialize(args)
           @args = args
           @options = parse_options
@@ -93,7 +93,7 @@ def parse_options
           options = {}
 
           parser = OptionParser.new do |opts|
-            opts.banner = "Usage: git pkgs outdated [options]"
+            opts.banner = "Usage: git pkgs stale [options]"
 
             opts.on("-e", "--ecosystem=NAME", "Filter by ecosystem") do |v|
               options[:ecosystem] = v