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)
curl -fsSL -o /tmp/colaapps-archive-keyring.gpg \
https://colaapps.com/repo/colaapps-archive-keyring.gpg &&
sudo install -D -m 0644 /tmp/colaapps-archive-keyring.gpg \
/etc/apt/keyrings/colaapps-archive-keyring.gpg
sudo tee /etc/apt/sources.list.d/colaapps.list > /dev/null <<'EOF'
deb [signed-by=/etc/apt/keyrings/colaapps-archive-keyring.gpg] https://colaapps.com/repo stable main
EOF
sudo apt update
sudo apt install branch
The first two commands install the ColaApps signing key, so apt verifies every index it
downloads. Needs curl. Debian and Ubuntu.
Added ColaApps before, with [trusted=yes]? That turns
signature checking off — run the block above again, it overwrites the old line.
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