diff --git a/packages/cli/src/ui/components/ApprovalModeIndicator.tsx b/packages/cli/src/ui/components/ApprovalModeIndicator.tsx
index 3309a1b5af..3f669b7c36 100644
--- a/packages/cli/src/ui/components/ApprovalModeIndicator.tsx
+++ b/packages/cli/src/ui/components/ApprovalModeIndicator.tsx
@@ -28,6 +28,10 @@ export const ApprovalModeIndicator: FC<ApprovalModeIndicatorProps> = ({
   const { cycleApprovalMode } = useUIActions();
   const boxRef = useRef(null);
 
+  /**
+   * Click handler for switching approval modes.
+   * See: https://github.com/google-gemini/gemini-cli/issues/27035
+   */
   useMouseClick(boxRef, () => {
     cycleApprovalMode();
   });
diff --git a/packages/cli/src/ui/hooks/useApprovalModeIndicator.ts b/packages/cli/src/ui/hooks/useApprovalModeIndicator.ts
index 70d249819c..4e221bf27c 100644
--- a/packages/cli/src/ui/hooks/useApprovalModeIndicator.ts
+++ b/packages/cli/src/ui/hooks/useApprovalModeIndicator.ts
@@ -91,6 +91,10 @@ export function useApprovalModeIndicator({
     }
   }, [config, addItem, onApprovalModeChange]);
 
+  /**
+   * Cycles through available approval modes.
+   * See: https://github.com/google-gemini/gemini-cli/issues/27035
+   */
   const cycleApprovalMode = useCallback(() => {
     const currentMode = config.getApprovalMode();
     let nextApprovalMode: ApprovalMode | undefined;