Lutra - The Otterly perfect IDE
Find a file
danny 33a7185d75
Some checks are pending
ci / ci (macos-15) (push) Waiting to run
ci / ci (ubuntu-24.04) (push) Waiting to run
ci / ci (windows-2025) (push) Waiting to run
F1: cosmetics: regex error reason, one date format, Close Tab
- Find shows a bad regex as "invalid pattern: unclosed group": the search
  crate keeps only the parser's reason, the UI drops the invalid-params
  prefix (userMessage).
- Dates read YYYY-MM-DD / YYYY-MM-DD HH:mm in local time everywhere
  (i18n formatDate/formatDateTime): Log, stash list, blame, recovery.
- buffer.close is "Close Tab" in the palette as in the menu; an engine test
  keeps palette labels starting with their menu item's wording.
- Docs: architecture, install (Jump List), localization parity, checklist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 19:31:43 +01: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 F1: the uninstaller keeps the Jump List of com.tyrveil.lutra 2026-11-02 19:07:25 +01:00
assets B1: alpha installers (NSIS, DMG), identifier com.tyrveil.lutra with data migration 2026-10-31 21:48:15 +01:00
contributors contributors/people.toml aktualisiert 2026-10-14 21:10:30 +02:00
crates F1: cosmetics: regex error reason, one date format, Close Tab 2026-11-02 19:31:43 +01:00
docs F1: cosmetics: regex error reason, one date format, Close Tab 2026-11-02 19:31:43 +01:00
ui F1: cosmetics: regex error reason, one date format, Close Tab 2026-11-02 19:31:43 +01:00
xtask C2: lutra CLI in the setup with optional PATH entry, xtask bundle prints the version 2026-11-01 12:46:49 +01:00
.gitattributes M0.1: Cargo workspace with layered crates 2026-10-13 20:24:06 +02:00
.gitignore M1.14: app icon and README banner 2026-10-16 17:00:48 +02:00
AGENTS.md M1.2: native file watching via notify 2026-10-14 19:43:15 +02:00
ASSETS.md B1: alpha installers (NSIS, DMG), identifier com.tyrveil.lutra with data migration 2026-10-31 21:48:15 +01:00
Cargo.lock F1: lutra starts the desktop without passing on any handle 2026-11-02 19:04:54 +01:00
Cargo.toml B2: setup finish without hang, Open with for PHP files, 0.1.0-alpha 2026-10-31 22:37:56 +01: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 B2: setup finish without hang, Open with for PHP files, 0.1.0-alpha 2026-10-31 22:37:56 +01:00
README.md B1: alpha installers (NSIS, DMG), identifier com.tyrveil.lutra with data migration 2026-10-31 21:48:15 +01:00
ROADMAP.md PM: C6 review, M4 done, Git 16%, depth ~6.4% 2026-10-30 18:16:50 +01:00

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.

Install

The alpha comes as an unsigned installer: a per-user setup (.exe, English and German) for Windows and a .dmg for macOS on Apple Silicon. Build it with cargo xtask bundle on that platform. Windows SmartScreen and macOS Gatekeeper warn on the first start because it is not signed yet; docs/install.md shows how to start it anyway, how to uninstall and where your data lives. On Linux, build from source as below.

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

Works today (M3.7): opening folders and files (at a line) in the running Lutra or starting it, and --wait. The rest arrives with M3 and later.

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-22): M3 done, the MVP is feature-complete. You can open a folder, browse it in the project tree with live updates from disk, and edit and save files in tabs with syntax highlighting for PHP (and HTML, CSS, JS/TS, JSON, YAML, Markdown), with every command in a palette (Mod+Shift+P) and settings and the light or dark theme in a settings dialog (Mod+,); unsaved text survives a crash and is offered back on the next open; M2 added find in files (Mod+Alt+F) and go to file, class or symbol (Mod+P, Mod+Alt+C, Mod+T); M3 added an integrated terminal (Mod+Shift+T) and PHP language features from Phpactor: errors underlined as you type (Problems tab Mod+Alt+P), code completion, documentation on hover and parameter info, go to definition (F12 or Ctrl+click), find references (Shift+F12) and rename (F2), plus the lutra CLI, an MCP server (lutra mcp), an app menu and autosave. Git (M4) has started: a Changes tab (Mod+Alt+Shift+G) stages files and commits them, the gutter marks changed lines, and a side-by-side diff (Mod+Alt+Shift+D) shows each change, on the way to alpha. 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.