Real-time directory tree watcher for the terminal, with incremental updates and minimal flicker.
livetree monitors a directory recursively and redraws a tree view as files change.
It is built as a Rust CLI binary with:
clapfor robust argument parsingnotify+notify-debouncer-fullfor filesystem eventsratatuifor terminal UI rendering
cargo install livetreegit clone https://github.com/INS-JVidal/livetree
cd livetree
cargo install --path .git clone https://github.com/INS-JVidal/livetree
cd livetree
make build
make install # installs to ~/.local/bin/livetreecurl -sSfL https://raw.githubusercontent.com/INS-JVidal/livetree/main/install.sh | shDownload the archive for your platform from Releases, then:
tar -xzf livetree-*.tar.gz
install -d ~/.local/bin
install -m 0755 livetree ~/.local/bin/Note: Ensure
~/.local/binis in yourPATH. Addexport PATH="$HOME/.local/bin:$PATH"to your shell profile if needed.
livetree .livetree -L 3 -I target -I "*.log" ./my-project
livetree --dirs-only .
NO_COLOR=1 livetree .├── src
│ ├── cli.rs
│ ├── event_loop.rs
│ └── main.rs
├── tests
│ └── phase0_cli.rs
└── Cargo.toml
-L, --level <N>: maximum depth-I, --ignore <PATTERN>: glob patterns to exclude (repeatable)-a, --all: show hidden files-D, --dirs-only: show only directories-f, --follow-symlinks: follow symbolic links--debounce <MS>: debounce interval (minimum50)--no-color: disable colors-v, --verbose: increase verbosity (-v,-vv)--quiet: silence non-critical stderr messages
NO_COLOR: disables colored outputLANG,LC_ALL: terminal locale behavior (UTF-8 recommended)
- Minimum supported Rust version: 1.88
cargo fmt --check
cargo clippy -- -D warnings
cargo test
cargo deny check
cargo auditGenerate completion files and a man page:
cargo run --bin generate-assetsGenerated files:
dist/completions/for bash, zsh, fish, powershelldist/man/livetree.1
See CONTRIBUTING.md for development workflow, testing, and PR guidelines.
Project behavior standards are documented in CODE_OF_CONDUCT.md.
See SECURITY.md for vulnerability reporting instructions.
See CHANGELOG.md for release notes and version history.
MIT — see LICENSE.