CLI Reference

CORE Core libraries and debugging tools for the Grove ecosystem

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 groved Grove ecosystem daemon 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.

CORE WS Navigate and explore Grove workspaces

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.

CORE WS CWD Get workspace information for current working directory

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

CORE WORKTREES Manage git worktrees across workspaces

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.

CORE WORKTREES LIST Show git worktrees for all workspaces

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

CORE PATHS Print the XDG-compliant paths used by Grove

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

CORE LOGS Aggregate and display logs from Grove workspaces

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

CORE EDITOR Open a file or directory in the dedicated editor window

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)

CORE TMUX Tmux window management commands

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.

CORE TMUX EDITOR Open a file or directory in the dedicated editor window

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)

CORE GROVED Grove ecosystem daemon

Centralized state management daemon for the grove ecosystem.

USAGE core groved [command]

COMMANDS config Show running daemon configuration monitor Monitor daemon activity in real-time start Start the daemon status Check daemon status stop Stop the running daemon

Flags: -h/—help

Use “core groved [command] —help” for more information.

CORE GROVED CONFIG Show running daemon configuration

Query the running daemon to show its active configuration intervals.

USAGE core groved config [flags]

FLAGS -h, —help help for config

CORE GROVED MONITOR Monitor daemon activity in real-time

Subscribe to the daemon event stream and print activity logs.

USAGE core groved monitor [flags]

FLAGS -h, —help help for monitor

CORE GROVED START Start the daemon

Start the grove daemon in foreground mode.

USAGE core groved start [flags]

FLAGS —collectors Comma-separated list of collectors to enable (git, session, workspace, plan, note) (default: [all]) -h, —help help for start —pprof-port Port to start pprof server on (0 to disable) (default: 0)

CORE GROVED STATUS Check daemon status

USAGE core groved status [flags]

FLAGS -h, —help help for status

CORE GROVED STOP Stop the running daemon

USAGE core groved stop [flags]

FLAGS -h, —help help for stop

CORE VERSION Print the version information for this binary

USAGE core version [flags]

FLAGS -h, —help help for version —json Output version information in JSON format