# oraios/serena

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

30,841 stars · 2,102 forks · Python

Topics: agent, ai, ai-coding, claude, claude-code, codex, ide, jetbrains

## Use it

### How to install serena in Claude Code

1. Clone & open

```bash
git clone https://github.com/oraios/serena.git
cd serena
claude
```

2. Let Claude read it

   Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.

### How to install serena in Claude Desktop

1. Clone the repository

```bash
git clone https://github.com/oraios/serena.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install serena in Cursor

1. Clone & open in Cursor

```bash
git clone https://github.com/oraios/serena.git
```

2. Index & chat

   Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.

### How to install serena in Codex CLI

1. Clone

```bash
git clone https://github.com/oraios/serena.git
```

2. Point Codex at it

   Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.

### How to install serena in Windsurf

1. Clone & open

```bash
git clone https://github.com/oraios/serena.git
```

2. Use Cascade

   Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.

### How to install serena in Cline

1. Clone the repository

```bash
git clone https://github.com/oraios/serena.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

### How to install serena in VS Code

1. Clone the repository

```bash
git clone https://github.com/oraios/serena.git
```

2. Open in your AI editor

   Open the folder in your assistant and ask it to index the codebase, then reference files in chat.

---

Source: https://mcp-skills-hub.vercel.app/repos/oraios-serena · MCP Skills Hub · data as of 2026-10-28T12:31:05Z