docs: Provide guidance on using direnv

docs/integration/editor/jetbrains.md

@@ -0,0 +1,17 @@
+[Jetbrains](https://www.jetbrains.com/ides/) has a suite of popular develop environments.
+
+To use `pixi` inside of a Jetbrains IDE, follow these steps:
+
+* Create a `pixi.toml` file.
+
+See [`direnv`](../third_party/direnv.md).
+* Install `direnv`.
+* Add an `.envrc` to the project.
+
+Use [`direnv`](../third_party/direnv.md) via a
+* Install the [Jetbrains `direnv` plugin](https://plugins.jetbrains.com/plugin/15285-direnv-integration)
+which can be used to activate `pixi`.
+
+Note: PyCharm belongs to the Jetbrains stable of IDE.
+Unless you are doing polyglot projects it is recommended that the `pixi shell` approach,
+[recommended here](pycharm.md) be used.

docs/integration/editor/neovim.md

@@ -0,0 +1,12 @@
+[Neovim](https://neovim.io/) is a popular develop environment.
+
+To use `pixi` with Neovim, follow these steps:
+
+* Create a `pixi.toml` file.
+
+See [`direnv`](../third_party/direnv.md).
+* Install `direnv`.
+* Add an `.envrc` to the project.
+
+Use a [Neovim Direnv](https://github.com/direnv/direnv.vim).
+* Install the `direnv` plugin.

docs/integration/editor/vscode.md

@@ -0,0 +1,12 @@
+[VSCode](https://code.visualstudio.com/) is a popular develop environment.
+
+To use `pixi` inside of VSCode, follow these steps:
+
+* Create a `pixi.toml` file.
+
+See [`direnv`](../third_party/direnv.md).
+* Install `direnv`.
+* Add an `.envrc` to the project.
+
+Use a [VSCode extension](https://marketplace.visualstudio.com/items?itemName=mkhl.direnv).
+* Install the `direnv` vscode extension

docs/integration/editor/zed.md

@@ -0,0 +1,11 @@
+[Zed](https://zed.dev/) is a relatively new develop environment.
+
+To use `pixi` inside of Zed, follow these steps:
+
+* Create a `pixi.toml` file.
+
+See [`direnv`](../third_party/direnv.md).
+* Install `direnv`.
+* Add an `.envrc` to the project.
+
+[Zed has native support for direnv](https://zed.dev/docs/configuring-zed#direnv-integration).

docs/integration/third_party/direnv.md

@@ -34,3 +34,14 @@ direnv: unloading
 $ which python
 python not found
 ```
+
+While `direnv` comes with [hooks for the common shells](https://direnv.net/docs/hook.html),
+these hooks into the shell should not be relied on when using and IDE.
+Although `direnv` package does not include hooks for integrated develop environments,
+there is typically a plugin or extension available.
+
+Here you can see how to set up `direnv` for some of the more popular IDEs:
+- [VSCode](../editor/vscode.md): [mkhl.direnv plugin](https://marketplace.visualstudio.com/items?itemName=mkhl.direnv)
+- [Jetbrains](../editor/jetbrains.md): [Direnv Integration plugin](https://plugins.jetbrains.com/plugin/15285-direnv-integration)
+- [Zed](../editor/zed.md): [Native support](https://zed.dev/docs/configuring-zed#direnv-integration)
+- [Neovim](../editor/neovim.md): [Direnv plugin](https://github.com/direnv/direnv.vim/blob/master/README.md)

mkdocs.yml

@@ -135,8 +135,12 @@ nav:
       - Editor:
           - JupyterLab: integration/editor/jupyterlab.md
           - PyCharm: integration/editor/pycharm.md
+          - Jetbrains: integration/editor/jetbrains.md
           - RStudio: integration/editor/r_studio.md
           - VSCode Devcontainer: integration/editor/devcontainer.md
+          - VSCode: integration/editor/vscode.md
+          - Zed: integration/editor/zed.md
+          - Neovim: integration/editor/neovim.md
       - Continuous Integration:
           - GitHub Actions: integration/ci/github_actions.md
           - Lockfile Updates: integration/ci/updates_github_actions.md
@@ -200,8 +204,12 @@ plugins:
         "features/pytorch.md": "python/pytorch.md"
         "ide_integration/jupyterlab.md": "integration/editor/jupyterlab.md"
         "ide_integration/pycharm.md": "integration/editor/pycharm.md"
+        "ide_integration/jetbrains.md": "integration/editor/jetbrains.md"
         "ide_integration/r_studio.md": "integration/editor/r_studio.md"
         "ide_integration/devcontainer.md": "integration/editor/devcontainer.md"
+        "ide_integration/vscode.md": "integration/editor/vscode.md"
+        "ide_integration/zed.md": "integration/editor/zed.md"
+        "ide_integration/neovim.md": "integration/editor/neovim.md"
         "advanced/authentication.md": "deployment/authentication.md"
         "advanced/channel_priority.md": "advanced/channel_logic.md"
         "advanced/github_actions.md": "integration/ci/github_actions.md"