From 0476b3a34e2f5a815b26b45883568a6184e6815a Mon Sep 17 00:00:00 2001
From: Shelly David <59293978+shellydavid@users.noreply.github.com>
Date: Fri, 12 Sep 2025 18:22:37 -0400
Subject: [PATCH] poetry-self: add page (#18037)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
Co-authored-by: Dylan <145150333+dmmqz@users.noreply.github.com>
---
 pages/common/poetry-self.md | 38 +++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 pages/common/poetry-self.md

diff --git a/pages/common/poetry-self.md b/pages/common/poetry-self.md
new file mode 100644
index 0000000000..c568826edc
--- /dev/null
+++ b/pages/common/poetry-self.md
@@ -0,0 +1,38 @@
+# poetry-self
+
+> Manage the Poetry installation/runtime environment itself.
+> These commands reference `pyproject.toml` and `poetry.lock` files in your Poetry configuration directory.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#self>.
+
+- Install a package:
+
+`poetry self add {{package_name}}`
+
+- Install dependencies from the Poetry installation's `pyproject.toml` file:
+
+`poetry self install`
+
+- Lock dependencies from the Poetry installation's `pyproject.toml` file:
+
+`poetry self lock`
+
+- Remove a package:
+
+`poetry self remove {{package_name}}`
+
+- List all installed packages:
+
+`poetry self show`
+
+- List all installed plugins:
+
+`poetry self show plugins`
+
+- Sync the runtime environment with the Poetry installation's `poetry.lock` file:
+
+`poetry self sync`
+
+- Update dependencies from the Poetry installation's `pyproject.toml` file:
+
+`poetry self update`