metomi · oliver-sanders · Feb 2, 2026
diff --git a/changes.d/2808.feat.md b/changes.d/2808.feat.md
@@ -0,0 +1,3 @@
+The `rose edit` GUI has been restored to Rose 2.
+
+It is available as the pip-package `metomi-rose[edit]` (you will need to ensure GTK3 and `cairo` are installed), or the conda-forge package `metomi-rose` (which includes all of the required system dependencies).
diff --git a/sphinx/installation.rst b/sphinx/installation.rst
@@ -46,6 +46,17 @@ With ``pip``::
    See the :ref:`Cylc installation instructions <cylc:installation>` for more
    information.
 
+PyGobject
+"""""""""
+
+.. _pygobject installation instructions: https://pygobject.gnome.org/getting_started.html#ubuntu-logo-ubuntu-debian-logo-debian
+
+The :ref:`command-rose-config-edit` GUI requires PyGObject and its dependencies
+(which include Cairo, GI and GTK) to be installed.
+
+These dependencies are included in the Conda package. If installing via uv/pip
+you will need to follow the `pygobject installation instructions`_.
+
 Git
 """
 
@@ -92,6 +103,7 @@ Rose with the ``graph`` optional dependency::
    hosting services such as GitHub. Note Git is not automatically installed
    by the metomi-rose conda.
 
+
 Configuring Rose
 ----------------
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		The `rose edit` GUI has been restored to Rose 2.

		It is available as the pip-package `metomi-rose[edit]` (you will need to ensure GTK3 and `cairo` are installed), or the conda-forge package `metomi-rose` (which includes all of the required system dependencies).