From e716da236f1ea951501cb69fbec177f49ebf8af9 Mon Sep 17 00:00:00 2001
From: Girdhar Agrawal <girdharagrawalbro@gmail.com>
Date: Thu, 16 Oct 2025 23:01:57 +0530
Subject: [PATCH] poetry-shell: add page

---
 pages/common/poetry-shell.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 pages/common/poetry-shell.md

diff --git a/pages/common/poetry-shell.md b/pages/common/poetry-shell.md
new file mode 100644
index 00000000000000..a9bd9c92bc666a
--- /dev/null
+++ b/pages/common/poetry-shell.md
@@ -0,0 +1,12 @@
+# poetry shell
+
+> Spawn a shell within the Poetry virtual environment.
+> More information: <https://python-poetry.org/docs/cli/#shell>.
+
+- Spawn a new shell within the project's virtual environment:
+
+`poetry shell`
+
+- Exit the spawned shell and deactivate the virtual environment:
+
+`exit`