sayanarijit/xplr
55.4
Adequate · 14 November 2026
10.8k
lines of production code
Rust
with Lua
5
measurements over time
What this system is
xplr is a terminal-based file explorer written in Rust that uses Lua for configuration and scripting. It provides a command-line interface with support for null-byte delimited input and pipe messaging, enabling integration with other tools. The system features native fuzzy search, parallel directory traversal for performance, and a structured message-passing architecture for handling user interactions and internal state.
Features
Add desktop entry and application icon for xplr
The xplr application now includes a desktop entry file (xplr.desktop) and an SVG icon (xplr.svg), enabling proper integration with desktop environments. Users will see the application listed in their system menus with the correct name, comment, and icon, and it will be associated with directory MIME types.
assets · high confidence
Add example runner script
A new example file (examples/run.rs) has been added to demonstrate how to invoke the xplr runner API. This script initializes the runner, executes it, and handles the output or errors by printing results to stdout or error messages to stderr, providing a concrete usage pattern for integrating the runner.
examples · high confidence
New xplr.util Lua API for configuration and debugging
Users can now access a new \xplr.util\ table in Lua scripts, exposing helper functions for debugging (\debug\), inspecting the application version (\version\), cloning values (\clone\), and checking file system paths (\exists\, \is\_dir\, \is\_file\, \is\_symlink\, \is\_absolute\). This API is initialized in the Lua environment via \src/lua/mod.rs\ and \src/lua/util.rs\, providing a consistent interface for common utility tasks within the configuration.
src/lua · high confidence
Behavioural changes
Introduces new command-line interface with null-byte support and pipe messaging
The xplr binary now features a comprehensive CLI that supports reading and writing paths separated by null characters (via --read0, --write0, and --null flags), allowing safe handling of filenames with special characters. Users can also interact with running xplr sessions using --pipe-msg-in to send messages or --print-msg-in to preview them. Additional options include --force-focus for directory navigation, --read-only mode, --vroot for virtual root paths, and the ability to load extra configuration files via --extra-config.
src/bin · high confidence
Introduction of structured input message types
The application now defines explicit message types for handling user input and internal state changes. External commands, such as navigation (e.g., \FocusNext\, \ExplorePwd\) and screen operations, are now represented by the \ExternalMsg\ enum, while internal system events like key handling and directory updates are captured in the \InternalMsg\ enum. These are unified under a single \MsgIn\ type, providing a clearer separation between user-facing actions and internal application logic.
src/msg/in\ · high confidence_
Migrate configuration from YAML to Lua and introduce native search/filter
The application configuration system has been replaced: the legacy \config.yml\ is removed in favor of \src/init.lua\, which serves as the new default configuration file and Lua API entry point. This change introduces native search and filtering capabilities powered by the \skim\ library, replacing previous regex-based or external search mechanisms. Additionally, the \explorer\ module now utilizes \rayon\ for parallel directory traversal to improve performance, and the \pwd\_watcher\ module has been added to automatically refresh the view when the current working directory changes.
src · high confidence
Project governance, packaging, and configuration overhaul
This update introduces several foundational changes to the project structure and user experience. A Code of Conduct and MIT License have been added to establish community standards and legal clarity. The project now supports Nix packaging via a new flake, simplifying installation for Nix users. The legacy YAML-based configuration file (config.yml) has been removed, signaling a shift away from that configuration method. Additionally, the README has been significantly expanded with installation links, documentation references, and community badges to improve discoverability and onboarding.
(repo-wide) · high confidence
Test coverage
Added integration tests for CLI version and help flags; Updated benchmark suite to use Lua-backed app initialization.
Dependencies
Upgrade to version 1.1.3 with major dependency updates
The xplr file explorer has been upgraded to version 1.1.3, updating the Rust edition to 2021 and significantly modernizing its dependency stack. Key library updates include migrating the terminal UI backend from 'tui' to 'ratatui' (v0.30), upgrading 'skim' for fuzzy search (v5.7), and updating 'tui-input' (v0.15). The project also replaces 'dirs' with 'xdg' and 'home' for path handling, adopts 'anyhow' for error handling, and integrates 'rayon' for performance optimization. Additionally, the release profile is now configured with LTO and stripping to reduce binary size, and metadata for 'cargo binstall' has been added to streamline installation.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 54 → 55 (+1.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 90 → 83 (-6.4)
- Architecture 99 → 99 (+0.0)
- Maturity 53 → 58 (+5.4)
- Readiness 45 → 45 (-0.1)
- Security 72 → 60 (-11.9)
- Accessibility 56 → 67 (+11.3)
- Performance 90 → 90 (+0.0)
Resolved (6)
- Duplicated block (10 lines × 2) (src/app.rs)
- Duplicated block (11 lines × 2) (src/app.rs)
- Duplicated block (13 lines × 2) (src/runner.rs)
- Duplicated block (5 lines × 2) (src/app.rs)
- Medium vulnerability: [GHSA redacted] (Cargo.lock)
- No ADRs found
New (41)
- Duplicated block (10 lines × 2) (src/app.rs)
- Duplicated block (11 lines × 2) (src/app.rs)
- Duplicated block (13 lines × 2) (src/runner.rs)
- Duplicated block (17 lines × 2) (src/node.rs)
- Duplicated block (5 lines × 2) (src/app.rs)
- Edited copies of one member (3 members, 10+ corresponding lines) (src/lua/util.rs)
- Edited copies of one member (3 members, 12+ corresponding lines) (src/app.rs)
- Edited copies of one member (4 members, 15+ corresponding lines) (src/app.rs)
- Edited copies of one member (4 members, 15+ corresponding lines) (src/app.rs)
- Edited copy of a member (10 corresponding lines) (src/lua/util.rs)
- Edited copy of a member (12 corresponding lines) (src/app.rs)
- Edited copy of a member (12 corresponding lines) (src/app.rs)
- Edited copy of a member (15 corresponding lines) (src/app.rs)
- Edited copy of a member (16 corresponding lines) (src/app.rs)
- Edited copy of a member (35 corresponding lines) (src/app.rs)
- Edited copy of a member (7 corresponding lines) (src/event_reader.rs)
- Edited copy of a member (8 corresponding lines) (src/lua/util.rs)
- Edited copy of a member (9 corresponding lines) (src/lua/util.rs)
- Low coverage: src/app.rs (src/app.rs)
- Low coverage: src/cli.rs (src/cli.rs)
- …and 21 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
sayanarijit/xplr was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 50824d0d48d513b9a214730c21ef50bbb7bc9f8a — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.