Rename task CLI from ask to do

- Move cmd/ask to cmd/do; mage BuildDo builds binary named do
- Update askcli help text, errors, Fish completion (complete -c do, __do_*)
- Task alias cache path: XDG cache hexai/do/task-aliases-v2.json
- Refresh README and docs; go install path cmd/do@latest
- Remove accidentally tracked cmd/ask build artifact; ignore cmd/do/do and cmd/do/ask

Made-with: Cursor

15 files changed, 142 insertions, 142 deletions

diff --git a/internal/askcli/command_add.go b/internal/askcli/command_add.go
index b94fe89..d2fb2ea 100644
--- a/internal/askcli/command_add.go
+++ b/internal/askcli/command_add.go
@@ -10,7 +10,7 @@ import (
 
 func (d *Dispatcher) handleAdd(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask add requires a description\n")
+		_, _ = io.WriteString(stderr, "error: do add requires a description\n")
 		return 1, nil
 	}
 	modifiers, description, dependencySelectors, err := parseAddArgs(args[1:])
@@ -19,7 +19,7 @@ func (d *Dispatcher) handleAdd(ctx context.Context, args []string, stdout, stder
 		return 1, nil
 	}
 	if strings.TrimSpace(description) == "" {
-		_, _ = io.WriteString(stderr, "error: ask add requires a description\n")
+		_, _ = io.WriteString(stderr, "error: do add requires a description\n")
 		return 1, nil
 	}
 	dependencyUUIDs, code, err := d.resolveAddDependencyUUIDs(ctx, dependencySelectors, stderr)
@@ -112,14 +112,14 @@ func parseAddArgs(args []string) (modifiers []string, description string, depend
 func parseAddDependencySelectors(arg string) ([]string, error) {
 	raw := strings.TrimSpace(strings.TrimPrefix(arg, "depends:"))
 	if raw == "" {
-		return nil, fmt.Errorf("ask add depends:<id|uuid>[,<id|uuid>...] requires at least one dependency ID or UUID")
+		return nil, fmt.Errorf("do add depends:<id|uuid>[,<id|uuid>...] requires at least one dependency ID or UUID")
 	}
 	parts := strings.Split(raw, ",")
 	selectors := make([]string, 0, len(parts))
 	for _, part := range parts {
 		selector := strings.TrimSpace(part)
 		if selector == "" {
-			return nil, fmt.Errorf("ask add dependency selector list contains an empty item")
+			return nil, fmt.Errorf("do add dependency selector list contains an empty item")
 		}
 		selectors = append(selectors, selector)
 	}
diff --git a/internal/askcli/command_delete.go b/internal/askcli/command_delete.go
index 801d4cf..7356753 100644
--- a/internal/askcli/command_delete.go
+++ b/internal/askcli/command_delete.go
@@ -8,7 +8,7 @@ import (
 
 func (d *Dispatcher) handleDelete(ctx context.Context, args []string, stdin io.Reader, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask delete requires an ID or UUID argument\n")
+		_, _ = io.WriteString(stderr, "error: do delete requires an ID or UUID argument\n")
 		return 1, nil
 	}
 	resolved, _, code, err := d.resolveTaskSelector(ctx, args[1], stderr)
diff --git a/internal/askcli/command_dep.go b/internal/askcli/command_dep.go
index aa28df8..b6fb2b9 100644
--- a/internal/askcli/command_dep.go
+++ b/internal/askcli/command_dep.go
@@ -10,7 +10,7 @@ import (
 
 func (d *Dispatcher) handleDep(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask dep requires an operation (add/rm/list) and arguments\n")
+		_, _ = io.WriteString(stderr, "error: do dep requires an operation (add/rm/list) and arguments\n")
 		return 1, nil
 	}
 	op := args[1]
@@ -20,14 +20,14 @@ func (d *Dispatcher) handleDep(ctx context.Context, args []string, stdout, stder
 	case "list":
 		return d.handleDepList(ctx, args, stdout, stderr)
 	default:
-		fmt.Fprintf(stderr, "error: ask dep: unknown operation %q (use add, rm, or list)\n", op)
+		fmt.Fprintf(stderr, "error: do dep: unknown operation %q (use add, rm, or list)\n", op)
 		return 1, nil
 	}
 }
 
 func (d *Dispatcher) handleDepAddRm(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 4 {
-		_, _ = io.WriteString(stderr, "error: ask dep add/rm requires <id|uuid> <dep-id|dep-uuid>\n")
+		_, _ = io.WriteString(stderr, "error: do dep add/rm requires <id|uuid> <dep-id|dep-uuid>\n")
 		return 1, nil
 	}
 	resolved, _, code, err := d.resolveTaskSelector(ctx, args[2], stderr)
@@ -59,7 +59,7 @@ func (d *Dispatcher) handleDepAddRm(ctx context.Context, args []string, stdout,
 
 func (d *Dispatcher) handleDepList(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask dep list requires <id|uuid>\n")
+		_, _ = io.WriteString(stderr, "error: do dep list requires <id|uuid>\n")
 		return 1, nil
 	}
 	_, tasks, code, err := d.resolveTaskSelector(ctx, args[2], stderr)
diff --git a/internal/askcli/command_fish.go b/internal/askcli/command_fish.go
index f4ca9e0..401a9e2 100644
--- a/internal/askcli/command_fish.go
+++ b/internal/askcli/command_fish.go
@@ -10,12 +10,12 @@ import (
 func (d *Dispatcher) handleFish(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	_ = ctx
 	if len(args) != 1 {
-		fmt.Fprintln(stderr, "usage: ask fish")
+		fmt.Fprintln(stderr, "usage: do fish")
 		return 1, nil
 	}
 	binaryPath, err := os.Executable()
 	if err != nil {
-		binaryPath = "ask"
+		binaryPath = "do"
 	}
 	if _, err := io.WriteString(stdout, FishCompletionFor(binaryPath)); err != nil {
 		return 1, err
diff --git a/internal/askcli/command_info_add_test.go b/internal/askcli/command_info_add_test.go
index 74b2380..0a07479 100644
--- a/internal/askcli/command_info_add_test.go
+++ b/internal/askcli/command_info_add_test.go
@@ -334,7 +334,7 @@ func TestHandleAdd_DependsModifierWithoutSelectors(t *testing.T) {
 	if code != 1 {
 		t.Fatalf("add code = %d, want 1", code)
 	}
-	if got := stderr.String(); !strings.Contains(got, "ask add depends:<id|uuid>[,<id|uuid>...] requires at least one dependency ID or UUID") {
+	if got := stderr.String(); !strings.Contains(got, "do add depends:<id|uuid>[,<id|uuid>...] requires at least one dependency ID or UUID") {
 		t.Fatalf("stderr = %q, want depends: selector error", got)
 	}
 }
diff --git a/internal/askcli/command_write.go b/internal/askcli/command_write.go
index d8dbf5b..31a3f39 100644
--- a/internal/askcli/command_write.go
+++ b/internal/askcli/command_write.go
@@ -31,7 +31,7 @@ func (d *Dispatcher) runSingleTaskCommand(
 
 func (d *Dispatcher) handleDenotate(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask denotate requires an ID or UUID and text argument\n")
+		_, _ = io.WriteString(stderr, "error: do denotate requires an ID or UUID and text argument\n")
 		return 1, nil
 	}
 	text := args[2]
@@ -42,7 +42,7 @@ func (d *Dispatcher) handleDenotate(ctx context.Context, args []string, stdout,
 
 func (d *Dispatcher) handleModify(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask modify requires an ID or UUID and modification args\n")
+		_, _ = io.WriteString(stderr, "error: do modify requires an ID or UUID and modification args\n")
 		return 1, nil
 	}
 	modArgs := args[2:]
@@ -53,7 +53,7 @@ func (d *Dispatcher) handleModify(ctx context.Context, args []string, stdout, st
 
 func (d *Dispatcher) handleAnnotate(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask annotate requires an ID or UUID and note argument\n")
+		_, _ = io.WriteString(stderr, "error: do annotate requires an ID or UUID and note argument\n")
 		return 1, nil
 	}
 	note := strings.Join(args[2:], " ")
@@ -64,7 +64,7 @@ func (d *Dispatcher) handleAnnotate(ctx context.Context, args []string, stdout,
 
 func (d *Dispatcher) handleStart(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask start requires an ID or UUID argument\n")
+		_, _ = io.WriteString(stderr, "error: do start requires an ID or UUID argument\n")
 		return 1, nil
 	}
 	return d.runSingleTaskCommand(ctx, args[1], stdout, stderr, func(resolved resolvedTaskSelector) []string {
@@ -76,7 +76,7 @@ func (d *Dispatcher) handleStart(ctx context.Context, args []string, stdout, std
 
 func (d *Dispatcher) handleStop(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask stop requires an ID or UUID argument\n")
+		_, _ = io.WriteString(stderr, "error: do stop requires an ID or UUID argument\n")
 		return 1, nil
 	}
 	return d.runSingleTaskCommand(ctx, args[1], stdout, stderr, func(resolved resolvedTaskSelector) []string {
@@ -86,7 +86,7 @@ func (d *Dispatcher) handleStop(ctx context.Context, args []string, stdout, stde
 
 func (d *Dispatcher) handleDone(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 2 {
-		_, _ = io.WriteString(stderr, "error: ask done requires an ID or UUID argument\n")
+		_, _ = io.WriteString(stderr, "error: do done requires an ID or UUID argument\n")
 		return 1, nil
 	}
 	return d.runSingleTaskCommand(ctx, args[1], stdout, stderr, func(resolved resolvedTaskSelector) []string {
@@ -96,7 +96,7 @@ func (d *Dispatcher) handleDone(ctx context.Context, args []string, stdout, stde
 
 func (d *Dispatcher) handlePriority(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask priority requires an ID or UUID and priority (H/M/L)\n")
+		_, _ = io.WriteString(stderr, "error: do priority requires an ID or UUID and priority (H/M/L)\n")
 		return 1, nil
 	}
 	priority := args[2]
@@ -107,7 +107,7 @@ func (d *Dispatcher) handlePriority(ctx context.Context, args []string, stdout,
 
 func (d *Dispatcher) handleTag(ctx context.Context, args []string, stdout, stderr io.Writer) (int, error) {
 	if len(args) < 3 {
-		_, _ = io.WriteString(stderr, "error: ask tag requires an ID or UUID and +/-tag\n")
+		_, _ = io.WriteString(stderr, "error: do tag requires an ID or UUID and +/-tag\n")
 		return 1, nil
 	}
 	tag := args[2]
diff --git a/internal/askcli/completion.go b/internal/askcli/completion.go
index 0d8b584..3e30c6c 100644
--- a/internal/askcli/completion.go
+++ b/internal/askcli/completion.go
@@ -54,9 +54,9 @@ func fishAddDependencyModifierCompletionContext(positional []string, current str
 	return current == "depends" || strings.HasPrefix(current, "depends:")
 }
 
-// FishCompletion returns the default Fish completion script for the ask CLI.
+// FishCompletion returns the default Fish completion script for the do CLI.
 func FishCompletion() string {
-	return FishCompletionFor("ask")
+	return FishCompletionFor("do")
 }
 
 // FishCompletionFor returns a Fish completion script that points to the provided binary path.
@@ -66,30 +66,30 @@ func FishCompletionFor(binaryPath string) string {
 	writeFishContextFunctions(&b)
 	writeFishTaskSelectorFunction(&b, binaryPath)
 	writeFishAddDependencyModifierFunction(&b)
-	b.WriteString("complete -c ask -f\n")
-	b.WriteString("complete -c ask -s j -l json -d 'Emit JSON output'\n")
+	b.WriteString("complete -c do -f\n")
+	b.WriteString("complete -c do -s j -l json -d 'Emit JSON output'\n")
 	for _, item := range []fishCompletionItem{
 		{name: "na", description: "Run against project tasks without +agent"},
 		{name: "no-agent", description: "Run against project tasks without +agent"},
 	} {
-		writeFishCompletionLine(&b, "__ask_needs_root_completion", item)
+		writeFishCompletionLine(&b, "__do_needs_root_completion", item)
 	}
 	for _, entry := range commandRegistry.rootCompletionEntries() {
 		item := fishCompletionItem{name: entry.name, description: entry.description}
-		writeFishCompletionLine(&b, "__ask_needs_command_completion", item)
+		writeFishCompletionLine(&b, "__do_needs_command_completion", item)
 	}
 	for _, item := range askDepCompletionItems {
-		writeFishCompletionLine(&b, "__ask_in_dep_context", item)
+		writeFishCompletionLine(&b, "__do_in_dep_context", item)
 	}
-	writeFishUUIDCompletionLine(&b, "__ask_in_uuid_context", "Task selector")
-	writeFishUUIDCompletionLine(&b, "__ask_in_dep_uuid_context", "Task selector")
-	writeFishFunctionCompletionLine(&b, "__ask_in_add_dep_modifier_context", "__ask_add_dependency_modifiers", "Task dependency")
+	writeFishUUIDCompletionLine(&b, "__do_in_uuid_context", "Task selector")
+	writeFishUUIDCompletionLine(&b, "__do_in_dep_uuid_context", "Task selector")
+	writeFishFunctionCompletionLine(&b, "__do_in_add_dep_modifier_context", "__do_add_dependency_modifiers", "Task dependency")
 	return b.String()
 }
 
 func writeFishPreamble(b *strings.Builder) {
-	b.WriteString("# Fish completion for ask.\n")
-	b.WriteString("# Source with: ask fish | source\n\n")
+	b.WriteString("# Fish completion for do.\n")
+	b.WriteString("# Source with: do fish | source\n\n")
 }
 
 func writeFishContextFunctions(b *strings.Builder) {
@@ -105,7 +105,7 @@ func writeFishContextFunctions(b *strings.Builder) {
 }
 
 func writeFishPositionalTokensFunction(b *strings.Builder) {
-	b.WriteString("function __ask_positional_tokens\n")
+	b.WriteString("function __do_positional_tokens\n")
 	b.WriteString("    set -l tokens (commandline -opc)\n")
 	b.WriteString("    set -l positional\n")
 	b.WriteString("    for token in $tokens[2..-1]\n")
@@ -121,8 +121,8 @@ func writeFishPositionalTokensFunction(b *strings.Builder) {
 }
 
 func writeFishCommandPositionalsFunction(b *strings.Builder) {
-	b.WriteString("function __ask_command_positionals\n")
-	b.WriteString("    set -l positional (__ask_positional_tokens)\n")
+	b.WriteString("function __do_command_positionals\n")
+	b.WriteString("    set -l positional (__do_positional_tokens)\n")
 	b.WriteString("    if test (count $positional) -gt 0\n")
 	b.WriteString("        switch $positional[1]\n")
 	b.WriteString("            case na no-agent\n")
@@ -139,8 +139,8 @@ func writeFishCommandPositionalsFunction(b *strings.Builder) {
 }
 
 func writeFishScopePrefixFunction(b *strings.Builder) {
-	b.WriteString("function __ask_scope_prefix\n")
-	b.WriteString("    set -l positional (__ask_positional_tokens)\n")
+	b.WriteString("function __do_scope_prefix\n")
+	b.WriteString("    set -l positional (__do_positional_tokens)\n")
 	b.WriteString("    if test (count $positional) -eq 0\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
@@ -156,8 +156,8 @@ func writeFishScopePrefixFunction(b *strings.Builder) {
 }
 
 func writeFishNeedsRootCompletionFunction(b *strings.Builder) {
-	b.WriteString("function __ask_needs_root_completion\n")
-	b.WriteString("    set -l positional (__ask_positional_tokens)\n")
+	b.WriteString("function __do_needs_root_completion\n")
+	b.WriteString("    set -l positional (__do_positional_tokens)\n")
 	b.WriteString("    if test (count $positional) -eq 0\n")
 	b.WriteString("        return 0\n")
 	b.WriteString("    end\n")
@@ -166,8 +166,8 @@ func writeFishNeedsRootCompletionFunction(b *strings.Builder) {
 }
 
 func writeFishNeedsCommandCompletionFunction(b *strings.Builder) {
-	b.WriteString("function __ask_needs_command_completion\n")
-	b.WriteString("    set -l positional (__ask_positional_tokens)\n")
+	b.WriteString("function __do_needs_command_completion\n")
+	b.WriteString("    set -l positional (__do_positional_tokens)\n")
 	b.WriteString("    if test (count $positional) -eq 0\n")
 	b.WriteString("        return 0\n")
 	b.WriteString("    end\n")
@@ -182,8 +182,8 @@ func writeFishNeedsCommandCompletionFunction(b *strings.Builder) {
 }
 
 func writeFishDepContextFunction(b *strings.Builder) {
-	b.WriteString("function __ask_in_dep_context\n")
-	b.WriteString("    set -l positional (__ask_command_positionals)\n")
+	b.WriteString("function __do_in_dep_context\n")
+	b.WriteString("    set -l positional (__do_command_positionals)\n")
 	b.WriteString("    if test (count $positional) -lt 1\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
@@ -195,8 +195,8 @@ func writeFishDepContextFunction(b *strings.Builder) {
 }
 
 func writeFishUUIDContextFunction(b *strings.Builder) {
-	b.WriteString("function __ask_in_uuid_context\n")
-	b.WriteString("    set -l positional (__ask_command_positionals)\n")
+	b.WriteString("function __do_in_uuid_context\n")
+	b.WriteString("    set -l positional (__do_command_positionals)\n")
 	b.WriteString("    if test (count $positional) -eq 0\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
@@ -216,8 +216,8 @@ func writeFishUUIDContextFunction(b *strings.Builder) {
 }
 
 func writeFishDepUUIDContextFunction(b *strings.Builder) {
-	b.WriteString("function __ask_in_dep_uuid_context\n")
-	b.WriteString("    set -l positional (__ask_command_positionals)\n")
+	b.WriteString("function __do_in_dep_uuid_context\n")
+	b.WriteString("    set -l positional (__do_command_positionals)\n")
 	b.WriteString("    if test (count $positional) -lt 2\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
@@ -241,8 +241,8 @@ func writeFishDepUUIDContextFunction(b *strings.Builder) {
 }
 
 func writeFishAddDependencyModifierContextFunction(b *strings.Builder) {
-	b.WriteString("function __ask_in_add_dep_modifier_context\n")
-	b.WriteString("    set -l positional (__ask_command_positionals)\n")
+	b.WriteString("function __do_in_add_dep_modifier_context\n")
+	b.WriteString("    set -l positional (__do_command_positionals)\n")
 	b.WriteString("    if test (count $positional) -lt 1\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
@@ -258,38 +258,38 @@ func writeFishAddDependencyModifierContextFunction(b *strings.Builder) {
 }
 
 func writeFishTaskSelectorFunction(b *strings.Builder, binaryPath string) {
-	b.WriteString("function __ask_task_selectors\n")
-	b.WriteString("    set -l ask_bin ")
+	b.WriteString("function __do_task_selectors\n")
+	b.WriteString("    set -l do_bin ")
 	b.WriteString(quoteFishString(binaryPath))
 	b.WriteString("\n")
-	b.WriteString("    set -l scope_prefix (__ask_scope_prefix)\n")
+	b.WriteString("    set -l scope_prefix (__do_scope_prefix)\n")
 	b.WriteString("    set -l cache_key default\n")
 	b.WriteString("    if test -n \"$scope_prefix\"\n")
 	b.WriteString("        set cache_key $scope_prefix\n")
 	b.WriteString("    end\n")
 	b.WriteString("    set -l now (date +%s)\n")
-	b.WriteString("    if set -q __ask_task_selector_cache_until; and test $__ask_task_selector_cache_until -ge $now; and set -q __ask_task_selector_cache_key; and test \"$__ask_task_selector_cache_key\" = \"$cache_key\"\n")
-	b.WriteString("        printf '%s\\n' $__ask_task_selector_cache\n")
+	b.WriteString("    if set -q __do_task_selector_cache_until; and test $__do_task_selector_cache_until -ge $now; and set -q __do_task_selector_cache_key; and test \"$__do_task_selector_cache_key\" = \"$cache_key\"\n")
+	b.WriteString("        printf '%s\\n' $__do_task_selector_cache\n")
 	b.WriteString("        return 0\n")
 	b.WriteString("    end\n")
 	b.WriteString("    set -l selectors\n")
 	b.WriteString("    if test -n \"$scope_prefix\"\n")
-	b.WriteString("        set selectors (command $ask_bin $scope_prefix complete-uuids 2>/dev/null)\n")
+	b.WriteString("        set selectors (command $do_bin $scope_prefix complete-uuids 2>/dev/null)\n")
 	b.WriteString("    else\n")
-	b.WriteString("        set selectors (command $ask_bin complete-uuids 2>/dev/null)\n")
+	b.WriteString("        set selectors (command $do_bin complete-uuids 2>/dev/null)\n")
 	b.WriteString("    end\n")
 	b.WriteString("    if test $status -ne 0\n")
 	b.WriteString("        return 1\n")
 	b.WriteString("    end\n")
-	b.WriteString("    set -g __ask_task_selector_cache $selectors\n")
-	b.WriteString("    set -g __ask_task_selector_cache_until (math $now + 2)\n")
-	b.WriteString("    set -g __ask_task_selector_cache_key $cache_key\n")
+	b.WriteString("    set -g __do_task_selector_cache $selectors\n")
+	b.WriteString("    set -g __do_task_selector_cache_until (math $now + 2)\n")
+	b.WriteString("    set -g __do_task_selector_cache_key $cache_key\n")
 	b.WriteString("    printf '%s\\n' $selectors\n")
 	b.WriteString("end\n\n")
 }
 
 func writeFishAddDependencyModifierFunction(b *strings.Builder) {
-	b.WriteString("function __ask_add_dependency_modifiers\n")
+	b.WriteString("function __do_add_dependency_modifiers\n")
 	b.WriteString("    set -l current (commandline -ct)\n")
 	b.WriteString("    if test $current = depends\n")
 	b.WriteString("        printf '%s\\n' 'depends:'\n")
@@ -308,9 +308,9 @@ func writeFishAddDependencyModifierFunction(b *strings.Builder) {
 	b.WriteString("            set chosen $pieces[1..-2]\n")
 	b.WriteString("        end\n")
 	b.WriteString("    end\n")
-	// Each item from __ask_task_selectors is "selector\tdescription"; extract
+	// Each item from __do_task_selectors is "selector\tdescription"; extract
 	// just the selector (before the tab) for matching and output purposes.
-	b.WriteString("    for item in (__ask_task_selectors)\n")
+	b.WriteString("    for item in (__do_task_selectors)\n")
 	b.WriteString("        set -l selector (string split -m1 '\\t' -- $item)[1]\n")
 	b.WriteString("        if contains -- $selector $chosen\n")
 	b.WriteString("            continue\n")
@@ -328,7 +328,7 @@ func writeFishAddDependencyModifierFunction(b *strings.Builder) {
 }
 
 func writeFishCompletionLine(b *strings.Builder, condition string, item fishCompletionItem) {
-	b.WriteString("complete -c ask -n '")
+	b.WriteString("complete -c do -n '")
 	b.WriteString(condition)
 	b.WriteString("' -a '")
 	b.WriteString(item.name)
@@ -338,15 +338,15 @@ func writeFishCompletionLine(b *strings.Builder, condition string, item fishComp
 }
 
 func writeFishUUIDCompletionLine(b *strings.Builder, condition, description string) {
-	b.WriteString("complete -c ask -n '")
+	b.WriteString("complete -c do -n '")
 	b.WriteString(condition)
-	b.WriteString("' -a '(__ask_task_selectors)' -d '")
+	b.WriteString("' -a '(__do_task_selectors)' -d '")
 	b.WriteString(strings.ReplaceAll(description, "'", "\\'"))
 	b.WriteString("'\n")
 }
 
 func writeFishFunctionCompletionLine(b *strings.Builder, condition, functionName, description string) {
-	b.WriteString("complete -c ask -n '")
+	b.WriteString("complete -c do -n '")
 	b.WriteString(condition)
 	b.WriteString("' -a '(")
 	b.WriteString(functionName)
diff --git a/internal/askcli/completion_test.go b/internal/askcli/completion_test.go
index baa3d84..012927d 100644
--- a/internal/askcli/completion_test.go
+++ b/internal/askcli/completion_test.go
@@ -18,38 +18,38 @@ func TestFishCompletion_IncludesCommandsAndExcludesExport(t *testing.T) {
 		}
 	}
 	for _, line := range []string{
-		"# Source with: ask fish | source",
-		"complete -c ask -n '__ask_in_dep_context' -a 'add' -d 'Add a dependency'",
-		"complete -c ask -n '__ask_in_dep_context' -a 'rm' -d 'Remove a dependency'",
-		"complete -c ask -n '__ask_in_dep_context' -a 'list' -d 'List dependencies'",
-		"function __ask_command_positionals",
-		"function __ask_scope_prefix",
-		"function __ask_task_selectors",
-		"function __ask_add_dependency_modifiers",
-		`set -l ask_bin "ask"`,
+		"# Source with: do fish | source",
+		"complete -c do -n '__do_in_dep_context' -a 'add' -d 'Add a dependency'",
+		"complete -c do -n '__do_in_dep_context' -a 'rm' -d 'Remove a dependency'",
+		"complete -c do -n '__do_in_dep_context' -a 'list' -d 'List dependencies'",
+		"function __do_command_positionals",
+		"function __do_scope_prefix",
+		"function __do_task_selectors",
+		"function __do_add_dependency_modifiers",
+		`set -l do_bin "do"`,
 		"set -l selectors",
-		"set selectors (command $ask_bin complete-uuids 2>/dev/null)",
-		"set selectors (command $ask_bin $scope_prefix complete-uuids 2>/dev/null)",
-		"complete -c ask -n '__ask_in_uuid_context' -a '(__ask_task_selectors)' -d 'Task selector'",
-		"complete -c ask -n '__ask_in_dep_uuid_context' -a '(__ask_task_selectors)' -d 'Task selector'",
-		"complete -c ask -n '__ask_in_add_dep_modifier_context' -a '(__ask_add_dependency_modifiers)' -d 'Task dependency'",
+		"set selectors (command $do_bin complete-uuids 2>/dev/null)",
+		"set selectors (command $do_bin $scope_prefix complete-uuids 2>/dev/null)",
+		"complete -c do -n '__do_in_uuid_context' -a '(__do_task_selectors)' -d 'Task selector'",
+		"complete -c do -n '__do_in_dep_uuid_context' -a '(__do_task_selectors)' -d 'Task selector'",
+		"complete -c do -n '__do_in_add_dep_modifier_context' -a '(__do_add_dependency_modifiers)' -d 'Task dependency'",
 		// The dep modifier function must extract just the selector (before the
 		// tab) from each tab-separated "selector\tdescription" completion item.
-		"for item in (__ask_task_selectors)",
+		"for item in (__do_task_selectors)",
 		"set -l selector (string split -m1 '\\t' -- $item)[1]",
 	} {
 		if !strings.Contains(script, line) {
 			t.Fatalf("script missing dep completion line %q", line)
 		}
 	}
-	if strings.Contains(script, "ask export") {
+	if strings.Contains(script, "do export") {
 		t.Fatalf("script should not advertise non-existent export command")
 	}
-	if strings.Contains(script, "assets/ask.fish") {
+	if strings.Contains(script, "assets/do.fish") {
 		t.Fatalf("script should not reference a static asset")
 	}
 	for _, name := range []string{"info", "annotate", "start", "stop", "done", "priority", "tag", "modify", "denotate", "delete"} {
-		if strings.Contains(script, "complete -c ask -n '__ask_in_uuid_context' -a '"+name+"'") {
+		if strings.Contains(script, "complete -c do -n '__do_in_uuid_context' -a '"+name+"'") {
 			t.Fatalf("script should not hard-code UUID completion item %q", name)
 		}
 	}
@@ -136,10 +136,10 @@ func TestFishAddDependencyModifierCompletionContext(t *testing.T) {
 }
 
 func TestFishCompletionFor_EmbedsBinaryPath(t *testing.T) {
-	script := FishCompletionFor(`/tmp/ask "$HOME"`)
+	script := FishCompletionFor(`/tmp/do "$HOME"`)
 	for _, line := range []string{
-		`set -l ask_bin "/tmp/ask \"\$HOME\""`,
-		"set selectors (command $ask_bin complete-uuids 2>/dev/null)",
+		`set -l do_bin "/tmp/do \"\$HOME\""`,
+		"set selectors (command $do_bin complete-uuids 2>/dev/null)",
 	} {
 		if !strings.Contains(script, line) {
 			t.Fatalf("script missing %q", line)
diff --git a/internal/askcli/dispatch.go b/internal/askcli/dispatch.go
index eab793b..3167421 100644
--- a/internal/askcli/dispatch.go
+++ b/internal/askcli/dispatch.go
@@ -6,7 +6,7 @@ import (
 	"io"
 )
 
-// Runner performs CLI work that would otherwise be handled by ask itself.
+// Runner performs CLI work that would otherwise be handled by the do CLI itself.
 //
 // The interface is implemented by the executor that ultimately proxies commands to Taskwarrior.
 type Runner interface {
@@ -22,7 +22,7 @@ type Dispatcher struct {
 // NewDispatcher creates a Dispatcher backed by the provided Runner or a default executor when nil.
 func NewDispatcher(runner Runner) *Dispatcher {
 	if runner == nil {
-		e := NewExecutor("ask")
+		e := NewExecutor("do")
 		runner = &e
 	}
 	return &Dispatcher{runner: runner}
@@ -65,34 +65,34 @@ func (d *Dispatcher) Dispatch(ctx context.Context, args []string, stdin io.Reade
 }
 
 func (d *Dispatcher) help(w io.Writer) (int, error) {
-	_, _ = io.WriteString(w, "ask - task management CLI\n")
+	_, _ = io.WriteString(w, "do - task management CLI\n")
 	_, _ = io.WriteString(w, "\nScope prefixes:\n")
-	_, _ = io.WriteString(w, "  ask na <subcommand...>         Run a subcommand against project tasks without +agent\n")
-	_, _ = io.WriteString(w, "  ask no-agent <subcommand...>   Alias for ask na\n")
+	_, _ = io.WriteString(w, "  do na <subcommand...>         Run a subcommand against project tasks without +agent\n")
+	_, _ = io.WriteString(w, "  do no-agent <subcommand...>   Alias for do na\n")
 	_, _ = io.WriteString(w, "\nSubcommands:\n")
-	_, _ = io.WriteString(w, "  ask add [mods...] [depends:<id|uuid>,...] <description...> Create a new task and print created task <id>\n")
-	_, _ = io.WriteString(w, "  ask list [filters]           List active tasks (default)\n")
-	_, _ = io.WriteString(w, "  ask ready                   List READY tasks (not blocked)\n")
-	_, _ = io.WriteString(w, "  ask all [filters]            List all tasks including completed/deleted\n")
-	_, _ = io.WriteString(w, "  ask info [id|uuid]            Show task details or current started task\n")
-	_, _ = io.WriteString(w, "  ask annotate <id|uuid> \"note\" Add annotation to task\n")
-	_, _ = io.WriteString(w, "  ask start <id|uuid>           Start working on task\n")
-	_, _ = io.WriteString(w, "  ask stop <id|uuid>            Stop work on a task\n")
-	_, _ = io.WriteString(w, "  ask done <id|uuid>            Mark task complete\n")
-	_, _ = io.WriteString(w, "  ask priority <id|uuid> <P>    Set priority (H/M/L)\n")
-	_, _ = io.WriteString(w, "  ask tag <id|uuid> +/-<tag>    Add or remove tag\n")
-	_, _ = io.WriteString(w, "  ask dep add <id|uuid> <dep>   Add dependency\n")
-	_, _ = io.WriteString(w, "  ask dep rm <id|uuid> <dep>    Remove dependency\n")
-	_, _ = io.WriteString(w, "  ask dep list <id|uuid>        List dependencies\n")
-	_, _ = io.WriteString(w, "  ask urgency                   List tasks sorted by urgency\n")
-	_, _ = io.WriteString(w, "  ask modify <id|uuid> <args...> Modify task fields\n")
-	_, _ = io.WriteString(w, "  ask denotate <id|uuid> \"text\" Remove annotation\n")
-	_, _ = io.WriteString(w, "  ask delete <id|uuid>          Delete a task\n")
-	_, _ = io.WriteString(w, "  ask fish                      Emit Fish shell completion script\n")
+	_, _ = io.WriteString(w, "  do add [mods...] [depends:<id|uuid>,...] <description...> Create a new task and print created task <id>\n")
+	_, _ = io.WriteString(w, "  do list [filters]           List active tasks (default)\n")
+	_, _ = io.WriteString(w, "  do ready                   List READY tasks (not blocked)\n")
+	_, _ = io.WriteString(w, "  do all [filters]            List all tasks including completed/deleted\n")
+	_, _ = io.WriteString(w, "  do info [id|uuid]            Show task details or current started task\n")
+	_, _ = io.WriteString(w, "  do annotate <id|uuid> \"note\" Add annotation to task\n")
+	_, _ = io.WriteString(w, "  do start <id|uuid>           Start working on task\n")
+	_, _ = io.WriteString(w, "  do stop <id|uuid>            Stop work on a task\n")
+	_, _ = io.WriteString(w, "  do done <id|uuid>            Mark task complete\n")
+	_, _ = io.WriteString(w, "  do priority <id|uuid> <P>    Set priority (H/M/L)\n")
+	_, _ = io.WriteString(w, "  do tag <id|uuid> +/-<tag>    Add or remove tag\n")
+	_, _ = io.WriteString(w, "  do dep add <id|uuid> <dep>   Add dependency\n")
+	_, _ = io.WriteString(w, "  do dep rm <id|uuid> <dep>    Remove dependency\n")
+	_, _ = io.WriteString(w, "  do dep list <id|uuid>        List dependencies\n")
+	_, _ = io.WriteString(w, "  do urgency                   List tasks sorted by urgency\n")
+	_, _ = io.WriteString(w, "  do modify <id|uuid> <args...> Modify task fields\n")
+	_, _ = io.WriteString(w, "  do denotate <id|uuid> \"text\" Remove annotation\n")
+	_, _ = io.WriteString(w, "  do delete <id|uuid>          Delete a task\n")
+	_, _ = io.WriteString(w, "  do fish                      Emit Fish shell completion script\n")
 	return 0, nil
 }
 
 func (d *Dispatcher) unknownCommand(w io.Writer, subcommand string) (int, error) {
-	fmt.Fprintf(w, "ask: unknown subcommand %q\n", subcommand)
+	fmt.Fprintf(w, "do: unknown subcommand %q\n", subcommand)
 	return 1, nil
 }
diff --git a/internal/askcli/dispatch_test.go b/internal/askcli/dispatch_test.go
index e027b43..90c1b99 100644
--- a/internal/askcli/dispatch_test.go
+++ b/internal/askcli/dispatch_test.go
@@ -23,19 +23,19 @@ func TestDispatcher_Help(t *testing.T) {
 		t.Fatalf("help returned error: %v", err)
 	}
 	output := stdout.String()
-	if !strings.Contains(output, "ask - task management CLI") {
+	if !strings.Contains(output, "do - task management CLI") {
 		t.Fatalf("help missing title: %s", output)
 	}
-	if !strings.Contains(output, "ask na <subcommand...>") || !strings.Contains(output, "ask no-agent <subcommand...>") {
+	if !strings.Contains(output, "do na <subcommand...>") || !strings.Contains(output, "do no-agent <subcommand...>") {
 		t.Fatalf("help missing no-agent scope prefixes: %s", output)
 	}
-	if !strings.Contains(output, "ask list") {
+	if !strings.Contains(output, "do list") {
 		t.Fatalf("help missing list subcommand: %s", output)
 	}
-	if !strings.Contains(output, "ask all") {
+	if !strings.Contains(output, "do all") {
 		t.Fatalf("help missing all subcommand: %s", output)
 	}
-	if !strings.Contains(output, "ask fish") {
+	if !strings.Contains(output, "do fish") {
 		t.Fatalf("help missing fish subcommand: %s", output)
 	}
 }
@@ -96,8 +96,8 @@ func TestDispatcher_LongHelp(t *testing.T) {
 	d.Dispatch(context.Background(), []string{"help"}, nil, &stdout, io.Discard)
 	output := stdout.String()
 	for _, sub := range []string{"add", "list", "all", "ready", "info", "annotate", "start", "stop", "done", "priority", "tag", "dep", "urgency", "modify", "denotate", "delete", "fish"} {
-		if !strings.Contains(output, "ask "+sub) {
-			t.Errorf("help missing subcommand: ask %s", sub)
+		if !strings.Contains(output, "do "+sub) {
+			t.Errorf("help missing subcommand: do %s", sub)
 		}
 	}
 }
@@ -137,7 +137,7 @@ func TestDispatcher_FishSubcommandRejectsExtraArgs(t *testing.T) {
 	if stdout.Len() != 0 {
 		t.Fatalf("fish extra args wrote unexpected stdout: %q", stdout.String())
 	}
-	if got := stderr.String(); !strings.Contains(got, "usage: ask fish") {
+	if got := stderr.String(); !strings.Contains(got, "usage: do fish") {
 		t.Fatalf("fish extra args stderr = %q, want usage", got)
 	}
 }
diff --git a/internal/askcli/formatter.go b/internal/askcli/formatter.go
index d801f8a..fc4a1d9 100644
--- a/internal/askcli/formatter.go
+++ b/internal/askcli/formatter.go
@@ -168,7 +168,7 @@ func FormatSuccess(alias string) string {
 	return fmt.Sprintf("ok %s\n", alias)
 }
 
-// FormatCreatedTask returns the success string written to stdout after ask add creates a task.
+// FormatCreatedTask returns the success string written to stdout after do add creates a task.
 func FormatCreatedTask(alias string) string {
 	return fmt.Sprintf("created task %s\n", alias)
 }
diff --git a/internal/askcli/task_alias_cache.go b/internal/askcli/task_alias_cache.go
index e89dbb5..ff682d6 100644
--- a/internal/askcli/task_alias_cache.go
+++ b/internal/askcli/task_alias_cache.go
@@ -114,7 +114,7 @@ func taskAliasCachePath() (string, error) {
 	// v2 uses reversed alias strings (e.g. "10" instead of "01") so that the
 	// first character varies more often, improving shell auto-completion. The
 	// old v1 file is intentionally abandoned so the mapping starts fresh.
-	return filepath.Join(dir, "ask", "task-aliases-v2.json"), nil
+	return filepath.Join(dir, "do", "task-aliases-v2.json"), nil
 }
 
 func (c *taskAliasCache) validate() error {
diff --git a/internal/askcli/taskexec.go b/internal/askcli/taskexec.go
index a1ede37..e3915d9 100644
--- a/internal/askcli/taskexec.go
+++ b/internal/askcli/taskexec.go
@@ -16,7 +16,7 @@ type repoTopLevelDetector func(context.Context) (string, error)
 
 type commandRunne