add list-installed-packages (#838)

docs/guides/index.md

@@ -4,16 +4,17 @@ sidebar_position: 100
 
 # Guides
 
-- [Update packages by Renovate](/docs/guides/renovate)
-- [Enable Checksum Verification](/docs/guides/checksum)
-- [Policy as Code](/docs/guides/policy-as-code)
-- [Share aqua configuration for teams and organizations](/docs/guides/team-config)
-- [Keep configuration files in one directory](/docs/guides/keep-in-one-dir)
-- [Split the list of packages](/docs/guides/split-config)
-- [Update registries and packages by update command](/docs/guides/update-command)
-- [Install private packages](/docs/guides/private-package)
-- [Uninstall Packages](/docs/guides/uninstall-packages)
-- [Filter packages with tags](/docs/guides/package-tag)
-- [Install Standard Registry's all packages very quickly](/docs/guides/install-all-packages)
-- [Build Container (Docker) Image](/docs/guides/build-container-image)
-- [Wrap aqua with task runner such as GNU Make](/docs/guides/wrap-aqua-with-task-runner)
+- [Update packages by Renovate](renovate.md)
+- [List installed packages](list-installed-packages.md)
+- [Enable Checksum Verification](checksum.md)
+- [Policy as Code](policy-as-code.md)
+- [Share aqua configuration for teams and organizations](team-config.md)
+- [Keep configuration files in one directory](keep-in-one-dir.md)
+- [Split the list of packages](split-config.md)
+- [Update registries and packages by update command](update-command.md)
+- [Install private packages](private-package.md)
+- [Uninstall Packages](uninstall-packages.md)
+- [Filter packages with tags](package-tag.md)
+- [Install Standard Registry's all packages very quickly](install-all-packages.md)
+- [Build Container (Docker) Image](build-container-image.md)
+- [Wrap aqua with task runner such as GNU Make](wrap-aqua-with-task-runner.md)

docs/guides/list-installed-packages.md

@@ -0,0 +1,28 @@
+---
+sidebar_position: 5
+---
+
+# List installed packages
+
+aqua >= v2.24.0 [#2709](https://github.com/orgs/aquaproj/discussions/2709) [#2733](https://github.com/aquaproj/aqua/pull/2733)
+
+The command `aqua list -installed` outputs installed packages.
+
+```console
+$ aqua list -installed
+rhysd/actionlint	v1.6.27	standard
+suzuki-shunsuke/cmdx	v1.7.4	standard
+sigstore/cosign	v1.13.2	standard
+suzuki-shunsuke/ghalint	v0.2.9	standard
+int128/ghcp	v1.13.2	standard
+golangci/golangci-lint	v1.56.2	standard
+goreleaser/goreleaser	v1.24.0	standard
+reviewdog/reviewdog	v0.17.1	standard
+```
+
+By default, global configuration files are ignored.
+To output packages in global configuration files too, please set the option `-all [-a]`.
+
+```console
+$ aqua list -a -installed
+```

docusaurus.config.js

@@ -43,14 +43,14 @@ const config = {
   themeConfig:
     /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
     ({
-      // announcementBar: {
-      //   id: 'uninstall_package',
-      //   content:
-      //     '<a href="/docs/install#winget">Winget Support (2023-11-21)</a>',
-      //   backgroundColor: '#7FFF00',
-      //   textColor: '#091E42',
-      //   isCloseable: true,
-      // },
+      announcementBar: {
+        id: 'list_installed_packages',
+        content:
+          '<a href="/docs/guides/list-installed-packages">List installed packages (2024-03-10)</a>',
+        backgroundColor: '#7FFF00',
+        textColor: '#091E42',
+        isCloseable: true,
+      },
       navbar: {
         title: 'aqua',
         logo: {