From 6faf12b9fa7d0ef158aa7c2f00d3432ba6864c31 Mon Sep 17 00:00:00 2001 From: Dominik Jain Date: Wed, 1 Apr 2026 15:17:47 +0200 Subject: [PATCH] Update uvx run instructions to include Python version (3.13) uvx ignores not only the lock file but also the Python version specified in pyproject.toml. https://github.com/astral-sh/uv/issues/8206#issuecomment-4113536371 --- README.md | 2 +- docs/02-usage/020_running.md | 6 +++--- docs/02-usage/030_clients.md | 4 ++-- docs/02-usage/040_workflow.md | 4 ++-- docs/03-special-guides/serena_on_chatgpt.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index d4fa11ed..2fadd208 100644 --- a/README.md +++ b/README.md @@ -106,7 +106,7 @@ See our [documentation page](https://oraios.github.io/serena/02-usage/025_jetbra Issue this command to see available options: ```bash -uvx --from git+https://github.com/oraios/serena serena start-mcp-server --help +uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --help ``` **Configuring Your Client**. To connect Serena to your preferred MCP client, you typically need to [configure a launch command in your client](https://oraios.github.io/serena/02-usage/030_clients.html). diff --git a/docs/02-usage/020_running.md b/docs/02-usage/020_running.md index 5766a987..4e2ca372 100644 --- a/docs/02-usage/020_running.md +++ b/docs/02-usage/020_running.md @@ -21,7 +21,7 @@ In general, to get help, append `--help` to the command, i.e. `uvx` is part of `uv`. It can be used to run the latest version of Serena directly from the repository, without an explicit local installation. - uvx --from git+https://github.com/oraios/serena serena + uvx -p 3.13 --from git+https://github.com/oraios/serena serena Explore the CLI to see some of the customization options that serena provides (more info on them below). @@ -124,7 +124,7 @@ case, you can simply run the `start-mcp-server` command without any additional o For example, to run the server in stdio mode via `uvx`, you would run: - uvx --from git+https://github.com/oraios/serena serena start-mcp-server + uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server See the section ["Configuring Your MCP Client"](030_clients) for specific information on how to configure your MCP client (e.g. Claude Code, Codex, Cursor, etc.) to use such a launch command. @@ -143,7 +143,7 @@ via the `--port` option. For example, to run the Serena MCP server in streamable HTTP mode on port 9121 using uvx, you would run - uvx --from git+https://github.com/oraios/serena serena start-mcp-server --transport streamable-http --port 9121 + uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --transport streamable-http --port 9121 and then configure your client to connect to `http://localhost:9121/mcp`. diff --git a/docs/02-usage/030_clients.md b/docs/02-usage/030_clients.md index bcb91e57..e0c13e73 100644 --- a/docs/02-usage/030_clients.md +++ b/docs/02-usage/030_clients.md @@ -79,7 +79,7 @@ Serena is a great way to make Claude Code both cheaper and more powerful! use this command: ```shell -claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context claude-code --project "$(pwd)" +claude mcp add serena -- uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context claude-code --project "$(pwd)" ``` Note: @@ -92,7 +92,7 @@ Note: **Global Configuration**. Alternatively, use `--project-from-cwd` for user-level configuration that works across all projects: ```shell -claude mcp add --scope user serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context=claude-code --project-from-cwd +claude mcp add --scope user serena -- uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --context=claude-code --project-from-cwd ``` Whenever you start Claude Code, Serena will search up from the current directory for `.serena/project.yml` or `.git` markers, diff --git a/docs/02-usage/040_workflow.md b/docs/02-usage/040_workflow.md index f8b3603f..380009c5 100644 --- a/docs/02-usage/040_workflow.md +++ b/docs/02-usage/040_workflow.md @@ -29,7 +29,7 @@ To explicitly create a project, use the following command while in the project d For instance, when using `uvx`, run - uvx --from git+https://github.com/oraios/serena serena project create [options] + uvx -p 3.13 --from git+https://github.com/oraios/serena serena project create [options] * For an empty project, you will need to specify the programming language (e.g., `--language python`). @@ -201,7 +201,7 @@ Depending on the language backend being used, the management of resources for th where `` is your way of running Serena. For example, when using `uvx`, run - uvx --from git+https://github.com/oraios/serena serena start-project-server + uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-project-server ### Multiple Agents Accessing a Single Serena Instance diff --git a/docs/03-special-guides/serena_on_chatgpt.md b/docs/03-special-guides/serena_on_chatgpt.md index ec872696..d5b640ba 100644 --- a/docs/03-special-guides/serena_on_chatgpt.md +++ b/docs/03-special-guides/serena_on_chatgpt.md @@ -17,7 +17,7 @@ Run the following command to launch Serena as http server (assuming port 8000): ```bash uvx mcpo --port 8000 --api-key -- \ - uvx --from git+https://github.com/oraios/serena \ + uvx -p 3.13 --from git+https://github.com/oraios/serena \ serena start-mcp-server --context chatgpt --project $(pwd) ``` @@ -28,7 +28,7 @@ You can also use other options, and you don't have to pass `--project` if you wa or want to activate it later. See ```shell -uvx --from git+https://github.com/oraios/serena serena start-mcp-server --help +uvx -p 3.13 --from git+https://github.com/oraios/serena serena start-mcp-server --help ``` ---