YtreeNova is a keyboard-first file manager for Linux and BSD with fast multi-volume logging and navigation.

YtreeNova logs filesystem hierarchies into memory, so you can work across whole volumes, not just one directory at a time. Use tree + file-list views, Showall/Global views, tagging, fast filtering, split-screen workflows, preview, and archive-as-directory operations (including in-archive copy/move/rename/delete/mkdir where supported).

YtreeNova is an independent fork of Ytree v2.10, created by Werner Bregulla and others. The fork began in October 2025 and now has its own name, release line, command (ytnova), and repository.

It remains in the XTree™/Ytree family of full-tree logging and tagging file managers: scan a hierarchy first, then navigate, filter, tag, view, and operate across the logged set as a whole. The YtreeNova line focuses on feature completeness for Unix power users, adding split-screen work, integrated preview/autoview, archive-as-directory operations, and modernized internals.

Many file managers today function as "browsers"—they look at one directory at a time and rely on the OS to fetch files on demand. YtreeNova keeps the logger model: it scans ("logs") entire drive hierarchies into memory. This treats the filesystem as a database, allowing you to Show All files in a flat view, filter across thousands of subdirectories instantly, and perform bulk operations on tagged files regardless of their location.

This modernization is an experiment in AI-assisted systems engineering. The codebase was not simply "ported"; it was systematically disassembled and re-architected toward feature completeness and maintainability.

In practice, the human maintains design ownership and quality control, while AI is used as an implementation assistant. This requires substantial iteration, verification, and architectural guardrails for each meaningful change. The goal is to show that LLM-assisted development can still meet normal project standards when the process is disciplined, specification-driven, and strongly validated.

Quality claims are backed by repository-visible gates and documentation:

• AUDIT.md: required QA/audit loop and merge gates.
• TRUST.md: safety posture, limits, and code-level evidence pointers.
• PR_GATE.md: governance and merge-readiness checks.

v1.0.0-alpha is being published early so people can use the program, inspect the code, and evaluate the direction before beta. It is usable today, but still in active development: expect rough edges, occasional UX/workflow bugs, and ongoing refinement of some features.

• Classic XTree™ Interface: Directory Tree + File List layout.
• Split Screen Mode (F8): Manage two independent file panels side-by-side.
• File Preview (F7): Instant view of file contents without launching external tools.
• Multi-Volume Support: Log multiple drives or archives simultaneously and switch instantly.
• Archive Handling: Read archives and, where supported, write/update archive contents via libarchive.
• Advanced Filtering: Filter by RegEx, Attribute, Date, and Size.
• Configurable Color Themes: Customize UI colors to match workflow preferences.
• Modern Architecture: Clean C99, strict context-passing design — no global mutable state. See ARCHITECTURE.md.
• Auto-Refresh: Inotify integration for live directory updates.
• External Viewers: Associate specific file extensions with external programs (images, PDFs, etc.).
• User Commands: Bind keys to custom shell commands/scripts for infinite extensibility.

• C Compiler (GCC or Clang; Clang is required for fuzz targets)
• ncurses (libncurses-dev / ncurses-devel)
• readline (libreadline-dev / readline-devel)
• libarchive (libarchive-dev / libarchive-devel)
• lcov (for baseline coverage reports)
• llvm-symbolizer (recommended for sanitizer/fuzz stack traces)

# Clone the repository
git clone https://github.com/robkam/ytreenova.git
cd ytreenova

# Compile (Optimized Release Build)
make

# Install
sudo make install

# Uninstall
sudo make uninstall

Note: Developers can compile with AddressSanitizer enabled by running make DEBUG=1.

Note on Development: YtreeNova is developed using VScodium with the Codex extension, targeting WSL Ubuntu 24.04.4 LTS and GCC 13.3.0.

Verified Platforms (via WSL):

• Arch Linux, GCC 16.1.1
• Fedora Linux 45 (WSL Prerelease), GCC 16.1.1
• Ubuntu 26.04 LTS, GCC 15.2.0

The project documentation is split into several focused files.

ytreenova/
├── src/                 C source files
├── include/             C headers
├── tests/               pytest/pexpect test suite
├── scripts/             helper scripts (build and tooling)
├── docs/                user, developer, and process documentation
├── etc/                 manpage source and related assets
├── build/               build artifacts
├── obj/                 object files
├── coverage/            coverage outputs
├── Makefile             primary build/test targets
├── README.md            project overview
└── AGENTS.md            Codex/agent discovery stub

If you find anything amiss, you can report it using GitHub Issues.

For security-sensitive bugs, report privately via SECURITY.md.

Feature requests and enhancement ideas are welcome too. Suggestions are appreciated, but not every request can be implemented.

It will help us to address the issue if you include the following:

• OS & Configuration: (Distro, Terminal type, etc.)
• YtreeNova version:
• Steps to Reproduce:
• Expected Behavior:
• Actual Behavior:

Contributions are welcome! Please read CONTRIBUTING.md for guidelines. See SPECIFICATION.md for behavioral requirements, and ARCHITECTURE.md to understand the system design before submitting code. Contributions do not need to be low-level C internals: bug reports, documentation updates, typo fixes, wording/UX clarifications, and translations are all valuable.

YtreeNova is free software distributed under the GPL. See the LICENSE.md file for details.

For detailed authorship, see AUTHORS.md.