The built-in editor supports Rust, Go, JavaScript/TypeScript (including JSX/TSX), Python, C/C++, HTML, CSS, JSON, YAML, Bash, and Swift through language servers. Completion, hover, definitions, and diagnostics are available where the selected server supports them. Other bundled languages retain syntax highlighting and plain editing. Review syntax highlighting is bundled independently and works without installing or enabling a language server.
Completion labels highlight the typed characters in order, including non-contiguous matches such as fl in file_loader. This changes label highlighting only; completion filtering and application stay the same.
Open a supported file and click the language indicator in the editor footer to Trust checkout. Trust lasts for this editor workspace's lifetime. It permits language servers to consult project configuration and tools; installing a server does not grant trust.
Devcroft uses your configured executable first, then its managed installation, then a system executable. When no server is available, an inline offer provides Install, Use existing, and Not now. Dismissals last for the workspace lifetime. Nothing downloads merely because a repository contains a language.
Manage support at Settings → Editor → Language servers, or click the editor footer. Each card shows its source and managed version. An installed server with its required runtime has an enable switch; missing servers show Install. Open Advanced settings to select an absolute server executable, Node/Go runtime where applicable, and optional server settings as a JSON object. The editor's dialog also supports a project-root override within the checkout. Invalid explicit paths produce an error rather than silently selecting another server. Settings are device-local.
Executable discovery uses the desktop PATH, ~/.local/bin, ~/.cargo/bin, ~/go/bin, mise shims, and Volta's bin directory; macOS also checks Homebrew locations. It does not invoke a login shell. Executables must resolve outside the checkout. A runtime override helps when a GUI environment cannot find Node or Go.
| Languages | Pinned managed server | Prerequisites |
|---|---|---|
| Rust | rust-analyzer 2026-09-28 | curl for acquisition; project's Rust toolchain for analysis |
| Go | gopls 0.23.0 | Go compatible with this gopls release, both to install and analyze |
| JavaScript, JSX, TypeScript, TSX | typescript-language-server 6.0.1 with TypeScript 6.0.3 | Node 22.22.2 or newer and npm |
| Python, Python stubs | basedpyright 1.40.2 | Node and npm for the managed package; project Python environment/dependencies for analysis |
| C, C++, headers | clangd 23.1.0 | curl and unzip for acquisition; project compiler flags and SDK for analysis |
| HTML | vscode-html-language-server, vscode-langservers-extracted 4.10.0 | Node and npm |
| CSS | vscode-css-language-server, vscode-langservers-extracted 4.10.0 | Node and npm |
| JSON | vscode-json-language-server, vscode-langservers-extracted 4.10.0 | Node and npm |
| YAML | yaml-language-server 2.0.0 | Node 22.13.0 or newer and npm |
Bash (.sh, .bash) |
bash-language-server 5.8.1 | Node 20 or newer and npm; optional ShellCheck for linting, shfmt for formatting |
| Swift, Swift interfaces | sourcekit-lsp from your toolchain (no managed download) | Xcode or a Swift toolchain from swift.org |
Servers and caches live under the device data directory's language-servers/, outside portable sync. Installations use a neutral staging directory and never add project dependencies or global npm packages. Rust and clangd downloads use pinned SHA-256 checksums; npm uses shipped integrity lockfiles with lifecycle scripts disabled; Go uses a pinned module version and the public checksum database. Installs have bounded output/time and can be cancelled. The HTML, CSS, and JSON recipes use separate installations of the same upstream distribution so each card can be managed independently.
Swift uses the sourcekit-lsp executable shipped with your toolchain. When it is missing, Set up Swift explains how to install a toolchain and select its executable. Devcroft does not download or manage Xcode/Swift toolchains.
Check for updates installs the version bundled with Devcroft's catalog, not an arbitrary latest upstream release. Updates retain the previous selection for Restore previous version. Running sessions keep their current version until restart. Uninstall affects managed packages only and refuses versions still used by a running server; disable the server and close its workspaces first. Maintenance actions and installation logs appear in Advanced settings. Missing prerequisites and installation failures remain retryable there.
Instances are scoped to a checkout, server, and language root. Related tabs share a server, including inactive unsaved buffers. Independent projects can have separate servers, and one language's failure does not stop another.
Root selection recognizes Cargo workspace members/exclusions, Go modules and go.work members, package.json workspaces, and Python project markers. C/C++ recognizes compile_commands.json, compile_flags.txt, .clangd, and CMakeLists.txt; HTML/CSS use the nearest package.json. Swift recognizes Package.swift and compile_commands.json. JSON, YAML, and Bash use the checkout root. It never crosses the checkout boundary. Use the root override for layouts the detector does not recognize, including workspace formats not represented in package.json. Python environment and TypeScript SDK choices can be supplied through the server's settings. Configuration changes restart affected instances; explicit package updates wait for deliberate restart.
For accurate C/C++ results, generate compile_commands.json or supply compile_flags.txt / .clangd for your build. Clangd retains its bundled resource headers, but project libraries and platform SDKs must already exist. JSON schemas can be supplied through json.schemas; YAML schemas through yaml.schemas in Advanced settings. These improve validation, hover descriptions, and completion for configuration files.
YAML's remote schema and Kubernetes CRD catalogs are disabled by default so configuration does not delay editing on slow/offline connections. Enable yaml.schemaStore.enable or yaml.kubernetesCRDStore.enable in server settings to opt in. Explicit local or URL schema associations remain available.
SwiftPM projects should be built for full cross-module analysis; SourceKit-LSP does not automatically build dependencies. Xcode project layouts may need an external build-server configuration or a project-root override. See the SourceKit-LSP setup guide for toolchain details.
Use … → Restart language server to restart support for the active file's root. All matching open drafts are replayed. Repeated crashes use bounded retry delays and stop after three attempts; failed initial startup requires a restart or corrected settings. Unused instances stop after approximately one minute. Closing the workspace releases its processes and package leases.
Native file watching sends project changes to running servers, including changes outside open buffers. Generated dependency/build directories (node_modules, target, .venv, __pycache__) and .git are excluded. Notifications are batched, with a bounded event buffer. Recursive OS watches may still consume resources for excluded directories; OS watch-limit failures or event-buffer overflow remain visible until restart. Watcher failures are reported as server errors; restart after external changes if watching is unavailable. Changes to workspace membership/root layout may require reopening the file or restarting support.
Rust defaults keep check-on-save, build-script analysis, and proc macros disabled. Explicit server settings may override these defaults after checkout trust. Toolchains, package dependencies, interpreters, and SDKs remain the user's responsibility.
The client advertises UTF-16 positions, handles full or whole-document incremental sync, and cancels stale document requests. Old session generations and wrong document versions are rejected. Unversioned diagnostics are best-effort because freshness cannot be proven.
Completion applies a single plain-text edit. Numeric snippet tab stops, defaults, mirrors, and choices are expanded into ordinary text; interactive tab-stop navigation is not implemented. Suggestions requiring unsupported snippet variables/transformations or extra edits (such as auto-imports) are excluded. Definitions stay within the checkout and preserve Back/Forward history. Refactoring, arbitrary workspace edits, references, document symbols, pull diagnostics, and dynamic registration are not implemented. Server-specific progress/indexing is not yet displayed.
The original four managed recipes have passed real-server installation, initialization, completion, hover, definition, and pushed syntax-diagnostic checks on macOS arm64. Deterministic tests cover protocol behavior, language routing, roots, session generations, preferences, receipts, cancellation, and leases. Linux and Windows runtime validation remains open. Managed Rust assets are provided for macOS arm64/x86_64 and Linux GNU arm64/x86_64. Managed clangd assets are provided for macOS arm64/x86_64 and Linux x86_64; other platforms require an existing clangd executable. Windows drive URI normalization is tested; UNC/network paths are unsupported.
The new C/C++, HTML, CSS, JSON, YAML, and Bash recipes passed managed installation, initialization, hover, and completion checks on macOS arm64. C/C++, CSS, JSON, and YAML also passed pushed diagnostics; C/C++ passed definitions. Swift passed initialization, hover, definitions, completion, and pushed diagnostics using the installed SourceKit-LSP toolchain. Bash diagnostics require a working ShellCheck installation and were not exercised on this machine. Review highlighting for all eight languages passed additions/deletions in both themes and native visual verification of added lines.
mise exec -- cargo test --locked editor:: -- --test-threads=1
mise exec -- cargo test --locked data:: -- --test-threads=1
# Opt-in: downloads pinned packages into a disposable directory.
mise exec -- cargo test --locked managed_servers_live_smoke -- --ignored --nocapture --test-threads=1
# New servers; also needs an installed Swift toolchain.
mise exec -- cargo test --locked common_servers_live_smoke -- --ignored --nocapture --test-threads=1
mise exec -- cargo clippy --locked --all-targets -- -D warnings