gitutil

Documentation

Overview

Package gitutil shells out to the `git` CLI (docs/conventions.md: "Git/GitHub: never go-git") to answer the small set of questions m1-sessions needs about a launch directory: is it a git checkout, what branch is it on, and is it a linked worktree. Nothing here is Claude-Code-format knowledge; it stays out of internal/claudecode by design.

Index

• func Branch(ctx context.Context, dir string) *string
• func IsRepo(ctx context.Context, dir string) bool
• func IsWorktree(ctx context.Context, dir string) bool

Functions

func Branch

func Branch(ctx context.Context, dir string) *string

Branch returns the current branch name, or nil when dir isn't a git checkout or is in a detached-HEAD state (session.branch is "null when not git" — Schema Changes).

func IsRepo

func IsRepo(ctx context.Context, dir string) bool

IsRepo reports whether dir is inside a git working tree.

func IsWorktree

func IsWorktree(ctx context.Context, dir string) bool

IsWorktree reports whether dir is a linked worktree: its git-dir and the repository's common-dir differ (ux-flows §2's recognition rule).