gitsej

gitsej

gitsej creates a "gitsej repo": a parent directory backed by a bare repository in .bare, with .git pointing to that bare repo, plus a .gitsej config marker.

Install

Build from source on your machine:

go install github.com/repsejnworb/gitsej/cmd/gitsej@latest

go install places the binary in $GOBIN (or $(go env GOPATH)/bin when GOBIN is unset). Make sure that directory is in your PATH so gitsej is runnable from anywhere.

Development

Run local checks:

just ci

Usage

Create a gitsej repo directory from a remote URL:

gitsej git@github.com:owner/repo.git

That creates:

• repo/.bare (bare clone)
• repo/.git (gitdir: ./.bare)
• repo/.gitsej (default config)

Create and check out a main worktree too:

gitsej --main-worktree git@github.com:owner/repo.git

Override target directory:

gitsej git@github.com:owner/repo.git my-repo

Initialize an existing gitsej directory (must contain .bare):

gitsej init /path/to/repo

Initialize current directory:

gitsej init

Upgrade gitsej metadata in an existing gitsej directory:

gitsej upgrade /path/to/repo

upgrade keeps existing values untouched, creates missing .git / .gitsej files, and appends any newly introduced default .gitsej keys.

Migrate a standard clone into a gitsej repo:

gitsej migrate /path/to/repo

migrate will:

• convert .git/ to .bare/
• create .git and .gitsej (if missing)
• create main/ worktree (or your detected default branch, such as master)
• move linked worktrees into the repo root

If the main worktree is dirty, migrate prompts before cleaning it. Use --yes to skip the prompt:

gitsej migrate --yes /path/to/repo

Flags

• --main-worktree: create ./main worktree tracking origin/<main-branch>
• --main-branch: branch name used for --main-worktree and .gitsej defaults (default: main)

init command flags:

• gitsej init --main-branch <branch>: branch value for newly created .gitsej files
• gitsej upgrade --main-branch <branch>: branch value used only if main_branch is missing from .gitsej
• gitsej migrate --yes <path>: allow migration when main worktree is dirty

Environment

• GITSEJ_MAIN_WORKTREE: default for --main-worktree (true/false)
• GITSEJ_MAIN_BRANCH: default for --main-branch

.gitsej config

Default file:

# gitsej repo configuration
label=
main_worktree=main
main_branch=main
cooldown=300
auto_update=0

auto_update controls background pull behavior in tmux status:

• 0: never auto-pull (manual --update only)
• 1: auto-pull when the configured worktree is clean and behind

tmux status integration

This repo includes scripts/tmux/gitsej-main-status.sh.

Install it (example):

mkdir -p ~/.config/tmux/scripts
cp scripts/tmux/gitsej-main-status.sh ~/.config/tmux/scripts/
chmod +x ~/.config/tmux/scripts/gitsej-main-status.sh

Add to .tmux.conf:

set -g status-right "#(bash ~/.config/tmux/scripts/gitsej-main-status.sh '#{session_id}')#[fg=#7dcfff] #(whoami) #[fg=#a9b1d6]| #[fg=#9ece6a]󰇅 #H #[fg=#a9b1d6]| #[fg=#c0caf5] %H:%M #[fg=#565f89]| #[fg=#7aa2f7]%Y-%m-%d"

bind u run-shell -b "bash ~/.config/tmux/scripts/gitsej-main-status.sh --force '#{session_id}' >/dev/null 2>&1" \; refresh-client -S \; display-message "status force refresh"
bind U run-shell -b "bash ~/.config/tmux/scripts/gitsej-main-status.sh --update '#{session_id}' >/dev/null 2>&1" \; refresh-client -S \; display-message "status manual update"
bind g run-shell -b "bash ~/.config/tmux/scripts/gitsej-main-status.sh --cycle '#{session_id}' >/dev/null 2>&1" \; refresh-client -S \; display-message "gitsej root: #{@gitsej_root}"
bind G run-shell -b "bash ~/.config/tmux/scripts/gitsej-main-status.sh --clear-pin '#{session_id}' >/dev/null 2>&1" \; refresh-client -S \; display-message "gitsej root auto"

Behavior:

• Auto-detects gitsej roots from pane paths in the current tmux session
• Pins active root per session via @gitsej_root
• Prefix + u: force recompute now (no pull unless auto_update=1)
• Prefix + U: manual update now (fetch + pull when clean and behind)
• Prefix + g: cycle pinned root across discovered gitsej repos
• Prefix + G: clear pin and return to auto-selection

Optional strict marker mode:

• GITSEJ_REQUIRE_MARKER=1 to require a .gitsej file in the repo root for detection

Cache files live in:

~/.cache/gitsej-tmux