docs(docs): add drydock documentation and update tools index

This commit is contained in:
Prad Nukala committed 2026-10-15 14:26:51 -04:00
1 parent 48cdd166be
commit be902420a0
3 files changed
+24

No files matched your search

+22
View File
@@ -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 `<host>/<owner>/<repo>`, 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 <path>` replaces the configured roots for one run.
+1
View File
@@ -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 | | [bat](/tools/bat) | bat | `dot_config/bat/` | cyberdream tmTheme |
| [Topgrade](/tools/topgrade) | topgrade | `dot_config/topgrade.toml` | n/a | | [Topgrade](/tools/topgrade) | topgrade | `dot_config/topgrade.toml` | n/a |
| [Hunk](/tools/hunk) | hunk diff viewer | `dot_config/hunk/config.toml` | `auto` | | [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` | | [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 | | [LeetCode](/tools/leetcode) | leetcode CLI, `lc-elir` | `dot_leetcode/` | n/a |
+1
View File
@@ -15,6 +15,7 @@ export default defineMeta({
"television", "television",
"topgrade", "topgrade",
"hunk", "hunk",
"drydock",
"leetcode", "leetcode",
], ],
}); });