grove
v0.6.1 (2026-02-10)
This release integrates nav with grove-daemon, transforming the navigation tool into a thin client that leverages centralized services. Key improvements include the adoption of the daemon client for workspace discovery with transparent local fallback (cd7fca1) and the implementation of real-time enrichment updates via Server-Sent Events (SSE) (c6fcbaa). The update also introduces smart scanning capabilities by syncing visible workspace focus with the daemon (3ddc190) and ensures data consistency by triggering daemon refreshes upon manual project reloads (0731dd3). Additionally, duplicate enrichment logic has been refactored and consolidated into the core package (d122a4c).
Features
- Integrate with daemon for real-time enrichment updates via SSE (c6fcbaa)
- Integrate daemon focus API for smart scanning of visible workspaces (3ddc190)
- Trigger daemon refresh on manual project reload in TUI (0731dd3)
- Use daemon client for workspace discovery with local fallback (cd7fca1)
Refactor
- Make nav a thin client delegating to core enrichment (d122a4c)
File Changes
cmd/gmux/key_manage.go | 9 ++
cmd/gmux/tui.go | 169 ++++++++++++++++-----
cmd/gmux/tui_io.go | 353 +++++++++++++++++++++++---------------------
internal/manager/enrich.go | 291 ++++++------------------------------
internal/manager/manager.go | 88 ++++++++---
5 files changed, 442 insertions(+), 468 deletions(-)v0.6.0 (2026-02-02)
Configuration handling sees significant improvements with the migration to XDG-compliant paths, renaming directory references from gmux to nav (63e494e), along with full support for TOML configuration files (a73cc48, d785281, 3ff2012). These changes ensure better standard compliance and flexibility in user settings.
The sessionizer TUI has been enhanced with a new toggleable CX (Context) column (ba33e18) that provides accurate per-line token counts and improved display behavior (5e5a628). Additionally, tmux integration has been robustified to respect GROVE_TMUX_SOCKET for better environment isolation (e7180e8) and now utilizes shared core command implementations (8092688).
Features
- Migrate nav to XDG-compliant paths (63e494e)
- Add toggleable CX column with accurate per-line token counts (ba33e18)
- Add configuration/readme update (db3b57e)
- Update readme/overview (6704b64)
Bug Fixes
- Use XDG paths for nav/gmux configuration and binaries (890d59a)
- Add toml tags to TmuxConfig for proper serialization (a73cc48)
- Support TOML format when saving tmux config (d785281)
- Respect GROVE_TMUX_SOCKET in all tmux exec calls (e7180e8)
- Improve CX column display and update behavior (5e5a628)
- Update VERSION_PKG to grovetools/core path (d6c297f)
- Git icons (cc70cdf)
- Use nav (01d3bd9)
- Rm logo overview (35027bf)
Refactoring
- Use config.FindConfigFile for TOML support (3ff2012)
- Use core’s tmux.Command() instead of local implementation (8092688)
- Update docgen title to match package name (81b747c)
Documentation
- Add MIT License (c0b77dc)
- Add concept lookup instructions to CLAUDE.md (a5a42f8)
Chores
- Restore release workflow (23060e0)
- Migrate grove.yml to grove.toml (3d6e571)
- Move README template to notebook (70b5162)
- Remove docgen files from repo (4b8f004)
- Move docs.rules to .cx/ directory (6b7be22)
- Update docs.json (125a9ca)
- Update go.mod for grovetools migration (c3ddeb7)
File Changes
{docs => .cx}/docs.rules | 0
.github/workflows/release.yml | 58 +++-------------
CLAUDE.md | 15 +++-
LICENSE | 21 ++++++
Makefile | 2 +-
README.md | 98 +++++++++++++-------------
cmd/gmux/key.go | 4 +-
cmd/gmux/key_manage.go | 3 +-
cmd/gmux/main.go | 3 +-
cmd/gmux/sessionize.go | 10 ++-
cmd/gmux/tui.go | 55 ++++++++++-----
cmd/gmux/tui_io.go | 153 ++++++++++++++++++++++++++++++-----------
cmd/gmux/tui_keymap.go | 24 +++----
cmd/gmux/tui_table.go | 50 +++++++-------
cmd/gmux/windows.go | 31 ++++-----
docs/01-overview.md | 73 +++++++++++++-------
docs/06-configuration.md | 12 ++++
docs/README.md.tpl | 6 --
docs/docgen.config.yml | 39 -----------
go.mod | 21 +++++-
go.sum | 73 +++++++++++++++++---
grove.toml | 10 +++
grove.yml | 9 ---
internal/manager/config.go | 6 +-
internal/manager/enrich.go | 3 +-
internal/manager/manager.go | 76 ++++++++++++++------
internal/manager/project.go | 10 +++
internal/manager/state.go | 38 +++++-----
pkg/docs/docs.json | 48 ++-----------
pkg/tmux/tmux.go | 10 +++
tests/e2e/scenarios.go | 26 ++++---
tests/e2e/scenarios_sz_cols.go | 32 ++++-----
tests/e2e/tmux_scenarios.go | 85 +++++++++++++++++------
tmux.schema.json | 2 +-
34 files changed, 662 insertions(+), 444 deletions(-)v0.1.1-nightly.2817cba (2025-10-03)
v0.1.0 (2025-10-01)
This release introduces significant improvements to the Terminal User Interfaces (TUIs) in gmux. The sessionizer (gmux sz) and key manager (gmux key manage) now use the centralized Kanagawa theme for a consistent look and feel across the Grove ecosystem (4224b82). A standardized help system has been implemented in both interfaces, providing more detailed and structured guidance (ca2cc26). Navigation in the sessionizer is now more intuitive with the addition of vim-style keys (j/k, ctrl+u/d, g/G) and a clearer separation between navigation and filtering modes. The key binding for closing a session has been changed from ctrl+d to X to avoid conflicts (ca2cc26).
A comprehensive documentation suite has been added, covering all aspects of gmux from getting started guides to a full command reference (88e78ad, d04d8be). The project’s README now features an automatically generated Table of Contents to improve navigability (4078852).
Internal architecture has been refactored to use the centralized tmux client from grove-core, removing duplicated code and standardizing interactions with tmux (d6822e2, 873ebc2). The CI/CD pipeline has also seen improvements, with the release process now sourcing its notes directly from the CHANGELOG file for better consistency (e3bf988).
Features
- Implement standardized help components and improved vim-style navigation in TUIs (ca2cc26)
- Migrate TUI components to use the centralized Kanagawa theme for visual consistency (4224b82)
- Add comprehensive project documentation and generation configuration (d04d8be)
- Add Table of Contents generation for README and update docgen configuration (4078852)
- Update release workflow to extract release notes from CHANGELOG.md (e3bf988)
- Improve documentation generation configuration (b26e4b8)
Bug Fixes
- Update CI workflow to correctly disable execution using ‘branches: [ none ]’ (3658b82)
Code Refactoring
- Migrate from local implementation to the centralized tmux client from grove-core (d6822e2)
- Update internal manager to use the centralized grove-core tmux client (873ebc2)
- Standardize docgen.config.yml key order and settings (582aa2f)
Documentation
- Add a comprehensive documentation structure and generation prompts (88e78ad)
- Update docgen configuration and add generated documentation files (70db90d)
- Simplify documentation structure to four main sections (50f3c79)
- Update docgen configuration and README templates for TOC generation (9d99352)
- Simplify installation instructions to point to the main Grove ecosystem guide (be380ce)
Chores
- Temporarily disable CI workflow (e24dc3d)
- Update .gitignore to track CLAUDE.md and ignore go.work files (ac2be9f)
Continuous Integration
- Remove redundant test execution from the release workflow (02c4606)
File Changes
.github/workflows/ci.yml | 4 +-
.github/workflows/release.yml | 24 +-
.gitignore | 3 +
CLAUDE.md | 30 +
README.md | 152 +--
cmd/gmux/key.go | 25 +-
cmd/gmux/key_manage.go | 93 +-
cmd/gmux/launch.go | 10 +-
cmd/gmux/main.go | 6 +-
cmd/gmux/session.go | 8 +-
cmd/gmux/sessionize.go | 496 ++++++----
cmd/gmux/start.go | 5 +-
cmd/gmux/wait.go | 4 +-
docs/01-introduction.md | 66 ++
docs/01-overview.md | 45 +
docs/02-examples.md | 108 ++
docs/02-installation.md | 27 +
docs/03-configuration.md | 115 +++
docs/03-getting-started.md | 110 +++
docs/04-command-reference.md | 396 ++++++++
docs/04-configuration.md | 184 ++++
docs/05-live-sessionizer.md | 160 +++
docs/06-session-hotkeys.md | 180 ++++
docs/07-command-reference.md | 177 ++++
docs/08-advanced-topics.md | 194 ++++
docs/09-contributing.md | 132 +++
docs/README.md.tpl | 6 +
docs/docgen.config.yml | 40 +
docs/docs.rules | 1 +
docs/images/grove-tmux-readme.svg | 1791 ++++++++++++++++++++++++++++++++++
docs/prompts/01-overview.md | 31 +
docs/prompts/02-examples.md | 20 +
docs/prompts/03-configuration.md | 20 +
docs/prompts/04-command-reference.md | 21 +
internal/manager/manager.go | 56 +-
pkg/docs/docs.json | 174 ++++
pkg/tmux/client.go | 39 -
pkg/tmux/doc.go | 30 -
pkg/tmux/example_test.go | 63 --
pkg/tmux/launch.go | 79 --
pkg/tmux/launch_test.go | 159 ---
pkg/tmux/monitor.go | 26 -
pkg/tmux/monitor_test.go | 137 ---
pkg/tmux/session.go | 89 --
pkg/tmux/session_test.go | 127 ---
pkg/tmux/types.go | 14 -
46 files changed, 4527 insertions(+), 1150 deletions(-)v0.0.15 (2025-09-17)
Chores
- bump dependencies
v0.0.14 (2025-09-13)
Chores
- update Grove dependencies to latest versions
v0.0.12 (2025-08-27)
Bug Fixes
- add version cmd
- address code review feedback
Chores
- deps: bump dependencies
Features
- improve first-run UX for gmux sessionizer
Unreleased
Features
- sessionizer: Add interactive first-run setup for
gmux szto guide new users through configuration
Bug Fixes
- sessionizer: Improve error messages for malformed
project-search-paths.yamlfiles by including the file path - makefile: Fix dev target to use correct cmd/gmux directory
- launch: Update help text to use gmux instead of gtmux
v0.0.11 (2025-08-26)
Code Refactoring
- rename command directory from gtmux to gmux
v0.0.10 (2025-08-26)
Chores
- update readme (#1)
v0.0.9 (2025-08-26)
Bug Fixes
- improve worktree ordering and grouping in sessionizer
Features
- prioritize open tmux sessions in gmux sz search
v0.0.8 (2025-08-25)
Chores
- deps: sync Grove dependencies to latest versions
v0.0.7 (2025-08-25)
Bug Fixes
- disbale unit tests
- disbale lfs
v0.0.6 (2025-08-25)
Continuous Integration
- disable linting in workflow
Chores
- deps: bump dependencies
v0.0.5 (2025-08-25)
Bug Fixes
- prevent flashing in live sessionizer by only updating on actual changes
Features
- implement live sessionizer with automatic refresh
Chores
- deps: bump dependencies
- bump dependencies
v0.0.4 (2025-08-15)
Features
- improve sessionizer key mapping UX and Claude session filtering
- enhance Claude session integration in sessionizer
- add Claude session status indicator to sessionizer
- key to copy paths from session list
- add session management features to gmux sz
- implement automatic Git worktree discovery and hierarchical display
- add session status indicator to gmux sz command
- add sessionize command with smart features and key management
- add compact style for gmux list and improve key management UX
- add comprehensive key management commands with interactive UI
- tmux: add window management methods
Bug Fixes
- use configured repository name in session list and update tests to use gmux
- change binary to gmux
Chores
- bump deps
- fix linting issues in sessionizer
Tests
- fix E2E tests to match current list command output
Continuous Integration
- disable Git LFS to fix dependency download issues
v0.0.3 (2025-08-13)
Features
- add new tmux package and CLI commands
Code Refactoring
- standardize E2E binary naming and use grove.yml for binary discovery
Continuous Integration
- switch to Linux runners to reduce costs
- consolidate to single test job on macOS
- reduce test matrix to macOS with Go 1.24.4 only
Bug Fixes
- remove tmux pane numbering test that varies between versions
v0.0.2 (2025-08-12)
Bug Fixes
- makefile