Serena MCP: the IDE for your agent

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

io.github.oraios/serena · Repository · version 1.5.3 · 28k stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx serena-agent

Results by platform

Linux

needs configuration2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading tiktoken (1.1MiB)
Downloading cryptography (4.3MiB)
Downloading pydantic-core (2.0MiB)
Downloading pillow (6.6MiB)
   Building proxy-tools==0.1.0
 Downloaded tiktoken
 Downloaded pydantic-core
      Built proxy-tools==0.1.0
 Downloaded pillow
 Downloaded cryptography
Installed 70 packages in 52ms
Usage: serena-agent [OPTIONS] COMMAND [ARGS]...

  Main serena CLI commands. Note that you also have access to `serena-hooks`
  CLI commands which are kept under that separate entrypoint for performance
  reasons, see `serena-hooks --help`. You can run `<command> --help` for more
  info on each command.

Options:
  -V, --version  Show the version and exit.
  --help         Show this message and exit.

Commands:
  config                Manage Serena configuration.
  context               Manage Serena contexts.
  dashboard-viewer      Open the Serena dashboard viewer for a given URL.
  init                  Initialize Serena by creating a global config...
  memories              Inspect, read, write, and validate Serena memories.
  mode                  Manage Serena modes.
  print-system-prompt   Print the system prompt for a project.
  project               Manage Serena projects.
  prompts               Commands related to Serena's prompts that are...
  setup                 Set up Serena for use with a specific client by...
  start-mcp-server      Starts the Serena MCP server.
  start-project-server  Starts the Serena project server, which exposes...
  tools                 Commands related to Serena's tools.

macOS

needs configuration2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pydantic-core (1.8MiB)
Downloading cryptography (6.8MiB)
Downloading pyobjc-core (6.1MiB)
Downloading pillow (4.6MiB)
   Building proxy-tools==0.1.0
      Built proxy-tools==0.1.0
 Downloaded pydantic-core
 Downloaded cryptography
 Downloaded pillow
   Building pyyaml==6.0.2
 Downloaded pyobjc-core
      Built pyyaml==6.0.2
Installed 74 packages in 291ms
/Users/runner/.cache/uv/archive-v0/Pzn7Zh_SmWE687z6/lib/python3.14/site-packages/anthropic/_compat.py:48: UserWarning: Core Pydantic V1 functionality isn't compatible with Python 3.14 or greater.
  from pydantic.v1.typing import (
Usage: serena-agent [OPTIONS] COMMAND [ARGS]...

  Main serena CLI commands. Note that you also have access to `serena-hooks`
  CLI commands which are kept under that separate entrypoint for performance
  reasons, see `serena-hooks --help`. You can run `<command> --help` for more
  info on each command.

Options:
  -V, --version  Show the version and exit.
  --help         Show this message and exit.

Commands:
  config                Manage Serena configuration.
  context               Manage Serena contexts.
  dashboard-viewer      Open the Serena dashboard viewer for a given URL.
  init                  Initialize Serena by creating a global config...
  memories              Inspect, read, write, and validate Serena memories.
  mode                  Manage Serena modes.
  print-system-prompt   Print the system prompt for a project.
  project               Manage Serena projects.
  prompts               Commands related to Serena's prompts that are...
  setup                 Set up Serena for use with a specific client by...
  start-mcp-server      Starts the Serena MCP server.
  start-project-server  Starts the Serena project server, which exposes...
  tools                 Commands related to Serena's tools.

Windows

needs configuration2026-08-16 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading pydantic-core (1.9MiB)
Downloading pythonnet (1.6MiB)
Downloading pywin32 (6.6MiB)
Downloading pillow (6.9MiB)
Downloading cryptography (3.3MiB)
   Building proxy-tools==0.1.0
      Built proxy-tools==0.1.0
 Downloaded pydantic-core
 Downloaded cryptography
 Downloaded pythonnet
 Downloaded pillow
 Downloaded pywin32
Installed 73 packages in 16.90s
Usage: serena-agent [OPTIONS] COMMAND [ARGS]...

  Main serena CLI commands. Note that you also have access to `serena-hooks`
  CLI commands which are kept under that separate entrypoint for performance
  reasons, see `serena-hooks --help`. You can run `<command> --help` for more
  info on each command.

Options:
  -V, --version  Show the version and exit.
  --help         Show this message and exit.

Commands:
  config                Manage Serena configuration.
  context               Manage Serena contexts.
  dashboard-viewer      Open the Serena dashboard viewer for a given URL.
  init                  Initialize Serena by creating a global config...
  memories              Inspect, read, write, and validate Serena memories.
  mode                  Manage Serena modes.
  print-system-prompt   Print the system prompt for a project.
  project               Manage Serena projects.
  prompts               Commands related to Serena's prompts that are...
  setup                 Set up Serena for use with a specific client by...
  start-mcp-server      Starts the Serena MCP server.
  start-project-server  Starts the Serena project server, which exposes...
  tools                 Commands related to Serena's tools.

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.oraios__serena.json)](https://doesitinstall.com/s/io.github.oraios__serena.html)