Repository navigation
Releases
Releases · CelikE/soko
v0.23.0
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 ...
v0.22.0
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 sokomanual 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
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
--tagfilters (status, sync, fetch, list, etc.) include worktrees of tagged repos. Retagging the parent instantly re-scopes its worktrees;tag removeon a worktree only removes own tags and errors on inherited ones. soko uigains its first mutating key:Pfast-forward pulls the selected repo after a confirmation prompt, runs asynchronously, and records a journal entry sosoko undorewinds it to the pre-pull SHA. Satisfies feature 44's scope guard — mutations only once undo exists.soko undoreverts the last destructive operation via a capped pre-image journal beside the config (journal.yaml).soko cleannow records the branches it deletes, sosoko undorecreates them at their exact SHAs;soko undo --listshows the journal. This is the trust layer that will unlock mutating keys insoko ui.soko uigains 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/afor 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 worktreeto manage git worktrees across repos:worktree add <repo> <branch>creates and registers in one step (with-bto create the branch,--path,--tag),worktree listshows all worktrees with live branch and dirty status, andworktree rmremoves the directory and registry entry together (refusing dirty trees without--force). - Add
soko ctx— save and restore workspace contexts:ctx saverecords each repo's branch and stashes dirty trees under a per-context message,ctx switchchecks the branches back out and pops the stashes (refusing repos that are dirty right now), plusctx 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
0.20.0
Features
- Add a persistent
--quiet/-qflag (andSOKO_QUIETenv) that suppresses info lines, hints, progress, and summary footers while leaving tables, errors, exit codes, and--jsonuntouched - Add
soko annotateto attach freeform metadata (owner, status, priority, note, or any key) to a repo, and filtersoko list/soko statusby it with--meta key=value - Suggest the closest registered repo name when
cd,go,open, orremoveis given a name that matches nothing —no repo matching: autth — did you mean: auth? - Give
config path,config get, andconfig seta--jsoncontract, and addconfig listto dump the effective configuration as a table or JSON - Add
soko remotesto 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 grepto rungit grepacross all (or tag/repo-filtered) repos in parallel, grouped by repo, with-i/--regexp/--files-only/--no-worktreesand--json - Add
--selecttoclean,prune, andremove --allto 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 pullto pull all (or specific) registered repos in parallel — fast-forward only by default, with--rebase,--tag, and--no-worktreesflags. 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, andconfig 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 existingdocs/features/planning-doc convention
v0.19.0
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 withsoko discover onand repos register themselves the first time you cd into them, nosoko scanneeded. 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 docreports 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/--jsonand--tagfiltering.statusandlistnow 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
v0.18.0
0.18.0
Bug Fixes
- Resolve symlinks in
initto prevent duplicate registrations when paths differ fromscan - Exit with non-zero code when
fetch --jsonencounters failures, consistent with table output - Require
--forceor--dry-runwhen usingclean --jsonto prevent interactive prompts in JSON output - Output empty JSON array instead of plain text when
stash pop --jsonfinds no stashes - Accept repo name arguments in
fetchfor filtering, consistent withstatusanddiff - Reject positional arguments to
shell-initwith a helpful hint (e.g.did you mean --fish?) - Return non-zero exit code when
openfails and format errors as JSON when--jsonis set - Reject negative and zero values for
report --dayswith 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 --groupoutput
v0.17.6
v0.17.5
v0.17.4
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, andsoko stash— filter to specific repos by name or prefix match
Bug Fixes
soko execwith no command now returns an error (exit 1) instead of silently exiting 0- Return empty JSON array
[]instead of plain text for--jsonwhen 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.RenderJSONhelper (replacing 13 duplicate blocks), refactored large closures in scan and doc commands, consistent naming across result structs