From 01533ab277250578e2cabd7de8788615eb573b74 Mon Sep 17 00:00:00 2001
From: Clio <zfaustk@users.noreply.github.com>
Date: Wed, 8 Apr 2026 02:38:45 +0800
Subject: [PATCH 1/5] fix(cli): make completion command discoverable

---
 cmd/completion/completion.go | 1 -
 1 file changed, 1 deletion(-)

diff --git a/cmd/completion/completion.go b/cmd/completion/completion.go
index 574365b7..3c043734 100644
--- a/cmd/completion/completion.go
+++ b/cmd/completion/completion.go
@@ -16,7 +16,6 @@ func NewCmdCompletion(f *cmdutil.Factory) *cobra.Command {
 		Use:       "completion <shell>",
 		Short:     "Generate shell completion scripts",
 		Long:      "Generate shell completion scripts for bash, zsh, fish, or powershell.",
-		Hidden:    true,
 		ValidArgs: []string{"bash", "zsh", "fish", "powershell"},
 		Args:      cobra.ExactArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {

From 5bbf1a40882153db93fa0febe7c98a4bece37cd0 Mon Sep 17 00:00:00 2001
From: Clio <zfaustk@users.noreply.github.com>
Date: Wed, 8 Apr 2026 02:46:06 +0800
Subject: [PATCH 2/5] fix(cli): make completion command discoverable


From 4ed838765e36f0dfb1cd2bf7b44f367ba770f3de Mon Sep 17 00:00:00 2001
From: Clio <zfaustk@users.noreply.github.com>
Date: Wed, 8 Apr 2026 02:47:49 +0800
Subject: [PATCH 3/5] fix(cli): make completion command discoverable

---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 6107ff0d..c0bc9710 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,19 @@ lark-cli auth login --recommend
 lark-cli calendar +agenda
 ```
 
+#### Optional: Shell Completion
+
+`lark-cli completion` is available as a regular top-level command and does not require login. Generate a completion script for the shell you use most:
+
+```bash
+# Bash
+lark-cli completion bash > ~/.local/share/bash-completion/completions/lark-cli
+
+# Zsh
+mkdir -p ~/.zfunc
+lark-cli completion zsh > ~/.zfunc/_lark-cli
+```
+
 ## Quick Start (AI Agent)
 
 > The following steps are for AI Agents. Some steps require the user to complete actions in a browser.
@@ -126,6 +139,12 @@ lark-cli auth login --recommend
 lark-cli auth status
 ```
 
+Shell completion is also available without authentication:
+
+```bash
+lark-cli completion fish > ~/.config/fish/completions/lark-cli.fish
+```
+
 ## Agent Skills
 
 | Skill                           | Description                                                                                                    |

From 70dbeb85b107cf5d9de8a83f2e14d225ca268482 Mon Sep 17 00:00:00 2001
From: Clio <zfaustk@users.noreply.github.com>
Date: Wed, 8 Apr 2026 02:48:25 +0800
Subject: [PATCH 4/5] fix(cli): make completion command discoverable

---
 README.zh.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.zh.md b/README.zh.md
index 4d526186..5896eea5 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -90,6 +90,19 @@ lark-cli auth login --recommend
 lark-cli calendar +agenda
 ```
 
+#### 可选：Shell Completion
+
+`lark-cli completion` 是一个普通的顶层命令，不需要先登录。可以为常用 shell 生成补全脚本：
+
+```bash
+# Bash
+lark-cli completion bash > ~/.local/share/bash-completion/completions/lark-cli
+
+# Zsh
+mkdir -p ~/.zfunc
+lark-cli completion zsh > ~/.zfunc/_lark-cli
+```
+
 ### 快速开始（AI Agent）
 
 > 以下步骤面向 AI Agent，部分步骤需要用户在浏览器中配合完成。
@@ -126,6 +139,12 @@ lark-cli auth login --recommend
 lark-cli auth status
 ```
 
+Shell completion 也不依赖认证：
+
+```bash
+lark-cli completion fish > ~/.config/fish/completions/lark-cli.fish
+```
+
 
 ## Agent Skills
 

From c9fe226a055402f77068f49e1b849590bc4a855b Mon Sep 17 00:00:00 2001
From: Clio <zfaustk@users.noreply.github.com>
Date: Wed, 8 Apr 2026 02:50:56 +0800
Subject: [PATCH 5/5] Create completion_test.go

---
 cmd/completion/completion_test.go | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 cmd/completion/completion_test.go

diff --git a/cmd/completion/completion_test.go b/cmd/completion/completion_test.go
new file mode 100644
index 00000000..c920ad57
--- /dev/null
+++ b/cmd/completion/completion_test.go
@@ -0,0 +1,23 @@
+// Copyright (c) 2026 Lark Technologies Pte. Ltd.
+// SPDX-License-Identifier: MIT
+
+package completion
+
+import (
+	"testing"
+
+	"github.com/larksuite/cli/internal/cmdutil"
+)
+
+func TestNewCmdCompletion_IsVisibleAndAuthFree(t *testing.T) {
+	f, _, _, _ := cmdutil.TestFactory(t, nil)
+
+	cmd := NewCmdCompletion(f)
+	if cmd.Hidden {
+		t.Fatal("expected completion command to be visible")
+	}
+	if !cmdutil.IsAuthCheckDisabled(cmd) {
+		t.Fatal("expected completion command to skip auth checks")
+	}
+}
+