Skip to content

Releases

v0.23.0

Choose a tag to compare

@CelikE CelikE released this 27 Oct 19:41
a628952

See CHANGELOG.md for feature details and upgrade notes.

What's Changed

  • fix(output): serialize Progress render/Done to fix data race (#195) by @ethanhawkes-gif in #248
  • fix(cli): honor repository filters in stash pop by @CelikE in #251
  • fix(cli): resolve tags from checkout subdirectories by @CelikE in #252
  • fix(grep): preserve exact filenames by @CelikE in #253
  • fix(report): encode empty activity as JSON array by @CelikE in #254
  • fix(status): count file type changes as modified by @CelikE in #255
  • fix(apply): show final-newline changes in diff previews by @CelikE in #256
  • fix(exec): return failure status in JSON mode by @CelikE in #257
  • fix(stash): include untracked files by @CelikE in #258
  • fix(apply): report planning and JSON write failures by @CelikE in #259
  • fix(undo): preserve work created after pulls by @CelikE in #260
  • fix(diff): report repository inspection failures by @CelikE in #261
  • fix(report): match author filters literally by @CelikE in #262
  • fix(annotate): preserve literal metadata values by @CelikE in #263
  • fix(remove): cascade linked worktree unregistration by @CelikE in #264
  • chore(go): upgrade to Go 1.27.2 by @CelikE in #265
  • fix(doc): remove broken repositories by path by @CelikE in #266
  • fix(browser): avoid Windows command shell for URLs by @CelikE in #267
  • fix(stash): report Git inspection failures by @CelikE in #268
  • fix(clean): serialize branch deletions per repository by @CelikE in #269
  • fix(apply): confine destination operations to repository roots by @CelikE in #270
  • fix(grep): report repository search failures by @CelikE in #271
  • fix(install): complete installs into protected directories by @CelikE in #272
  • fix(prune): cascade worktrees after interactive selection by @CelikE in #273
  • fix(install): use Windows executable suffix by @CelikE in #274
  • fix(filters): preserve repeated exact repository matches by @CelikE in #275
  • fix(shell): restore Fish navigation hook by @CelikE in #276
  • fix(alias): preserve quoted command arguments by @CelikE in #277
  • fix(clean): protect checked-out branches during discovery by @CelikE in #278
  • fix(config): validate edits and preserve editor arguments by @CelikE in #279
  • fix(output): clear progress by display width by @CelikE in #280
  • fix(install): report checksum verification accurately by @CelikE in #281
  • fix(filters): handle empty selections after excluding worktrees by @CelikE in #282
  • fix(open): report repository lookup failures accurately by @CelikE in #283
  • fix(pr): expose pull request limits and cap hints by @CelikE in #284
  • fix(ctx): restore work when context saves fail by @CelikE in #288
  • fix(ctx): preserve stash ownership across worktrees by @CelikE in #289
  • fix(config): reject stale concurrent updates by @CelikE in #290
  • fix(clean): report JSON deletion failures by @CelikE in #291
  • fix(undo): resume partial pull reversals by @CelikE in #292
  • fix(snapshot): preserve saves and report corrupt files by @CelikE in #293
  • fix(status): align grouped tables by display width by @CelikE in #294
  • fix(worktree): emit only the path in quiet mode by @CelikE in #295
  • fix(open): reject conflicting repository selectors by @CelikE in #296
  • fix(branch): exclude worktrees from bulk switches by @CelikE in #297
  • fix(git): preserve names for trailing-slash remote URLs by @CelikE in #298
  • fix(ui): prevent overlapping dashboard fetches by @CelikE in #299
  • fix(picker): clear wrapped terminal rows by @CelikE in #300
  • fix(journal): preserve undo records across concurrent writes by @CelikE in #301
  • fix(doc): report duplicate paths as manual repairs by @CelikE in #302
  • fix(picker): decode keys across split terminal reads by @CelikE in #303
  • fix(version): display injected build commit metadata by @CelikE in #304
  • fix(config): reject ambiguous repository names by @CelikE in #305
  • fix(git): guard stash restoration and cover risky paths by @CelikE in #306
  • fix(ci): test on Linux, macOS, and Windows by @CelikE in #307
  • fix(scan): preserve empty JSON and speed up CI by @CelikE in #309
  • fix(docs): date the v0.21.0 changelog release by @CelikE in #310
  • fix(grep): ignore Git output presentation settings by @CelikE in #312
  • fix(install): preserve relative installation destinations by @CelikE in #314
  • fix(docs): complete pull request command guide by @CelikE in #315
  • fix(scan): reject non-directory scan roots by @CelikE in #317
  • fix(scan): reject negative depth values by @CelikE in #319
  • fix(branch): validate stale days before repository selection by @CelikE in #321
  • fix(paths): respect home directory boundaries by @CelikE in #323
  • fix(branch): report stale inspection failures by @CelikE in #325
  • chore(ci): reduce hosted runner demand by @CelikE in #328
  • test(branch): cover checked-out stale branches by @CelikE in #327
  • fix(grep): preserve JSON for unmatched repo filters by @CelikE in #330
  • fix(cd): require exactly one repository name by @CelikE in #326
  • fix(remove): reject extra repository names by @CelikE in #332
  • test(scan): cover JSON registration persistence by @CelikE in #333
  • fix(tag): preserve empty JSON and speed up PR checks by @CelikE in #335
  • fix(clean): preserve exact local branch refs for undo by @CelikE in #359
  • fix(tag): normalize registration and legacy tag matching by @CelikE in #360
  • fix(status): count conflict-only repositories as dirty by @CelikE in #361
  • fix(doc): preserve worktree families during registry repair (#340) by @CelikE in #362
  • fix(cli): emit valid JSON for empty selections by @CelikE in #363
  • Fix diff JSON filenames for special paths by @CelikE in #364
  • fix(cli): distinguish failed repository reads from clean health by @CelikE in #365
  • fix(report): reject unresolved default author (#344) by @CelikE in #366
  • fix(clean): report remote prune failures by @CelikE in #367
  • fix(discover): include descendants of filesystem root (#346) by @CelikE in #368
  • fix(shell): preserve whitespace in navigation targets by @CelikE in #369
  • Define clean completion for repository inspection failures (#348) by @CelikE in #370
  • Expose incomplete activity reports (#349) by @CelikE in #371
  • Document workspace context staging policy (#350) by @CelikE in #372
  • Resolve soko open from nested checkout directories by @CelikE in #373
  • feat(doc): diagnose unresolved worktree family references by @CelikE in #374
  • docs: define JSON command capabilities and perf contracts by @CelikE in #375
  • fix(cli): define argument and conflicting-flag contracts by @CelikE in #376
  • test: validate destructive workflow faults and recovery by @CelikE in #377
  • test: validate interactive terminal workflows by @CelikE in #378
  • Complete platform and distribution audit validation by @CelikE in ...
Read more

v0.22.0

Choose a tag to compare

@CelikE CelikE released this 14 Oct 18:07
a055986

See CHANGELOG.md for feature details and upgrade notes.

What's Changed

  • fix(ui): viewport scrolling, width clamping, jump keys, and mouse support by @CelikE in #176
  • fix(ui): keep cursor on the same repo across refreshes, pin pull target by @CelikE in #177
  • fix(ui): status line lifecycle — expiring messages, fetch indicator race, staleness by @CelikE in #178
  • fix(ui): missing-repo guards, detail line, worktree marker, display-width columns by @CelikE in #179
  • feat(ui): committed search, esc unwind, reverse cycles, broader matching by @CelikE in #180
  • feat(ui): batch pulls with marks, undo, single-repo fetch, copy path by @CelikE in #181
  • chore(ui): shell-integration hint, typed pages, severity consts, doc fixes by @CelikE in #182
  • feat(ui): clearer grouped view — indented rows, accent headers with totals by @CelikE in #183
  • feat(docs): add a full man soko manual page by @CelikE in #184
  • feat(ui): list a repo's pull requests with L and open one in the browser by @CelikE in #185
  • feat(cli): add soko pr to gather open pull request information by @CelikE in #186
  • feat(cli): scope soko pr to the current repository by @CelikE in #187
  • feat(cli): adopt and navigate worktree families by @CelikE in #249
  • chore(release): replace Chagg with GitHub-native notes by @CelikE in #250

Full Changelog: v0.21.0...v0.22.0

v0.21.0

Choose a tag to compare

@CelikE CelikE released this 12 Jun 06:14
f93539a

0.21.0

Features

  • soko snapshot — save and restore exact repo positions: snapshot save records branch + HEAD SHA per repo, snapshot restore moves every repo back (rewinding moved branches, recreating deleted ones, refusing dirty trees), plus list / show / drop. The save game before a risky bulk operation; completes the trust layer started by soko undo.
  • Worktree entries now inherit their parent repo's tags at filter time, so --tag filters (status, sync, fetch, list, etc.) include worktrees of tagged repos. Retagging the parent instantly re-scopes its worktrees; tag remove on a worktree only removes own tags and errors on inherited ones.
  • soko ui gains its first mutating key: P fast-forward pulls the selected repo after a confirmation prompt, runs asynchronously, and records a journal entry so soko undo rewinds it to the pre-pull SHA. Satisfies feature 44's scope guard — mutations only once undo exists.
  • soko undo reverts the last destructive operation via a capped pre-image journal beside the config (journal.yaml). soko clean now records the branches it deletes, so soko undo recreates them at their exact SHAs; soko undo --list shows the journal. This is the trust layer that will unlock mutating keys in soko ui.
  • soko ui gains read-only power keys — a tag legend, group-by-tag view (G), live name search (/), a filter cycle (f: all/dirty/behind/ahead/conflicts), browser-page jumps (o/p/i/a for home/PRs/issues/actions), and a ? help overlay
  • Live full-screen TUI dashboard with soko ui — auto-refreshing local workspace state (branch, dirty, ahead/behind, last-commit age, health badge) with sort, dirty/tag filters, cd-on-enter, open-in-browser, and optional background --fetch
  • Add soko branch for cross-repo branch operations: current branch per repo, branch lookup (current/local/remote/missing), bulk switch with -b create-from-default, and stale unmerged branch detection
  • Add soko worktree to manage git worktrees across repos: worktree add <repo> <branch> creates and registers in one step (with -b to create the branch, --path, --tag), worktree list shows all worktrees with live branch and dirty status, and worktree rm removes the directory and registry entry together (refusing dirty trees without --force).
  • Add soko ctx — save and restore workspace contexts: ctx save records each repo's branch and stashes dirty trees under a per-context message, ctx switch checks the branches back out and pops the stashes (refusing repos that are dirty right now), plus ctx list/show/drop.
  • Add soko sync — fetch all repos, then fast-forward the ones that are provably safe (clean, upstream, not diverged); dirty, diverged, and fetch-only-behind repos are reported as needing attention. Supports positional repos, --tag, --fetch-only, --no-worktrees, and --json.
  • Add soko apply to copy a file into many repos at once, with a diff preview and dry-run-by-default safety
  • Add a stable error_code field to per-repo JSON failures in pull, fetch, exec, clean, and stash
  • Add a global --perf flag (and SOKO_PERF) reporting per-repo and aggregate timing for status, fetch, pull, and exec
  • soko grep now highlights the matched substring within each result line

Chores

  • Document soko snapshot, soko apply, the soko ui dashboard keys, worktree tag inheritance, the global --perf flag, and JSON error_code in the README

v0.20.0

Choose a tag to compare

@CelikE CelikE released this 08 Jun 17:25
d7eece5

0.20.0

Features

  • Add a persistent --quiet/-q flag (and SOKO_QUIET env) that suppresses info lines, hints, progress, and summary footers while leaving tables, errors, exit codes, and --json untouched
  • Add soko annotate to attach freeform metadata (owner, status, priority, note, or any key) to a repo, and filter soko list / soko status by it with --meta key=value
  • Suggest the closest registered repo name when cd, go, open, or remove is given a name that matches nothing — no repo matching: autth — did you mean: auth?
  • Give config path, config get, and config set a --json contract, and add config list to dump the effective configuration as a table or JSON
  • Add soko remotes to show each repo's origin URL and upstream tracking, flagging repos with no remote or no upstream; supports --tag, --missing-upstream, and --json
  • Add soko grep to run git grep across all (or tag/repo-filtered) repos in parallel, grouped by repo, with -i/--regexp/--files-only/--no-worktrees and --json
  • Add --select to clean, prune, and remove --all to interactively pick which repos the destructive operation touches before confirming (narrow-only, TTY-gated)
  • Add soko health to rank repos by an urgency score, most neglected first
  • Add soko pull to pull all (or specific) registered repos in parallel — fast-forward only by default, with --rebase, --tag, and --no-worktrees flags. Branches with no upstream are skipped rather than reported as failures.

Chores

  • Document the remotes, annotate, and stats commands, the --quiet/SOKO_QUIET, --meta, --missing-upstream, and annotate flags, and config list/--json; correct the source-build Go version to 1.26+
  • Git-ignore the local assessment and improvement-proposal docs (docs/ASSESSMENT.md, docs/improvements/), matching the existing docs/features/ planning-doc convention

v0.19.0

Choose a tag to compare

@CelikE CelikE released this 05 Jun 11:15
a1a4c7b

0.19.0

Features

  • Accept an optional filter argument on soko go to pre-narrow the picker by name
  • Automatic repo discovery with soko discover — opt in with soko discover on and repos register themselves the first time you cd into them, no soko scan needed. Driven by the shell hook (fires on directory change); scope it with --root, apply --tags, and skip paths with --ignore. Skips submodules, the home directory, node_modules/vendor, and non-interactive shells. soko doc reports discovery status
  • Prune deleted repos with soko prune — remove registry entries whose directories no longer exist on disk (cascading to their linked worktrees), with --dry-run/--force/--json and --tag filtering. status and list now warn when registered repos have gone missing
  • Workspace stats with soko stats — aggregate repo counts, sizes, and commit totals alongside health signals (dirty, behind, stale branches, no remote) and 30-day activity

v0.18.1

Choose a tag to compare

@CelikE CelikE released this 13 Apr 18:51

0.18.1

Features

  • Show a live progress counter during soko fetch so users can see how many repos have been fetched

v0.18.0

Choose a tag to compare

@CelikE CelikE released this 13 Apr 12:42

0.18.0

Bug Fixes

  • Resolve symlinks in init to prevent duplicate registrations when paths differ from scan
  • Exit with non-zero code when fetch --json encounters failures, consistent with table output
  • Require --force or --dry-run when using clean --json to prevent interactive prompts in JSON output
  • Output empty JSON array instead of plain text when stash pop --json finds no stashes
  • Accept repo name arguments in fetch for filtering, consistent with status and diff
  • Reject positional arguments to shell-init with a helpful hint (e.g. did you mean --fish?)
  • Return non-zero exit code when open fails and format errors as JSON when --json is set
  • Reject negative and zero values for report --days with a clear error message
  • Reject alias names that shadow built-in commands instead of silently creating dead aliases
  • Add column headers and separator line to soko list --group output

v0.17.6

Choose a tag to compare

@CelikE CelikE released this 09 Apr 14:04

0.17.6

Bug Fixes

  • Fix PATH column alignment in soko list when some repos have tags and others don't

v0.17.5

Choose a tag to compare

@CelikE CelikE released this 09 Apr 13:57

0.17.5

Bug Fixes

  • Add missing shell completions: repo name completion for status, diff, stash, report, clean positional args and tag completion for init, scan --tag flags

v0.17.4

Choose a tag to compare

@CelikE CelikE released this 09 Apr 13:50

0.17.3

Features

  • User-defined command aliases with soko alias set/list/remove — shortcuts stored in config that expand transparently when invoked
  • Delete merged branches across repos with soko clean — detects default branch, confirms before deleting, supports --dry-run, --prune, and --force
  • Activity report with soko report — summarize commit history across repos with tree-style output, timestamps, branch info, and author filtering
  • Positional repo args for soko status, soko diff, and soko stash — filter to specific repos by name or prefix match

Bug Fixes

  • soko exec with no command now returns an error (exit 1) instead of silently exiting 0
  • Return empty JSON array [] instead of plain text for --json when diff, stash, or alias list have no results
  • Show "no repos found matching" instead of misleading "tag filter" message when positional repo args match nothing
  • Correct singular/plural grammar across all CLI output — "1 repo" not "1 repos", "1 branch" not "1 branchs"
  • Fix release workflow: prevent shell expansion of backticks in changelog output when updating GitHub release notes

Chores

  • Code quality improvements: extracted output.RenderJSON helper (replacing 13 duplicate blocks), refactored large closures in scan and doc commands, consistent naming across result structs