ajeetdsouza / zoxide

GitHub

Code

How ajeetdsouza/zoxide is laid out, and where to start for common changes.

Architecture grade

score 64/100

Import cycles

lower is better

Files mapped

58 imports between them

84%

Layering

of imports point one way

From the map of which files import which, built when the code was last read in full. It shows what depends on what, not a reading order.

Module map

Shade by

8 modules, 20 links. A link means one module imports another; thicker lines mean more imports. Select a module to trace it: blue lines go to what it uses, orange lines come from what uses it.

Where to start reading

Repository root
Repository root
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI
Suggested starting pointAI
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

Add support for a new shell

Add a new shell variant to the Shell enum in src/shell.rs

Add a new history import source

Export the parser in src/import.rs and add it to the import dispatcher
Update src/cmd/import.rs to route the new source and call the appropriate parser
Add integration test in tests/completions.rs or a new test file to validate import output

Modify frecency algorithm

Review the scoring logic in src/db/dir.rs (rank/frecency calculation)
Adjust decay constants or weighting in src/db/mod.rs query logic
Update src/cmd/query.rs if ranking heuristics or sorting order need changes
Test with existing database or add unit tests for the new scoring behavior

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.

Code quality and hotspots

Largest source files

Branch points7 per file on average
Code issues0 errors, 5 warnings
Largest file394 lines
Hotspot load0 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions5 workflows
Tests1 test fileRust test · 0.04 test files per source file (file count, not coverage)
Dependency updatesDependabot

Test folders: tests

Hotspots

src/util.rs1 commit in 180 days · 24 branch points
src/import/z_lua.rs1 commit in 180 days · 15 branch points
src/import/atuin.rs2 commits in 180 days · 6 branch points
src/import/autojump.rs1 commit in 180 days · 11 branch points
src/cmd/query.rs1 commit in 180 days · 9 branch points
src/import/z.rs1 commit in 180 days · 9 branch points
src/import.rs3 commits in 180 days · 3 branch points
contrib/completions/zoxide.ts1 commit in 180 days · 1 branch point

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.