[cli] Only do interactive pagination when using the -i flag

.changeset/violet-bats-crash.md

@@ -0,0 +1,5 @@
+---
+"@workflow/cli": patch
+---
+
+Add -i / --interactive flag for enabling pagination bindings, new default being off

packages/cli/src/commands/inspect.ts

@@ -239,6 +239,7 @@ function toInspectOptions(flags: any): InspectCLIOptions {
     workflowName: flags.workflowName,
     withData: flags.withData,
     backend: flags.backend,
+    interactive: flags.interactive,
   };
 }
 

packages/cli/src/lib/config/types.ts

@@ -21,4 +21,5 @@ export type InspectCLIOptions = {
   withData?: boolean;
   backend?: string;
   disableRelativeDates?: boolean;
+  interactive?: boolean;
 };

packages/cli/src/lib/inspect/flags.ts

@@ -127,4 +127,12 @@ export const cliFlags = {
     helpLabel: '--limit',
     helpValue: 'NUMBER',
   }),
+  interactive: Flags.boolean({
+    description: 'Enable interactive pagination with keyboard controls',
+    required: false,
+    char: 'i',
+    default: false,
+    helpGroup: 'Output',
+    helpLabel: '-i, --interactive',
+  }),
 };

packages/cli/src/lib/inspect/output.ts

@@ -543,6 +543,7 @@ export const listRuns = async (world: World, opts: InspectCLIOptions = {}) => {
 
   await setupListPagination<WorkflowRun>({
     initialCursor: opts.cursor,
+    interactive: opts.interactive,
     fetchPage: async (cursor) => {
       try {
         const runs = await world.runs.list({
@@ -680,6 +681,7 @@ export const listSteps = async (
 
   await setupListPagination<Step>({
     initialCursor: opts.cursor,
+    interactive: opts.interactive,
     fetchPage: async (cursor) => {
       logger.debug(`Fetching steps for run ${runId}`);
       try {
@@ -888,6 +890,7 @@ export const listEvents = async (
 
   await setupListPagination<Event>({
     initialCursor: opts.cursor,
+    interactive: opts.interactive,
     fetchPage: async (cursor) => {
       logger.debug(`Fetching events for run ${filterId}`);
       try {
@@ -957,6 +960,7 @@ export const listHooks = async (world: World, opts: InspectCLIOptions = {}) => {
   // Setup pagination with new mechanism
   await setupListPagination<Hook>({
     initialCursor: opts.cursor,
+    interactive: opts.interactive,
     fetchPage: async (cursor) => {
       if (!runId) {
         logger.debug('Fetching all hooks');

packages/cli/src/lib/inspect/pagination.ts

@@ -143,6 +143,11 @@ export interface ListPaginationOptions<TData> {
    * Optional callback for when fetching starts
    */
   onFetchStart?: (pageIndex: number) => void;
+
+  /**
+   * Enable interactive pagination with keyboard controls
+   */
+  interactive?: boolean;
 }
 
 /**
@@ -151,7 +156,11 @@ export interface ListPaginationOptions<TData> {
 export async function setupListPagination<TData>(
   options: ListPaginationOptions<TData>
 ): Promise<void> {
-  const { initialCursor, fetchPage, displayPage, onFetchStart } = options;
+  const { initialCursor, fetchPage, displayPage, onFetchStart, interactive } =
+    options;
+
+  // Interactive mode requires both TTY support and explicit --interactive flag
+  const enableInteractive = interactive && isInteractive();
 
   // Pages stack - stores all fetched pages
   const pages: PageData<TData>[] = [];
@@ -172,7 +181,7 @@ export async function setupListPagination<TData>(
     pageIndex = index;
 
     // Clear screen for subsequent pages in interactive mode
-    if (isInteractive()) {
+    if (enableInteractive) {
       console.clear();
     }
 
@@ -183,7 +192,13 @@ export async function setupListPagination<TData>(
   // Fetch and display first page
   const firstPage = await showPage(0, initialCursor);
 
-  if (!isInteractive()) {
+  // In non-interactive mode, show info if there are more pages
+  if (!enableInteractive) {
+    if (firstPage.hasMore) {
+      logger.info(
+        '\nMore results available. Use --interactive (-i) to paginate through results.'
+      );
+    }
     return;
   }
 
@@ -208,7 +223,7 @@ export async function setupListPagination<TData>(
         pageIndex = newPageIndex;
         const cachedPage = pages[newPageIndex];
 
-        if (isInteractive()) {
+        if (enableInteractive) {
           console.clear();
         }
 
@@ -257,7 +272,7 @@ export async function setupListPagination<TData>(
         pageIndex--;
         const prevPage = pages[pageIndex];
 
-        if (isInteractive()) {
+        if (enableInteractive) {
           console.clear();
         }