pkg.soopen package index

brew / rang 2877

Installer adr-tools avec Homebrew, apt, Nix

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de adr-tools pour les workflows d'agents IA.

Commande d'installationNotes de sécurité

installation

Commandes d'installation supplémentaires

macOS

Homebrewvérifié · 100%
brew install adr-tools

local Homebrew formula metadata

Linux

Debian aptvérifié · 92%
sudo apt install adr-tools

Debian stable package indexes · adr-tools · Source: deb.debian.org

Nixvérifié · 92%
nix profile install nixpkgs#adr-tools

nixpkgs package indexes · pkgs/by-name/ad/adr-tools/package.nix · Source: api.github.com

aperçu

Résumé du paquet

CLI tool for working with Architecture Decision Records

Commandes et alias

  • _adr_add_link
  • _adr_autocomplete
  • _adr_commands
  • _adr_dir
  • _adr_file
  • _adr_generate_graph
  • _adr_generate_toc
  • _adr_help
  • _adr_help_new
  • _adr_links
  • _adr_remove_status
  • _adr_status
  • _adr_title
  • adr
  • adr-config
  • adr-generate
  • adr-help
  • adr-init
  • adr-link
  • adr-list
  • adr-new
  • adr-upgrade-repository

historique

Historique du projet et usages

ADR Tools is Nat Pryce's shell-based command-line toolkit for creating and maintaining Architecture Decision Records in a source tree. It became one of the reference implementations for teams that wanted ADRs as simple numbered Markdown files rather than a hosted documentation system.

Historique du projet

The project records its own first ADR on 2016-02-12, deciding to use Architecture Decision Records for its architecture decisions. Its README positions the tool around a log of ADRs, with Markdown records stored under a project subdirectory, defaulting to `doc/adr`.

ADR Tools deliberately uses Unix shell scripts. The project ADR directory includes decisions such as implementing the tool as shell scripts, using a single command with subcommands, storing records in Markdown, invoking `adr-config` for installation-specific configuration, and using ISO-8601 dates.

The 2018 release series added repository upgrades, ISO-8601 date format support, arbitrary links between ADRs, graph visualisation output, generated tables of contents, bash completion, better help text, Git Bash support on Windows, and parent-directory search for ADR directories.

Historique d'adoption

ADR Tools adopted the same source-control-native posture as ADRs themselves: its install documentation recommends Homebrew on macOS, release archives or Git on Linux/macOS, Git Bash or WSL on Windows, and shell autocomplete installation where supported.

The provided package metadata shows distribution through Homebrew, Debian, Ubuntu, and Nix. The GitHub repository's large star and fork counts also reflect broad recognition among architecture-documentation users, but its day-to-day adoption is usually invisible because the generated ADR files live inside other projects' repositories.

Modes d'utilisation

The common workflow is `adr init` to create an ADR directory, `adr new` to create a numbered Markdown record, and `adr help` for subcommands. The README says new records are opened in the user's editor through `VISUAL` or `EDITOR`.

Teams use it to keep architectural decisions close to code, review them like any other text change, and link or supersede older decisions as architecture changes. Generated graphs and tables of contents make it useful beyond the first few records.

Pourquoi les passionnés de paquets s'y intéressent

ADR Tools is package-nerd significant because it is a tiny shell distribution that turns an architectural practice into a Unix command. Its behavior is easy to audit, easy to vendor, and easy for package managers to ship without a runtime stack beyond POSIX-ish shell tooling.

It also shaped conventions that other tools follow, especially the default `doc/adr` directory and numbered Markdown filenames. That convention is visible in adr-viewer, which defaults to the same path because ADR Tools generates it.

Chronologie

  • 2016: Project ADR 1 recorded the use of Architecture Decision Records.
  • 2016: Early ADRs chose shell scripts, a single command with subcommands, and Markdown format.
  • 2018: Version 2.0.0 added ISO-8601 dates and repository upgrade support.
  • 2018: Version 2.1.0 added arbitrary links and Graphviz history/relationship output.
  • 2018: Version 2.2.0 added better help, bash autocomplete, and Git Bash support.
  • 2018: Version 3.0.0 added parent-directory ADR discovery and graph layout improvements.

Related projects

  • adr-viewer consumes ADR directories and defaults to ADR Tools' `doc/adr` path.
  • Michael Nygard's ADR article is linked from the README as the conceptual source for the record format and practice.

posture de sécurité

Niveau de risque : blue

broad file, network, media, or database tool signal.

Classificateur de risque

risque blue · confiance moyen · tool

Pourquoi

  • broad file, network, media, or database tool signal

Signaux

  • text:record

Comportement d'installation

  • Aucune métadonnée de bottle Homebrew n’a été enregistrée.

Revue recommandée

Avant une utilisation sans surveillance par un agent, vérifiez si l'outil lit des identifiants en clair, écrit un état distant, publie des artefacts ou lance des plugins.

exécutables

Exécutables installés

CommandeTypeExpositionNote
_adr_add_linkexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_autocompleteexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_commandsexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_direxécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_fileexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_generate_graphexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_generate_tocexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_helpexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_help_newexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_linksexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_remove_statusexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_statusexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
_adr_titleexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adrexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-configexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-generateexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-helpexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-initexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-linkexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-listexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-newexécutableexécutable indexéDécouvert depuis l'index local des exécutables.
adr-upgrade-repositoryexécutableexécutable indexéDécouvert depuis l'index local des exécutables.

fraîcheur

Version et fraîcheur

Ces signaux séparent l'âge de génération de la page, l'activité du gestionnaire de paquets et la comparaison avec les versions amont. Un retard de version n'est signalé que lorsqu'une URL de preuve et des versions comparables sont présentes.

page générée2026-08-03
version du gestionnaire3.0.0
gestionnaire mis à jour2026-05-26
données localesinconnu
amontnon disponible
dernière version détectéenon détecté
  • OKAucun avertissement de fraîcheur n'a été généré.

métadonnées d'installation

Métadonnées du paquet

Clé du paquetbrew:adr-tools
Version3.0.0
Gestionnaire de paquetsHomebrew
Page d'accueilhttps://github.com/npryce/adr-tools
Dépôthttps://github.com/npryce/adr-tools
Dernière mise à jour2026-05-26T23:37:49-04:00
Pulseupdated
Bouteillenon enregistré
Serviceaucun déclaré

correspondances dans les bases sources

Autres enregistrements de gestionnaires de paquets

Les correspondances proviennent d’index externes de gestionnaires de paquets et restent séparées des liens de paquets Automic Vault locaux.

Debian apt95%

adr-tools 3.0.0-2

tools for working with a log of Architecture Decision Records

https://github.com/npryce/adr-tools

sudo apt install adr-tools
  • Section: devel
  • Architecture: all
  • normalized package name match
  • Correspondance par : Adr Tools
Debian stable package indexes · deb.debian.org · Debian stable package indexes: adr-tools from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

adr-tools

nix profile install nixpkgs#adr-tools
  • normalized package name match
  • Correspondance par : Adr Tools
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ad/adr-tools/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

adr-tools 3.0.0-2

tools for working with a log of Architecture Decision Records

https://github.com/npryce/adr-tools

sudo apt install adr-tools
  • Section: universe/devel
  • Architecture: all
  • normalized package name match
  • Correspondance par : Adr Tools
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: adr-tools from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz

graphe de paquets

Les liens viennent du graphe local de relations entre paquets, des suppléments, des dépendances, des correspondances d'écosystèmes et de l'appartenance aux hubs.

Même workflow

  • adr-toolsSame normalized package name exists in another local package ecosystem.

piste source

Généré depuis les données du dépôt

Cette page est servie par av-web depuis l'artéfact SQLite privé des paquets généré par scripts/generate-pkg-sqlite.py.

Sources utilisées

  • Geiger risk classifier
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • pkg.so package database
  • pkgdb category and tag curation