Complete command reference for core.
USAGE core [command]
COMMANDS completion Generate the autocompletion script for the specified shell config-layers Display the layered configuration for the current context editor Open a file or directory in the dedicated editor window logs Aggregate and display logs from Grove workspaces nvim-demo Demo of embedded Neovim component open-in-window Runs a command in a dedicated, focused tmux window paths Print the XDG-compliant paths used by Grove tmux Tmux window management commands version Print the version information for this binary worktrees Manage git worktrees across workspaces ws Navigate and explore Grove workspaces
Flags: -c/--config, -h/--help, --json, -v/--verbose
Use "core [command] --help" for more information.
This command launches an interactive TUI to navigate and explore all workspaces discovered by Grove based on your configuration. It provides a hierarchical view of ecosystems, projects, and worktrees.
USAGE core ws [flags] core ws [command]
COMMANDS cwd Get workspace information for current working directory
Flags: -c/--config, -h/--help, --json, -v/--verbose
Use "core ws [command] --help" for more information.
Get the workspace information for the current working directory. This command uses GetProjectByPath to find the workspace containing the current directory.
USAGE core ws cwd [flags]
FLAGS -c, --config Path to grove.yml config file -h, --help help for cwd --json Output workspace in JSON format -v, --verbose Enable verbose logging
Manage and view git worktrees across all workspaces in the ecosystem.
USAGE core worktrees [command]
COMMANDS list Show git worktrees for all workspaces
Flags: -c/--config, -h/--help, --json, -v/--verbose
Use "core worktrees [command] --help" for more information.
Display git worktrees for each workspace in the ecosystem with their status. Only shows workspaces that have additional worktrees beyond the main one.
USAGE core worktrees list [flags]
FLAGS -c, --config Path to grove.yml config file -h, --help help for list --json Output in JSON format -v, --verbose Enable verbose logging
Print the XDG-compliant paths used by Grove.
This command outputs the paths in JSON format by default, making it easy to parse from scripts and other tools.
The paths follow the XDG Base Directory Specification:
- config_dir: Configuration files (grove.yml)
- data_dir: Persistent data (binaries, plugins, notebooks)
- state_dir: Runtime state (databases, logs, sessions)
- cache_dir: Temporary/regenerable data
- bin_dir: Grove binaries (subdirectory of data_dir)
USAGE core paths [flags]
FLAGS -h, --help help for paths
Streams logs from one or more workspaces. By default, shows logs from the current workspace only. Use --ecosystem to show logs from all workspaces.
USAGE core logs [flags]
FLAGS --also-show Temporarily show components/groups, overriding hide rules --compact Disable spacing between log entries (for pretty/full/rich formats) --component Show logs only from these components (acts as a strict whitelist) --ecosystem Show logs from all workspaces in the ecosystem -f, --follow Follow log output --format Output format: (default: text) • text • json • full • rich • pretty • pretty-text -h, --help help for logs --ignore-hide Temporarily show components/groups that would be hidden by config --json Output logs in JSON Lines format (shorthand for --format=json) --show-all Show all logs, ignoring any configured show/hide rules --tail Number of lines to show from the end of the logs (default: all) (default: -1) -i, --tui Launch the interactive TUI -w, --workspaces Filter by specific workspace names (comma-separated)
EXAMPLES # Follow logs from current workspace core logs -f
# Show logs from all workspaces in ecosystem core logs --ecosystem -f
# Get the last 100 log lines in JSON format core logs --tail 100 --json
# Follow logs from specific workspaces core logs -f -w my-project,another-project
# Show only the pretty CLI output (styled) core logs --format=pretty
# Show only the pretty CLI output (plain text, no ANSI) core logs --format=pretty-text
# Show full details with pretty output indented below each line core logs --format=full
Finds or creates a tmux window (default name "editor", index 1) and opens the specified file or current directory. By default, if the window exists, it is focused. New flags allow customizing the editor command, window name/index, and forcing a reset of the window.
USAGE core editor [file] [flags]
FLAGS --cmd Custom editor command to execute. The file path will be appended if provided. Defaults to $EDITOR or 'nvim'. -h, --help help for editor --reset If the editor window exists, kill it and start a fresh session. --window-index Index (position) for the editor window. (default: 1) --window-name Name of the target tmux window. (default: editor)
Commands for managing core tools in dedicated tmux windows.
USAGE core tmux [command]
COMMANDS editor Open a file or directory in the dedicated editor window
Flags: -h/--help
Use "core tmux [command] --help" for more information.
Finds or creates a tmux window (default name "editor", index 1) and opens the specified file or current directory. By default, if the window exists, it is focused. New flags allow customizing the editor command, window name/index, and forcing a reset of the window.
USAGE core tmux editor [file] [flags]
FLAGS --cmd Custom editor command to execute. The file path will be appended if provided. Defaults to $EDITOR or 'nvim'. -h, --help help for editor --reset If the editor window exists, kill it and start a fresh session. --vim-cmd Vim command to execute. If editor is already running, sends as :command. Otherwise starts with -c flag. --window-index Index (position) for the editor window. -1 means no positioning. (default: -1) --window-name Name of the target tmux window. (default: editor)
USAGE core version [flags]
FLAGS -h, --help help for version --json Output version information in JSON format