gitbutler icon indicating copy to clipboard operation
gitbutler copied to clipboard

verbose mode

Open schacon opened this issue 1 month ago • 1 comments

Would be nice to have a verbose debugging mode.

$ but -v rub m6 my-branch
# Verbose output:
# Resolving source 'm6'... found file 'test.md'
# Resolving target 'my-branch'... found branch 'claude-test-feature'
# Operation: Assign file to branch
# Executing assignment...
# ✓ Assigned test.md → [claude-test-feature]

schacon avatar Nov 07 '25 13:11 schacon

Even though --verbose probably is still useful on its own right, for completeness, there is a hidden -t flag, which can be boosted by adding more -ttt's to it. This enables tracing.

Also, since it would be quite some effort to consistently implement such a mode globally, I think it's more feasible to start it out as but rub -v m6 my-branch, and thus local to those sub-commands that benefit most from it. My guess is the more magical they are, the more we'd want to learn why it did what it did.

And to one-up this, we could ask ourselves if --explain is really what this means? At least I felt this way here:

❯ gix rev parse @~1 -e
01. Lookup the 'HEAD' reference
02. Traverse to the 1. ancestor of revision named 'HEAD'

Byron avatar Nov 07 '25 14:11 Byron