diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 65c411adc..a81c64251 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -5,24 +5,33 @@ to develop a fix, we recommend you open an issue before starting.
 
 ## Prerequisites
 
-*goose* uses [uv][uv] for dependency management, and formats with [ruff][ruff].
-
 We provide a shortcut to standard commands using [just][just] in our `justfile`.
 
-## Developing
+* *goose* uses [uv][uv] for dependency management, and formats with [ruff][ruff] - install UV first: https://pypi.org/project/uv/ 
+* clone both this repository as well as https://github.com/square/exchange next to it. 
+
+## Developing and testing
 
 Now that you have a local environment, you can make edits and run our tests. 
 
-```
+```sh
 uv run pytest tests -m "not integration"
 ```
 
 or, as a shortcut, 
 
-```
+```sh
 just test
 ```
 
+## Running goose from source
+
+`uv run goose session start`
+
+will run a fresh goose session (can use the usual goose commands with `uv run` prefixed)
+
+
+
 ## Evaluations
 
 Given that so much of *goose* involves interactions with LLMs, our unit tests only go so far to
diff --git a/README.md b/README.md
index 11350f741..8bd87f2cf 100644
--- a/README.md
+++ b/README.md
@@ -80,7 +80,7 @@ pipx ensurepath
 Then you can install goose with 
 
 ``` sh
-pipx install goose
+pipx install goose-ai
 ```
 
 ### Config
@@ -164,5 +164,7 @@ This requires `DATABRICKS_HOST` and `DATABRICKS_TOKEN` to be set accordingly
 Yes, goose is open source and always will be. goose is released under the ASL2.0 license meaning you can use it however you like. 
 See LICENSE.md for more details.
 
+To run goose from source, please see `CONTRIBUTING.md` for instructions on how to set up your environment and you can then run `uv run goose session start`.
+
 
 [pipx]: https://github.com/pypa/pipx?tab=readme-ov-file#install-pipx