From 6d31b368fc3fe79edee39d8010643748313eea7e Mon Sep 17 00:00:00 2001
From: Vincent Koc <vincentkoc@ieee.org>
Date: Sun, 3 May 2026 03:10:17 -0700
Subject: [PATCH] fix(tui): document shared controls

---
 internal/cli/cli_test.go     | 2 ++
 internal/cli/tui_commands.go | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/internal/cli/cli_test.go b/internal/cli/cli_test.go
index b651e72..97c5055 100644
--- a/internal/cli/cli_test.go
+++ b/internal/cli/cli_test.go
@@ -178,6 +178,8 @@ func TestTUIHelpReturnsUsage(t *testing.T) {
 	require.NoError(t, Run(context.Background(), []string{"tui", "--help"}, &stdout, &stderr))
 	require.Contains(t, stdout.String(), "Usage of tui:")
 	require.Contains(t, stdout.String(), "-limit")
+	require.Contains(t, stdout.String(), "right-click")
+	require.Contains(t, stdout.String(), "#              jump")
 	require.Empty(t, stderr.String())
 }
 
diff --git a/internal/cli/tui_commands.go b/internal/cli/tui_commands.go
index e2b3cbc..f108dcb 100644
--- a/internal/cli/tui_commands.go
+++ b/internal/cli/tui_commands.go
@@ -3,6 +3,7 @@ package cli
 import (
 	"errors"
 	"flag"
+	"fmt"
 	"strings"
 
 	"github.com/vincentkoc/crawlkit/tui"
@@ -13,6 +14,12 @@ import (
 func (r *runtime) runTUI(args []string) error {
 	fs := flag.NewFlagSet("tui", flag.ContinueOnError)
 	fs.SetOutput(r.stderr)
+	fs.Usage = func() {
+		_, _ = fmt.Fprintln(fs.Output(), "Usage of tui:")
+		fs.PrintDefaults()
+		_, _ = fmt.Fprintln(fs.Output())
+		_, _ = fmt.Fprintln(fs.Output(), tui.ControlsHelp())
+	}
 	if hasHelpArg(args) {
 		fs.SetOutput(r.stdout)
 	}