Lutra — an otterly perfect IDE

Lutra

A fast, open-source, clean-room PHP IDE in the spirit of the PhpStorm workflow. Rust core, Vue interface, native on macOS, Windows and Linux.

Status: pre-alpha Core in Rust UI in Vue Runs on macOS, Windows and Linux MCP server for agents License: MIT OR Apache-2.0

> *Lutra* is the Latin name of the otter. Sea otters are among the few animals that use tools: > they crack shells open with a stone. Lutra is that stone for your PHP code. ## Why Lutra - **Familiar.** Project view, tool windows, Search Everywhere-style navigation, Go to Class, Find Usages, refactorings: the workflow PHP developers already know. - **Fast.** A Rust core with an incremental index, search off the UI thread and a lightweight Tauri shell. - **Robust.** No panics in shipped code, a crash-recovery journal for unsaved buffers, property-tested protocols. - **Open.** MIT OR Apache-2.0, no account, no telemetry. - **Agent-native.** Every action is a command that a JSON control channel and an MCP server expose, so Claude and other agents can work in the IDE the way a person does. - **PHP-first.** Symfony, Laravel, Shopware and WordPress support are on the roadmap from the start. ## Quick start > The foundation (M0) is built: `cargo xtask dev` opens an empty themed window and `cargo xtask ci` runs the quality gate. The `lutra` command below is the target of milestone M3. ```sh git clone lutra cd lutra cargo xtask dev # desktop app in development mode cargo xtask dev -- --control 7979 . # + JSON control channel cargo xtask ci # fmt, clippy, tests, layers, assets, clean-room, frontend checks ``` ### The `lutra` command ```sh lutra . # open the current folder as a project lutra src/Kernel.php:42 # open a file at a line lutra diff a.php b.php # open the diff viewer lutra --wait FILE # wait until the tab is closed (git config core.editor "lutra --wait") lutra mcp # MCP server on stdio lutra perf # check the performance budgets ``` ### Use it from Claude Code ```sh claude mcp add lutra -- lutra mcp ``` ## Status **Pre-alpha (2026-10-16): M1 in progress.** You can open a folder, browse it in the project tree with live updates from disk, and edit and save files in tabs (plain text for now), with every command in a palette (`Mod+Shift+P`); unsaved text survives a crash and is offered back on the next open; syntax highlighting and PHP features come next. The MVP (M1–M3) is estimated at about 20 agent hours after calibrating on the first cycle (2.5 h done). [**ROADMAP.md**](ROADMAP.md) has the stage and what's next, [`docs/target-app-parity.md`](docs/target-app-parity.md) the parity assessment and [`docs/gaps.md`](docs/gaps.md) the ranked work list. **First target (MVP, M1–M3):** open a project, project tree, tabs, editor with highlighting, find in files, go to definition, completion and diagnostics via a language server, command palette, integrated terminal, the `lutra` CLI, light and dark themes. Agent and contributor rules (clean-room, asset policy, no panics, quality gates) are in [`AGENTS.md`](AGENTS.md). Every bundled asset is listed with its licence in [`ASSETS.md`](ASSETS.md). ## License Lutra is dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option. Copyright (c) 2026 Daniel Diekert and the Lutra contributors. Required notices are in [NOTICE](NOTICE). PhpStorm, IntelliJ IDEA and JetBrains are trademarks or registered trademarks of JetBrains s.r.o. Lutra is an independent, open-source project and is not affiliated with, sponsored by or endorsed by JetBrains s.r.o.; these names are used only to describe the workflows it is compatible with.