gg_multi_workspace 4.1.1

Workspace management of the gg_multi tool family - adding repos and organizations, importing, creating and removing tickets, syncing the ocean, listing workspaces.

gg_multi_workspace

Workspace management of the gg_multi tool family - adding repos and organizations, importing and creating tickets, removing repos and tickets, syncing the ocean, listing and opening workspaces.

gg_multi manages multi-package workspaces and orchestrates editing, reviewing and publishing across all repos of a ticket. This package holds the commands that build and maintain those workspaces; the underlying model lives in gg_multi_core.

Commands

Command	Purpose
do init workspace	initialise the ocean in the current directory
do add <target>	add a repo, owner/repo, url, regexp or a whole organisation to the workspace
do import ticket <path|url>	reproduce a whole ticket from a ticket.json
do create ticket <id>	create tickets/<id>/ with ticket.json file and .code-workspace
do create graph	write the dependency graph of the workspace as mermaid or json
do rm repo <name…>	delete repos from the current ticket (never from the ocean)
do rm ticket [<id>...]	close tickets: delete remote branches, move the whole folder to .trash
do upgrade ocean	sync .ocean with every registered organisation: clone new repos, trash gone ones
do code	open the current ticket in VS Code
do init claude	aggregate each repo's CLAUDE.md into one ticket-level CLAUDE.md
do exec cmd <cmd>	run a shell command in every ticket repo in dependency order
do ls repos|organizations|deps|tickets	list workspace contents with metadata

Targets as regular expressions

A do add target may be a regular expression selecting repositories the ocean already holds:

gg do add "ds_.+"        # every ocean repo whose name starts with ds_
gg do add "gg_one.*"     # gg_one, gg_one_commit, gg_one_core, …

The pattern is anchored — it has to describe the whole name — so gg do add gg still adds the repository named gg and not every name carrying those two letters. A target matching no ocean repo is used as before, which is what keeps a url and a repository the ocean does not hold yet addressable by name. A pattern selecting more than one repository reports what it expanded to.

Patterns only select what the ocean already has; they discover nothing on the git platform. Use --org, or run do upgrade ocean first.

Backend helpers include cloning and branch creation (git_handler.dart), repo setup (repo_setup.dart), the add logic (add_repository_helper.dart), .gitattributes upkeep (git_attributes.dart), lock-file gitignore handling (gitignore_lock_files.dart), legacy git-hook removal (legacy_git_hooks.dart) and localized-override cleanup (dependency_overrides.dart).

License

gg_multi_workspace is licensed under the terms specified in the LICENSE file.