BR
Get it
branch_VrI4bna.exe
2.4 MB · SHA-256 26251042df5a…
If you've already added the repository, just run:
sudo apt install branch
First-time setup (add repository)
sudo tee /etc/apt/sources.list.d/colaapps.list > /dev/null <<'EOF' deb [trusted=yes] https://colaapps.com/repo stable main EOF sudo apt update sudo apt install branch
branch_0.1.0_amd64.deb
amd64 · 1.2 MB · SHA-256 c2b18bffe329…
About
Branch
Branch is a smart, modern CLI tool for scanning directories and exporting structured data.
Features
- 🌳 Tree view (default)
- 👁️ Optional content preview mode (head/tail/full)
- 📄 CSV export
- 🗄️ SQLite export
- ⚡ Fast and structured output
🚀 Quick Start
cargo run -- .
Or (after building):
target/release/branch <PATH>
By default, this runs in Tree mode.
🌳 Default Behavior (Tree Mode)
If you run Branch with no preview flags, it prints tree-only:
branch .
👁️ Content Preview Mode (head / tail / full)
Preview mode is enabled automatically when you use any of these flags:
--head N→ show first N lines of each text file--tail N→ show last N lines of each text file--full→ show full text file contents
✅ You do not have to specify --format text for these to work.
Examples:
branch . --head 20
branch . --tail 20
branch . --full
Notes on file reading (--max-bytes)
- Default: 2,000,000 bytes per file
- Larger files are truncated
- Binary files are skipped
📦 Output Formats
Tree (default)
branch .
Text (tree + contents)
branch . --format text --head 20
branch . --format text --tail 20
branch . --format text --full
CSV
branch . --format csv --out files.csv
SQLite
branch . --format sqlite --db data.db
⚙️ Options
| Option | Description |
|---|---|
PATH |
Root path to scan |
--all |
Include hidden files |
--depth N |
Limit traversal |
--head N |
Show first N lines |
--tail N |
Show last N lines |
--full |
Show full content |
--format |
tree / text / csv / sqlite |
--out FILE |
Write output file |
--db FILE |
SQLite database |
--max-bytes N |
Max bytes per file |
📄 Man Page
man -l docs/branch.1
✅ Status
- Core engine complete
- CLI working
- Multi-format supported
License
MIT