🌳 gitree

A tree view of every git repository under a directory, with branch and short commit hash at a glance.
한 디렉토리 아래의 모든 git 리포지토리를 트리로 보여주고, 현재 브랜치와 6자리 커밋 해시를 한눈에 확인합니다.

English · 한국어 · AI install prompt

Static example output

╭─────────────────────────────────────────────────────────╮
│ 🌳 gitree · ~/personal · 6 repos · scanned in 5ms       │
╰─────────────────────────────────────────────────────────╯

personal/
├─ 🦀 gitree
│    └─ main · 660767b
├─ 🟢 2msi-landing
│    └─ main · b44f84a
├─ 🐳 auto-auction
│    └─ main · dde900c
├─ 📦 chocoya-location
│    └─ ○ (no commits)
├─ 📂 work/
│    ├─ ▲  project-x
│    │    └─ feature/login · c92840f
│    └─ 🐍 project-y
│         └─ ⚠ (detached) · 112233a
└─ 🤖 gwansang-android
     └─ master · 48ad8de

---

AI install prompt

Copy the prompt below into Claude Code / Cursor / Codex / any coding agent — it will pick the right release artifact for your machine, install it to your PATH, and verify the install.

아래 프롬프트를 Claude Code / Cursor / Codex 등 AI 코딩 비서에 그대로 붙여 넣으면, 머신에 맞는 릴리스 아티팩트를 골라 PATH 에 설치하고 동작까지 확인합니다.

Please install the `gitree` CLI on this machine. Repo: https://github.com/rtzr/gitree

Steps you should follow, in order:

1. Detect the host:
   - Run `uname -sm` to get OS and arch.
   - Map to one of these release targets (the archive lives at
     `https://github.com/rtzr/gitree/releases/latest/download/gitree-<TAG>-<TARGET>.<EXT>`,
     where TAG is the latest release tag you discover via the GitHub API):
       Darwin arm64  → aarch64-apple-darwin       (.tar.gz)
       Darwin x86_64 → x86_64-apple-darwin        (.tar.gz)
       Linux  x86_64 → x86_64-unknown-linux-gnu   (.tar.gz)
       Linux  aarch64→ aarch64-unknown-linux-gnu  (.tar.gz)
       Windows x86_64→ x86_64-pc-windows-msvc     (.zip)

2. Look up the latest tag:
   `curl -sSL https://api.github.com/repos/rtzr/gitree/releases/latest | grep -m1 tag_name`
   (or `gh release view --repo rtzr/gitree --json tagName` if `gh` is available).

3. Download the matching archive to a temp directory, extract it, and move the
   `gitree` binary into the first writable directory on the user's `$PATH`.
   Prefer in this order: `~/.local/bin`, `~/bin`, `/usr/local/bin`
   (use `sudo` only if necessary and ask the user first).
   Create the target directory if it doesn't exist and ensure it's on `PATH`
   (update the user's shell rc file if it isn't).

4. Verify: run `gitree --version` and `gitree .` (from a directory containing
   at least one git repo) to confirm the binary works.

5. Report back: the version installed, the install path, and the verify output.

Fallback: if Rust + `cargo` are available on the machine and the user prefers a
source build, you can instead run:
    cargo install --git https://github.com/rtzr/gitree --locked

Do NOT proceed past step 1 if `uname` reports a target this script doesn't
cover — ask the user how they'd like to proceed.

---

English

Why gitree?

If your ~/projects folder has grown into a forest of clones, gitree gives you a one-shot snapshot: which branch is each repo on, what's the HEAD commit, and is anything in an unusual state (detached, empty)? No registration step — point it at a directory and it auto-discovers every repo underneath.

Install

From source (requires Rust):

cargo install --git https://github.com/rtzr/gitree

From a release binary — grab the archive for your platform from the Releases page, extract gitree, and put it somewhere on your PATH.

Pre-built binaries are published for:

• macOS — Apple Silicon (aarch64-apple-darwin) & Intel (x86_64-apple-darwin)
• Linux — x86_64-unknown-linux-gnu & aarch64-unknown-linux-gnu
• Windows — x86_64-pc-windows-msvc

Usage

gitree [PATH] [OPTIONS]

Flag	Description
PATH	Root path to scan. Defaults to the current directory.
-L, --depth N	Limit the tree to N levels deep.
-a, --all	Don't skip default-ignored dirs (node_modules, target, ...).
--no-color	Disable ANSI colors (also auto-disabled when piping).
--no-emoji	Use ASCII markers ([D], [G], *, !) instead of emoji.
-h, --help	Show full help.
-V, --version	Show version.

Examples

# Scan your projects folder two levels deep
gitree ~/projects -L 2

# Scan your home directory but include hidden folders
gitree ~ --all

# Plain ASCII output (handy in logs / CI)
gitree ~/projects --no-color --no-emoji

Status legend

Marker	Meaning
⚠	Detached HEAD
○	Repo has no commits yet
✕	Repo couldn't be opened or read

A repo on a named branch has no marker — the green branch text says it all.

Platform icons

Each repo gets an icon based on a marker file in its root (no file contents are read, just directory entries — so it stays fast).

Icon	Platform	Detected by
🦀	Rust	Cargo.toml
🐹	Go	go.mod
🐍	Python	pyproject.toml / requirements.txt / setup.py / Pipfile
▲	Next.js	next.config.*
💚	Nuxt	nuxt.config.*
🚀	Astro	astro.config.*
🧡	Svelte	svelte.config.*
🦕	Deno	deno.json / deno.jsonc
🟢	Node.js	package.json (when no framework above matches)
💎	Ruby	Gemfile
🐘	PHP	composer.json
☕	Java	pom.xml
💧	Elixir	mix.exs
🐦	Flutter / Dart	pubspec.yaml
🦅	Swift	Package.swift
🍎	iOS / Xcode	*.xcodeproj / *.xcworkspace
🤖	Android	build.gradle[.kts] + app/
🌍	Terraform	*.tf / *.hcl
🐳	Docker	Dockerfile / docker-compose*
🌐	Static web	index.html
🔧	Makefile	Makefile (when nothing else matched)
📦	Unknown	fallback

How it works

gitree walks the directory tree from the given root. Whenever it encounters a directory containing .git (folder or file — regular repos, submodules, and linked worktrees all work), it marks the directory as a leaf and stops descending. Branches with no repos underneath are pruned, so the output stays focused on actual project state.

For each discovered repo, gitree reads the current branch label and the 6-character HEAD commit hash via libgit2 — no shelling out to git.

---

한국어

왜 gitree?

~/projects 폴더가 클론들로 가득 차 있나요? gitree는 한 번 실행으로 **각 리포의 현재 브랜치 · HEAD 커밋 · 비정상 상태(detached/empty 등)**를 스냅샷으로 보여줍니다. 별도 등록 단계 없이 디렉토리를 가리키기만 하면 그 아래의 모든 리포를 자동으로 찾아냅니다.

설치

소스에서 빌드 (Rust 필요):

cargo install --git https://github.com/rtzr/gitree

미리 빌드된 바이너리 — Releases 에서 본인 플랫폼용 아카이브를 받아, 압축을 풀고 gitree 실행 파일을 PATH 위에 두세요.

지원 플랫폼:

• macOS — Apple Silicon (aarch64-apple-darwin) / Intel (x86_64-apple-darwin)
• Linux — x86_64-unknown-linux-gnu / aarch64-unknown-linux-gnu
• Windows — x86_64-pc-windows-msvc

사용법

gitree [경로] [옵션]

옵션	설명
PATH	탐색을 시작할 경로. 생략하면 현재 디렉토리.
-L, --depth N	트리 최대 깊이를 N 단계로 제한.
-a, --all	기본 제외 폴더(node_modules, target 등)도 탐색.
--no-color	ANSI 컬러 끄기 (파이프로 연결되면 자동으로 꺼집니다).
--no-emoji	이모지 대신 ASCII 마커([D], [G], *, !) 사용.
-h, --help	전체 도움말 보기.
-V, --version	버전 정보 보기.

예시

# 프로젝트 폴더를 2단계까지만 스캔
gitree ~/projects -L 2

# 홈 디렉토리를 숨김 폴더 포함해서 스캔
gitree ~ --all

# 컬러/이모지 없이 plain ASCII로 출력 (로그/CI에 유용)
gitree ~/projects --no-color --no-emoji

상태 마커

마커	의미
⚠	HEAD가 분리됨 (detached)
○	아직 커밋이 없는 리포
✕	리포를 열거나 읽지 못함

브랜치 위에 정상적으로 있으면 마커 없음 — 녹색 브랜치 텍스트가 그 역할.

플랫폼 아이콘

각 리포는 루트의 마커 파일을 보고 자동으로 아이콘이 붙습니다. 파일 내용을 읽지 않고 디렉토리 entry 이름만 보기 때문에 빠릅니다.

아이콘	플랫폼	감지 기준
🦀	Rust	Cargo.toml
🐹	Go	go.mod
🐍	Python	pyproject.toml / requirements.txt / setup.py / Pipfile
▲	Next.js	next.config.*
💚	Nuxt	nuxt.config.*
🚀	Astro	astro.config.*
🧡	Svelte	svelte.config.*
🦕	Deno	deno.json / deno.jsonc
🟢	Node.js	package.json (위 프레임워크에 매치 안 될 때)
💎	Ruby	Gemfile
🐘	PHP	composer.json
☕	Java	pom.xml
💧	Elixir	mix.exs
🐦	Flutter / Dart	pubspec.yaml
🦅	Swift	Package.swift
🍎	iOS / Xcode	*.xcodeproj / *.xcworkspace
🤖	Android	build.gradle[.kts] + app/
🌍	Terraform	*.tf / *.hcl
🐳	Docker	Dockerfile / docker-compose*
🌐	정적 웹	index.html
🔧	Makefile	Makefile (위 어느 것에도 매치 안 될 때)
📦	Unknown	fallback

동작 원리

gitree는 지정한 루트부터 디렉토리 트리를 재귀적으로 워크합니다. .git(폴더 또는 파일 — 일반 리포, 서브모듈, 링크된 워크트리 모두 지원)을 가진 디렉토리를 만나면 leaf로 처리하고 더 내려가지 않습니다. 또한 git 리포가 하나도 없는 가지는 출력에서 잘려나가므로(prune), 결과가 실제 프로젝트 상태에만 집중됩니다.

각 리포의 브랜치 라벨과 6자리 단축 해시는 외부 git 호출 없이 libgit2로 직접 읽습니다.

---

License · 라이선스

MIT