Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Add encourage-issues callout to list help text

Maximilian Roosb7fb8a9a1c7a
diff --git a/README.md b/README.md
index 308105ac7..1925bca2c 100644
--- a/README.md
+++ b/README.md
@@ -138,7 +138,7 @@ $ wt config shell install
## Contributing
- ⭐ Star the repo
-- [Open an issue](https://github.com/max-sixty/worktrunk/issues/new?title=&body=%23%23%20Description%0A%0A%3C!--%20Describe%20the%20bug%20or%20feature%20request%20--%3E%0A%0A%23%23%20Context%0A%0A%3C!--%20Any%20relevant%20context%3A%20your%20workflow%2C%20what%20you%20were%20trying%20to%20do%2C%20etc.%20--%3E) — feedback, feature requests, or [a worktree friction we don't yet solve](https://github.com/max-sixty/worktrunk/issues/new?title=Worktree%20friction%3A%20&body=%23%23%20The%20friction%0A%0A%3C!--%20What%20worktree-related%20task%20is%20still%20painful%3F%20--%3E%0A%0A%23%23%20Current%20workaround%0A%0A%3C!--%20How%20do%20you%20handle%20this%20today%3F%20--%3E%0A%0A%23%23%20Ideal%20solution%0A%0A%3C!--%20What%20would%20make%20this%20easier%3F%20--%3E)
+- [Open an issue](https://github.com/max-sixty/worktrunk/issues/new?title=&body=%23%23%20Description%0A%0A%3C!--%20Describe%20the%20bug%20or%20feature%20request%20--%3E%0A%0A%23%23%20Context%0A%0A%3C!--%20Any%20relevant%20context%3A%20your%20workflow%2C%20what%20you%20were%20trying%20to%20do%2C%20etc.%20--%3E) — feedback, feature requests, even a small friction or imperfect user message, or [a worktree pain not yet solved](https://github.com/max-sixty/worktrunk/issues/new?title=Worktree%20friction%3A%20&body=%23%23%20The%20friction%0A%0A%3C!--%20What%20worktree-related%20task%20is%20still%20painful%3F%20--%3E%0A%0A%23%23%20Current%20workaround%0A%0A%3C!--%20How%20do%20you%20handle%20this%20today%3F%20--%3E%0A%0A%23%23%20Ideal%20solution%0A%0A%3C!--%20What%20would%20make%20this%20easier%3F%20--%3E)
- Share: [X](https://twitter.com/intent/tweet?text=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management&url=https%3A%2F%2Fworktrunk.dev) · [Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fworktrunk.dev&title=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management) · [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fworktrunk.dev)
> ## 📚 Full documentation at [worktrunk.dev](https://worktrunk.dev) 📚
diff --git a/docs/content/faq.md b/docs/content/faq.md
index 1b4b77ced..5de0e2316 100644
--- a/docs/content/faq.md
+++ b/docs/content/faq.md
@@ -159,7 +159,7 @@ $ cargo test --test integration --features shell-integration-tests
## How can I contribute?
- Star the repo
-- Try it out and [open an issue](https://github.com/max-sixty/worktrunk/issues) with feedback
+- Try it out and [open an issue](https://github.com/max-sixty/worktrunk/issues) with feedback — even small annoyances
- What worktree friction does Worktrunk not yet solve? [Tell us](https://github.com/max-sixty/worktrunk/issues)
- Send to a friend
- Post about it on [X](https://twitter.com/intent/tweet?text=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management&url=https%3A%2F%2Fworktrunk.dev), [Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fworktrunk.dev&title=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management), or [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fworktrunk.dev)
diff --git a/docs/content/list.md b/docs/content/list.md
index 998fa082b..1a21234c8 100644
--- a/docs/content/list.md
+++ b/docs/content/list.md
@@ -257,6 +257,8 @@ When `main_state == "integrated"`: `"ancestor"` `"trees_match"` `"no_added_chang
`"passed"` `"running"` `"failed"` `"conflicts"` `"no-ci"` `"error"`
+Missing a field that would be generally useful? [Open an issue](https://github.com/max-sixty/worktrunk/issues).
+
## See also
- [wt select](@/select.md) — Interactive worktree picker with live preview
diff --git a/src/cli.rs b/src/cli.rs
index 8bb9b8bf2..40670330a 100644
--- a/src/cli.rs
+++ b/src/cli.rs
@@ -2104,6 +2104,8 @@ When `main_state == "integrated"`: `"ancestor"` `"trees_match"` `"no_added_chang
`"passed"` `"running"` `"failed"` `"conflicts"` `"no-ci"` `"error"`
+Missing a field that would be generally useful? Open an issue at https://github.com/max-sixty/worktrunk.
+
## See also
- [wt select](@/select.md) — Interactive worktree picker with live preview
diff --git a/src/main.rs b/src/main.rs
index 15047bfa3..edd23576d 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -375,6 +375,8 @@ fn handle_help_page(args: &[String]) {
/// Transforms plain text like "`●` green" into colored HTML spans for web rendering.
/// This is the web-docs counterpart to md_help::colorize_status_symbols() which
/// produces ANSI codes for terminal output.
+///
+/// Also converts plain URL references to markdown links for web docs.
fn colorize_ci_status_for_html(text: &str) -> String {
text
// CI status colors (in table cells)
@@ -384,6 +386,13 @@ fn colorize_ci_status_for_html(text: &str) -> String {
.replace("`●` yellow", "<span style='color:#a60'>●</span> yellow")
.replace("`⚠` yellow", "<span style='color:#a60'>⚠</span> yellow")
.replace("`●` gray", "<span style='color:#888'>●</span> gray")
+ // Convert plain URL references to markdown links for web docs
+ // CLI shows: "Open an issue at https://github.com/max-sixty/worktrunk."
+ // Web shows: "[Open an issue](https://github.com/max-sixty/worktrunk/issues)."
+ .replace(
+ "Open an issue at https://github.com/max-sixty/worktrunk.",
+ "[Open an issue](https://github.com/max-sixty/worktrunk/issues).",
+ )
}
/// Increase markdown heading levels by one (## -> ###, ### -> ####, etc.)
diff --git a/src/md_help.rs b/src/md_help.rs
index 75e50ef13..52c4441c7 100644
--- a/src/md_help.rs
+++ b/src/md_help.rs
@@ -172,6 +172,12 @@ fn render_table_with_termimad(lines: &[&str], indent: &str, max_width: Option<us
}
/// Strip markdown links, keeping only the link text: `[text](url)` -> `text`
+///
+/// Limitation: Links in clap help text may be broken across lines by clap's wrapping
+/// before this function runs. To support arbitrary markdown links in `--help`:
+/// TODO: Set `cmd.term_width(0)` to disable clap's wrapping, then let
+/// `render_markdown_in_help_with_width` handle all wrapping after stripping links.
+/// This would allow `[text](url)` syntax in cli.rs to work for both terminal and web.
fn strip_markdown_links(line: &str) -> String {
let mut result = String::new();
let mut chars = line.chars().peekable();
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
index 7a60f3d01..8a9ccbb78 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -264,6 +264,8 @@ When main_state == "integrated": "ancestor" "trees_match"[0
"passed" "running" "failed" "conflicts" "no-ci" "error"
+Missing a field that would be generally useful? Open an issue at https://github.com/max-sixty/worktrunk.
+
See also
- wt select — Interactive worktree picker with live preview
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
index d80a87e2c..26f20a058 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
@@ -285,6 +285,9 @@ When main_state == "integrated": "ancestor" "trees_match"
"passed" "running" "failed" "conflicts" "no-ci" "error"
+Missing a field that would be generally useful? Open an issue at
+https://github.com/max-sixty/worktrunk.
+
See also
- wt select — Interactive worktree picker with live preview