Lutra - The Otterly perfect IDE
Find a file
danny f1976c7d67 M1.3: engine workspace, file and buffer commands, event stream
State holds the open project (VFS project, watcher, watched directories)
and versioned buffers. New commands: project.open/close/children,
file.open/save/saveAll, buffer.get/edit/close. buffer.edit takes UTF-16
change sets based on a version and fails with the new stale_version code;
closing dirty buffers or projects without force fails with
unsaved_changes. Commands queue events (projectOpened, treeChanged,
bufferChanged, dirtyChanged, fileChangedOnDisk, ...) that the engine
returns in Outcome.events; Engine::pump_vfs maps changes on disk to
events and reloads clean buffers. project.children watches listed
directories, capped at 256 native / 32 polling, least recently listed
dropped first.

Control channel: events.subscribe streams {"event": ...} lines, with
bounded per-subscriber queues (lutra_control::Subscribers) and method docs
in methods.rs. testkit's EngineBackend and the desktop Host implement the
new Backend::subscribe. Verified with 14 engine integration tests, a TCP
events test and the running app over the control channel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-14 20:24:44 +02:00
.cargo M0.1: Cargo workspace with layered crates 2026-10-13 20:24:06 +02:00
.claude/agents DESIGN: add Katharina agent definition 2026-10-14 19:21:21 +02:00
.github/workflows M0.8: CI workflow running cargo xtask ci on macOS, Windows and Linux 2026-10-14 18:40:17 +02:00
apps M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
assets M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
contributors M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
crates M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
docs M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
ui M1.5: main window layout and project tree against mocked engine events 2026-10-14 19:24:23 +02:00
xtask M0.6: allow Unicode-3.0 (owner decision) 2026-10-14 06:44:52 +02:00
.gitattributes M0.1: Cargo workspace with layered crates 2026-10-13 20:24:06 +02:00
.gitignore M0.5: Tauri desktop shell with themed main window 2026-10-14 18:39:49 +02:00
AGENTS.md M1.2: native file watching via notify 2026-10-14 19:43:15 +02:00
ASSETS.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
Cargo.lock M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
Cargo.toml PM: merge M1.2 vfs with notify watching 2026-10-14 20:03:25 +02:00
CLAUDE.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
clippy.toml M0.2: workspace lints and lints self-test 2026-10-13 20:28:04 +02:00
deny.toml M1.2: native file watching via notify 2026-10-14 19:43:15 +02:00
LICENSE-APACHE M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
LICENSE-MIT M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
NOTICE PM: merge M1.5 UI shell and project tree 2026-10-14 20:03:34 +02:00
README.md M0.9: first estimates for M1-M3 and full parity 2026-10-14 18:41:49 +02:00
ROADMAP.md M0.9: first estimates for M1-M3 and full parity 2026-10-14 18:41:49 +02:00

🦦 Lutra

An otterly perfect IDE.

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.

git clone <repo-url> 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

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

claude mcp add lutra -- lutra mcp

Status

Pre-alpha (2026-10-14): foundation done. No PHP feature ships yet; the MVP (M1–M3) is estimated at about 190 agent hours. ROADMAP.md has the stage and what's next, docs/target-app-parity.md the parity assessment and 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. Every bundled asset is listed with its licence in ASSETS.md.

License

Lutra is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 Daniel Diekert and the Lutra contributors. Required notices are in 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.