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.mdindex 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.mdindex 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.mdindex 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 previewdiff --git a/src/cli.rs b/src/cli.rsindex 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 previewdiff --git a/src/main.rs b/src/main.rsindex 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.rsindex 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.snapindex 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 [2mmain_state == "integrated"[0m: [2m"ancestor"[0m [2m"trees_match"[0[2m"passed"[0m [2m"running"[0m [2m"failed"[0m [2m"conflicts"[0m [2m"no-ci"[0m [2m"error"+Missing a field that would be generally useful? Open an issue at https://github.com/max-sixty/worktrunk.+[32mSee also- wt select — Interactive worktree picker with live previewdiff --git a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snapindex 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 [2mmain_state == "integrated"[0m: [2m"ancestor"[0m [2m"trees_match"[2m"passed"[0m [2m"running"[0m [2m"failed"[0m [2m"conflicts"[0m [2m"no-ci"[0m [2m"error"+Missing a field that would be generally useful? Open an issue at+https://github.com/max-sixty/worktrunk.+[32mSee also- wt select — Interactive worktree picker with live preview