ajeetdsouza/zoxide
66.4
Adequate · 27 September 2026
2.2k
lines of production code
Rust
primary language
4
measurements over time
What this system is
Zoxide is a command-line tool designed to streamline directory navigation by intelligently tracking and ranking frequently accessed folders. It maintains a local database of directories using a time-decay scoring algorithm, allowing users to add, query, remove, and edit entries via a structured CLI. The system supports seamless migration from other directory-jumping tools and integrates with various shells through generated completions and initialization scripts.
Features
Add manpages for zoxide subcommands
The project now includes manual pages for all zoxide subcommands (add, import, init, query, remove, and the main zoxide command) in the man/man1 directory. This provides users with local documentation for usage, options, and configuration details directly from the terminal.
man · high confidence
Add shell completions for zoxide
Shell completions are now available for Bash, Zsh, Fish, Elvish, Nushell, PowerShell, and Fig. These files, generated by clap, provide tab-completion for zoxide commands and options, including subcommands like add, edit, import, init, query, and remove, as well as their respective flags and arguments.
contrib/completions · high confidence
Import history from other tools
Users can now import directory history from other tools like z, autojump, fasd, z.lua, zsh-z, and Atuin using the new import command. The tool automatically detects the source database format and migrates the entries into zoxide's database, allowing a seamless transition from previous tools.
src · high confidence
Behavioural changes
Introduce zoxide CLI with interactive query, import, and shell integration
The \src/cmd\ module now implements the core zoxide command-line interface, replacing the previous structure with a structured set of subcommands: \add\ to record directories, \query\ to search them (supporting interactive fzf selection, list, and first-match modes), \remove\ to delete entries, \edit\ for manual database adjustments, \import\ to migrate data from tools like fasd, autojump, and z, and \init\ to generate shell configuration for Bash, Fish, Zsh, Nushell, Elvish, Tcsh, and others. This change establishes the primary user-facing behavior for directory navigation and database management.
src/cmd · high confidence
New database module with scoring, streaming, and lazy cleanup
The \src/db\ directory now contains a new implementation for the directory database, introducing a \Dir\ struct with a time-decay scoring algorithm that boosts recent access and penalizes older entries. A \Stream\ iterator is provided for querying directories, supporting keyword matching, base-directory filtering, exclusion patterns, and existence checks. The module also implements lazy cleanup of excluded or non-existent directories based on a time-to-live (TTL) threshold, and handles symlink resolution during existence checks.
src/db · high confidence
zoxide v0.10.0 release with Nushell 0.106 support and Atuin import
This release upgrades the minimum supported Nushell version to 0.106.0 and adds the ability to import directory history from Atuin databases via the \import\ subcommand. The \import\ command now auto-detects database files and respects the \$\_ZO\_EXCLUDE\_DIRS\ environment variable to skip excluded directories. Additional improvements include support for RISC-V (riscv64) Linux, better handling of relative paths through symlinked directories in Bash, Zsh, and Nushell, and the ability for Fish Space-Tab completions to display and run the selected command.
(repo-wide) · high confidence
Test coverage
Added tests for shell completion scripts
Added test coverage for shell completion scripts (bash, fish, powershell, and zsh) to ensure they are syntactically valid and load without errors.
tests · high confidence
Dependencies
zoxide v0.10.0 release with Rust 2024 and dependency upgrades
This update releases zoxide version 0.10.0, upgrading the project to the Rust 2024 edition and raising the minimum supported Rust version to 1.88.0. The dependency stack has been significantly modernized: the argument parser has moved from clap v2 to clap v4, the template engine has switched from askama v0.16.0 (replacing the previously used rinja), and error handling now uses anyhow instead of failure. Additional dependencies like dirs, bincode, and serde have been updated to their latest major versions, and build-time completions are now generated using clap\_complete v4 for bash, fish, zsh, nushell, and fig.
(dependencies) · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 42 → 66 (+24.7)
- Rubric changed (rubric-2026.08.15 → rubric-2026.09.15) — scores are not directly comparable.
Lenses
- Code Health 100 → 97 (-2.6)
- Architecture 99 (new)
- Maturity 55 → 55 (-0.8)
- Readiness 32 → 84 (+52.0)
- Security 34 → 63 (+29.5)
Resolved (26)
- Dimension evaluation failed
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 6 more
New (59)
- Duplicated block (10 lines × 3) (src/import/atuin.rs)
- Duplicated block (18 lines × 2) (src/import/autojump.rs)
- Duplicated block (6 lines × 2) (src/import/autojump.rs)
- Duplicated block (7 lines × 2) (src/import/fasd.rs)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 39 more
Changes since last survey
- 12 commits — 11 feature/other, 1 fixes
By area
- .github/workflows — 8 commits
- (root) — 4 commits
Notable commits
- fix: Fix minimum supported Nushell version in README (#1284)
- change: Add logo
- change: Bump Swatinem/rust-cache from 2.9.1 to 2.9.2 (#1279)
- change: Bump taiki-e/install-action from 2.85.10 to 2.85.13 (#1286)
- change: Bump taiki-e/install-action from 2.85.13 to 2.86.5 (#1289)
- change: Bump taiki-e/install-action from 2.85.5 to 2.85.10 (#1278)
- change: Bump taiki-e/install-action from 2.86.5 to 2.87.0 (#1296)
- change: Bump taiki-e/install-action from 2.87.0 to 2.87.5 (#1301)
- change: Bump taiki-e/install-action from 2.87.11 to 2.87.15 (#1305)
- change: Bump taiki-e/install-action from 2.87.5 to 2.87.11 (#1304)
- change: Refresh GIF
- change: docs: add superfile to third-party integrations (#1294)
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
ajeetdsouza/zoxide 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 27 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 09a18b4424b3f1033094ffd97da6d47585e38259 — the exact code this score is about.
- Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-7c1cb6328e11.