Listing Packages

List all tracked packages

stamp list

Shows every package recorded in your manifest.

htop (apt)
lazygit (brew) — better git TUI than default
spotify (flatpak)

JSON output

stamp list --json

[
  {"Name": "htop", "Manager": "apt", "Notes": "", "Origin": "stamped"},
  {"Name": "lazygit", "Manager": "brew", "Notes": "better git TUI than default", "Origin": "stamped"},
  {"Name": "spotify", "Manager": "flatpak", "Notes": "", "Origin": "stamped"}
]

Filter by manager

stamp list -m brew

lazygit (brew) — better git TUI than default

Filter by entity type and origin

Use --type, -t to filter by entity type (packages vs repos) and origin (stamped vs reconciled):

stamp list -t repos                        # all repositories
stamp list -t stamped                      # packages + repos installed via stamp
stamp list -t reconciled                   # everything discovered by reconcile
stamp list -t stamped-packages             # packages installed via stamp only
stamp list -t reconciled-repos -m dnf      # repos reconcile discovered, dnf only
stamp list -t stamped-repos -j             # stamp-added repos, as JSON

Valid values: packages (default), repos, stamped, reconciled, stamped-packages, stamped-repos, reconciled-packages, reconciled-repos, missing.

# stamp list -t stamped
htop (dnf) — system monitor
lazygit (brew) — better git TUI than default
my-tap (brew)

# stamp list -t reconciled
NetworkManager (dnf)
brave-browser (dnf) https://example.com/brave

Missing packages

--type missing lists manifest packages that are not installed on the current system — typically packages removed directly via your native package manager (e.g. sudo dnf remove htop). It queries the installed state of every active manager, so it always reflects the live system.

stamp list -t missing

htop (dnf)
spotify (flatpak)

stamp ls --type missing is the same view under the ls alias. It composes with --manager and --json; when nothing is missing it prints no missing packages. This view never changes your manifest — use stamp restore to reinstall anything listed here.

stamp list -t missing -m dnf      # missing dnf packages only
stamp list -t missing --json      # machine-readable

Understanding Origins

Every package and repository in the manifest has an origin that records how stamp learned about it:

• stamped — The user installed this via stamp install or stamp reinstall. Stamp recorded intent at install time. This is the recommended way to track packages.
• reconciled — The user installed this directly via their package manager (e.g. dnf install) and stamp later discovered it through stamp reconcile. These packages are also user-installed, but stamp learned about them after the fact.

Both origins represent packages the user installed — the difference is how stamp learned about them.

Use stamp list -t stamped to see everything you explicitly tracked through stamp. Use stamp list -t reconciled to see everything reconcile auto-discovered. Use stamp list -t stamped-packages to see only packages (excluding repos) you installed via stamp.

Alias

stamp ls

What you see

Go tools appear as module paths (e.g., github.com/golangci/golangci-lint) when the path is recoverable from the binary metadata. If the module path is not recoverable, the binary name is shown instead.

Only intentionally installed packages appear in the list — no dependency noise.