coder · mafredri · Aug 25, 2025 · Aug 22, 2025 · Aug 22, 2025 · Aug 25, 2025
diff --git a/cli/exp.go b/cli/exp.go
@@ -16,6 +16,7 @@ func (r *RootCmd) expCmd() *serpent.Command {
 			r.mcpCommand(),
 			r.promptExample(),
 			r.rptyCommand(),
+			r.tasksCommand(),
 		},
 	}
 	return cmd

diff --git a/cli/exp_task.go b/cli/exp_task.go
@@ -0,0 +1,20 @@
+package cli
+
+import (
+	"github.com/coder/serpent"
+)
+
+func (r *RootCmd) tasksCommand() *serpent.Command {
+	cmd := &serpent.Command{
+		Use:     "task",
+		Aliases: []string{"tasks"},
+		Short:   "Experimental task commands.",
+		Handler: func(i *serpent.Invocation) error {
+			return i.Command.HelpHandler(i)
+		},
+		Children: []*serpent.Command{
+			r.taskList(),
+		},
+	}
+	return cmd
+}
diff --git a/cli/exp_tasklist.go b/cli/exp_tasklist.go
@@ -0,0 +1,142 @@
+package cli
+
+import (
+	"fmt"
+	"strings"
+	"time"
+
+	"golang.org/x/xerrors"
+
+	"github.com/coder/coder/v2/cli/cliui"
+	"github.com/coder/coder/v2/codersdk"
+	"github.com/coder/serpent"
+)
+
+type taskListRow struct {
+	Task codersdk.Task `table:"t,recursive_inline"`
+
+	StateChangedAgo string `table:"state changed"`
+}
+
+func taskListRowFromTask(now time.Time, t codersdk.Task) taskListRow {
+	var stateAgo string
+	if t.CurrentState != nil {
+		stateAgo = now.UTC().Sub(t.CurrentState.Timestamp).Truncate(time.Second).String() + " ago"
+	}
+
+	return taskListRow{
+		Task: t,
+
+		StateChangedAgo: stateAgo,
+	}
+}
+
+func (r *RootCmd) taskList() *serpent.Command {
+	var (
+		statusFilter string
+		all          bool
+		user         string
+
+		client    = new(codersdk.Client)
+		formatter = cliui.NewOutputFormatter(
+			cliui.TableFormat(
+				[]taskListRow{},
+				[]string{
+					"id",
+					"name",
+					"status",
+					"state",
+					"state changed",
+					"message",
+				},
+			),
+			cliui.ChangeFormatterData(
+				cliui.JSONFormat(),
+				func(data any) (any, error) {
+					rows, ok := data.([]taskListRow)
+					if !ok {
+						return nil, xerrors.Errorf("expected []taskListRow, got %T", data)
+					}
+					out := make([]codersdk.Task, len(rows))
+					for i := range rows {
+						out[i] = rows[i].Task
+					}
+					return out, nil
+				},
+			),
+		)
+	)
+
+	cmd := &serpent.Command{
+		Use:     "list",
+		Short:   "List experimental tasks",
+		Aliases: []string{"ls"},
+		Middleware: serpent.Chain(
+			serpent.RequireNArgs(0),
+			r.InitClient(client),
+		),
+		Options: serpent.OptionSet{
+			{
+				Name:        "status",
+				Description: "Filter by task status (e.g. running, failed, etc).",
+				Flag:        "status",
+				Default:     "",
+				Value:       serpent.StringOf(&statusFilter),
+			},
+			{
+				Name:          "all",
+				Description:   "List tasks for all users you can view.",
+				Flag:          "all",
+				FlagShorthand: "a",
+				Default:       "false",
+				Value:         serpent.BoolOf(&all),
+			},
+			{
+				Name:        "user",
+				Description: "List tasks for the specified user (username, \"me\").",
+				Flag:        "user",
+				Default:     "",
+				Value:       serpent.StringOf(&user),
+			},
+		},
+		Handler: func(inv *serpent.Invocation) error {
+			ctx := inv.Context()
+			exp := codersdk.NewExperimentalClient(client)
+
+			targetUser := strings.TrimSpace(user)
+			if targetUser == "" && !all {
+				targetUser = codersdk.Me
+			}
+
+			tasks, err := exp.Tasks(ctx, &codersdk.TasksFilter{
+				Owner:  targetUser,
+				Status: statusFilter,
+			})
+			if err != nil {
+				return xerrors.Errorf("list tasks: %w", err)
+			}
+
+			// If no rows and not JSON, show a friendly message.
+			if len(tasks) == 0 && formatter.FormatID() != cliui.JSONFormat().ID() {
+				_, _ = fmt.Fprintln(inv.Stderr, "No tasks found.")
+				return nil
+			}
+
+			rows := make([]taskListRow, len(tasks))
+			now := time.Now()
+			for i := range tasks {
+				rows[i] = taskListRowFromTask(now, tasks[i])
+			}
+
+			out, err := formatter.Format(ctx, rows)
+			if err != nil {
+				return xerrors.Errorf("format tasks: %w", err)
+			}
+			_, _ = fmt.Fprintln(inv.Stdout, out)
+			return nil
+		},
+	}
+
+	formatter.AttachOptions(&cmd.Options)
+	return cmd
+}