{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo-light.png\" alt=\"Grove logo\" width=\"120\">\n</p>\n\n<h1 align=\"center\">Grove (<code>gw</code>)</h1>\n\n<p align=\"center\"><b>grove</b> /ɡrōv/ <i>noun</i> — a small group of trees growing together.</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/nicksenap/grove/actions/workflows/ci.yml\"><img src=\"https://github.com/nicksenap/grove/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://github.com/nicksenap/grove/releases/latest\"><img src=\"https://img.shields.io/github/v/release/nicksenap/grove\" alt=\"Release\"></a>\n  <a href=\"https://github.com/nicksenap/grove/blob/master/LICENSE\"><img src=\"https://img.shields.io/github/license/nicksenap/grove\" alt=\"License\"></a>\n</p>\n\n## Why?\n\nMonorepos solve cross-project work, but not everyone has one. You've got separate repos, separate CI, separate deploys — and that's fine until you need to work across them.\n\nOne feature across three services means `git worktree add` three times, tracking three branches, jumping between three directories, cleaning up three worktrees when you're done. It's annoying.\n\nGrove gives you the multi-repo worktree workflow that monorepos get for free. One command, one workspace, all repos on the same branch.\n\n## Getting Started\n\n### 1. Install Grove\n\nPick **any one** of the following methods:\n\n**Homebrew**\n\n```bash\nbrew install nicksenap/grove/grove\n```\n\n**Go install**\n\n```bash\ngo install github.com/nicksenap/grove/cmd/gw@latest\n```\n\n**From source**\n\n```bash\ngit clone https://github.com/nicksenap/grove.git\ncd grove && go build -o gw ./cmd/gw\nmv gw /usr/local/bin/\n```\n\n### 2. Add shell integration\n\nThis enables `gw go` to change your working directory and auto-cds into new workspaces after `gw create`.\n\n**Bash / Zsh** — add to `.zshrc` or `.bashrc`:\n\n```bash\neval \"$(gw shell-init)\"\n```\n\n**Nushell** — generate and source the init file:\n\n```nu\ngw shell-init --shell nu | save -f ~/.config/nushell/grove.nu\n# then add to config.nu:\nsource grove.nu\n```\n\n## Upgrading\n\nIf you installed with Homebrew:\n\n```bash\nbrew update && brew upgrade grove\n```\n\n## Usage\n\n```bash\n# Register your repo directories (one-time)\ngw init ~/dev ~/work/microservices\n\n# Create a workspace: name the branch, pull repos from a preset or a list\ngw create -b feat/login -p backend        # repos from a saved preset\ngw create -b feat/login -r svc-a,svc-b    # …or an ad-hoc repo list\n\n# Work across the whole workspace\ngw go my-feature       # cd into the workspace\ngw status my-feature   # git status across every repo\ngw sync my-feature     # rebase all repos onto their base branch\ngw reset my-feature    # switch every repo back to the workspace branch, then sync\n\n# Clean up when done (destructive; use a pre_delete hook to enforce policy)\ngw delete my-feature   # removes worktrees, branches, and workspace files\n```\n\nInteractive menus support **type-to-search** filtering, arrow-key navigation (single-select), or arrow + tab (multi-select) with an `(all)` shortcut.\n\nPresets, plugins, hooks, and the full command reference are covered in [Workflows](openwiki/workflows.md) and [Operations](openwiki/operations.md).\n\n## Documentation\n\nFull documentation lives in the [OpenWiki](openwiki/quickstart.md) — start with the quickstart, then dive into the area you need:\n\n- [Quickstart](openwiki/quickstart.md) — install, first commands, key concepts, and a source map\n- [Architecture](openwiki/architecture.md) — layered design, data model, concurrency, and key decisions\n- [Workflows](openwiki/workflows.md) — how each command maps to code (create, sync, delete, presets…)\n- [Operations](openwiki/operations.md) — configuration, hooks, state, troubleshooting, and release process\n- [Integrations](openwiki/integrations.md) — plugins and workspace source provenance\n\n### Focused topic guides\n\n- [Hooks](docs/hooks.md) — global hooks (terminal integration) & per-repo hooks (`.grove.toml`)\n- [Plugins](docs/plugins.md) — extend gw with external commands\n- [Recipes](docs/recipe-v1.md) — strict schema, [workspace creation](docs/recipe-execution.md), and the [prepared-claim spike](docs/prepared-workspace-claim-spike.md)\n- [AI coding tools](docs/ai-tools.md) — vendor-neutral agent workflows\n\n## Requirements\n\nNo dependencies — single static binary. Requires `git` on PATH.\n",
  "bytes": 4290,
  "sha": "a9943faf6e3b5497b0c168210a05be5a344b618a8e1cc3ec1d36355b2aa08a77",
  "repo_slug": "nicksenap/grove",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_nicksenap_grove_openwiki_index_md_ac6fba0f/readme"
}