diff --git a/docs/tools/drydock.mdx b/docs/tools/drydock.mdx new file mode 100644 index 0000000..7637a4d --- /dev/null +++ b/docs/tools/drydock.mdx @@ -0,0 +1,22 @@ +--- +title: drydock +description: drydock fleet view of uncommitted, unpushed, and unreleased work, scanning the ghq root. +--- + +drydock lists what is uncommitted, unpushed, and unreleased across every repo under its roots. + +| | | +| --- | --- | +| Source | `dot_config/drydock/config.toml` | +| Target | `~/.config/drydock/config.toml` (holds live beside it in `holds.toml`, unmanaged) | +| Packages | Not declared in `packages.yaml`; installed with cargo (`~/.cargo/bin/drydock`) | + +## config.toml + +```toml ~/.config/drydock/config.toml +roots = ["~/Code"] +``` + +Only `roots` is set; everything else stays at drydock's defaults (`drydock config show` prints the effective config). The root is the ghq root, where repos sit at `//`, within the default `max_depth = 4`. `~/Projects` would find nothing: it holds only symlinks (made by [`projects-sync`](/shell/scripts#projects-sync)), and drydock does not follow symlinks by default (`follow_symlinks = false`). + +`drydock --root ` replaces the configured roots for one run. diff --git a/docs/tools/index.mdx b/docs/tools/index.mdx index 2de2ebf..0d42abd 100644 --- a/docs/tools/index.mdx +++ b/docs/tools/index.mdx @@ -22,6 +22,7 @@ Packages come from `.chezmoidata/packages.yaml` and are installed by `run_onchan | [bat](/tools/bat) | bat | `dot_config/bat/` | cyberdream tmTheme | | [Topgrade](/tools/topgrade) | topgrade | `dot_config/topgrade.toml` | n/a | | [Hunk](/tools/hunk) | hunk diff viewer | `dot_config/hunk/config.toml` | `auto` | +| [drydock](/tools/drydock) | drydock repo fleet view | `dot_config/drydock/config.toml` | n/a | | [television](/tools/television) | tv fuzzy picker, custom cables | external repo via `.chezmoiexternals/television.toml` | `cyberdream-transparent` | | [LeetCode](/tools/leetcode) | leetcode CLI, `lc-elir` | `dot_leetcode/` | n/a | diff --git a/docs/tools/meta.ts b/docs/tools/meta.ts index 44b9e2f..049b4fd 100644 --- a/docs/tools/meta.ts +++ b/docs/tools/meta.ts @@ -15,6 +15,7 @@ export default defineMeta({ "television", "topgrade", "hunk", + "drydock", "leetcode", ], });