gsd-meta-manager

Terminal dashboard for multiple Get-Shit-Done workflow projects

TLDR

Launch the TUI showing all registered GSD projects

$ gsd-meta-manager

Register a project directory in the global registry

$ gsd-meta-manager add [path/to/project]

Register with a custom alias

$ gsd-meta-manager add [path/to/project] [alias]

Remove a project from the registry by name or alias

$ gsd-meta-manager remove [project]

List all registered projects on stdout

$ gsd-meta-manager list

Use a non-default config file

$ gsd-meta-manager --config [path/to/config.json]

Show the version

$ gsd-meta-manager --version

SYNOPSIS

gsd-meta-manager [--config FILE] [subcommand] [args]gsd-meta-manager add PATH [ALIAS]gsd-meta-manager remove PROJECTgsd-meta-manager list

gsd-meta-manager is a Rust terminal UI that aggregates state from many GSD ("Get Shit Done") workflow projects into a single dashboard. It reads project state directly from disk, auto-detects running Claude Code sessions tied to GSD projects, and shows progress without any background daemon.Each registered project can be inspected through a 10-tab detail view: Phases, Roadmap (rendered as an ASCII DAG), Backlog, Git History, Pipeline, Queue, Sessions, Archive, Config, and Docs. The intent is to make multi-project status the default view rather than something assembled by hand from many terminals.

PARAMETERS

--config FILE

Override the default config file location.

--version

Print the version number and exit.

--help

Display the help message.

CONFIGURATION

~/.config/gsd-meta-manager/config.json

Default registry file. Stores the list of registered project paths and aliases. Overridable with --config.

SUBCOMMANDS

add PATH [ALIAS]

Register the GSD project at PATH in the global registry. ALIAS sets a custom display name.

remove PROJECT

Remove a project from the registry, identified by its alias or path.

list

Print all registered projects.

help [SUBCOMMAND]

Show help for a specific subcommand.

KEY BINDINGS

j, k

Move down or up in the project list.

Enter

Open the detail view for the selected project.

Tab, Shift+Tab

Switch between detail tabs.

Activate search and filter mode.

Add a new project interactively.

Create a brand-new GSD project.

Delete the selected project from the registry.

Display the in-app help.

Quit the application.

CAVEATS

The tool only reflects state that already lives in each project on disk; it does not run pipelines, edit code, or push commits. Projects must already follow the GSD layout for tabs such as Phases and Roadmap to render anything meaningful.

HISTORY

gsd-meta-manager was published by bitcreed in 2026 under the MIT license. It is distributed through crates.io and requires Rust 1.85 or newer to build from source.