wt list: Show index numbers and support wt switch <number>

[Pager07]

Branch names can be long and tedious to type when switching between worktrees. It would be helpful if wt list displayed an index column, and if wt switch accepted that index as a shortcut.

Example output from wt list:

#  Branch       Status  ...
1  feature-a       ⚑^   ...
2  feature-b       ✗|   ...
3  bugfix-c     !  ✗⇡   ...

Then running:

wt switch 2

would switch to feature-b.

If the argument passed to wt switch is a number that matches an index, it should be treated as an index. Otherwise, it should be treated as a branch name to preserve backwards compatibility.

[max-sixty]

it's important that wt switch X, is totally reliable; doesn't try to guess at all...

how about the wt switch picker, or tab complete?

you're not the first person who has asked for this, so there is some demand; I'm keen to understand that.

one alternative would be --n=3, but that seems not so convenient and adds to the API...

[Pager07]

something like --n=3 would be fine as well. don't need to deep it that much. something that would prevent me writing the name.

dont go the tab or the tab complete, all these options require more keystroke / brain power to get to where I want to go.

[max-sixty]

ok, let's leave this open for a while and try to collect opinions.

I wonder whether there's more we can do in the wt switch interactive picker. if the name isn't a good enough filtering, we could consider alt+num to jump to one....

[jrdncstr]

ok, let's leave this open for a while and try to collect opinions.

I wonder whether there's more we can do in the wt switch interactive picker. if the name isn't a good enough filtering, we could consider alt+num to jump to one....

@worktrunk-bot are we able to delete from the interactive switcher?

[worktrunk-bot]

Yes — alt-r on the highlighted row removes the worktree from inside the picker. It runs pre/post-remove hooks and deletes the branch when safe, matching wt remove semantics (picker/mod.rs).

It's not yet listed in the wt switch keybindings table because of a UX papercut tracked in #1695: after the reload, the cursor jumps back to the top of the list rather than staying on the neighbor of the removed row. Once that's fixed we plan to surface it in the docs (see #1881).

[jrdncstr]

@worktrunk-bot I'm a sucker for remembering key bindings. Has the maintainer ever considered adding legends to the interactive picker?

EDIT: @max-sixty let me know if you don't want me to spam the bot. Tbh I won't be the last person to do it on impulse, so you may want to consider configuring it to only respond to the mentions of some users. Or setup a tip jar, I'll gladly contribute.

[worktrunk-bot]

Yes — there's already a legend rendered at the top of the preview pane. First line shows the numbered preview-mode tabs (1: HEAD± | 2: log | 3: main…± | 4: remote⇅ | 5: summary), second line shows Enter: switch | alt-c: create | Esc: cancel | ctrl-u/d: scroll | alt-p: toggle (items.rs). The wt switch docs list the same set. alt-r is the one holdout, pending the #1695 fix I mentioned above.

[max-sixty]

EDIT: @max-sixty let me know if you don't want me to spam the bot. Tbh I won't be the last person to do it on impulse, so you may want to consider configuring it to only respond to the mentions of some users. Or setup a tip jar, I'll gladly contribute.

as much as you want! maybe I add that to it bio to make it clear

@tend-agent consider adding this direction as part of the setup steps, what is the creator OK with contributors / users asking. Once we have the answer, can we set the bio up through the API or the creator has to type in the browser?

[tend-agent]

On the API question: yes, a bot's profile bio is writable without the browser — PATCH /user accepts a bio field (≤160 chars). The PAT needs user scope (classic) or Profile: read and write (fine-grained). install-tend's default PAT scopes don't include that today, so enabling this would either extend the scope or fall back to a one-time manual step.

Tracked the broader suggestion (surface the authorization stance during install-tend and optionally reflect it in the bio) in max-sixty/tend#296.