$ promptfoo list

┌──────────────────────────────────┬───────────────────────────┬────────────┬──────────────┐
│ eval id                          │ description               │ prompts    │ vars         │
├──────────────────────────────────┼───────────────────────────┼────────────┼──────────────┤
│ eval-2024-01-15T10:30:00         │ API testing               │ a1b2c3     │ query, model │
│ eval-2024-01-14T15:45:00         │ Prompt comparison         │ d4e5f6     │ input        │
└──────────────────────────────────┴───────────────────────────┴────────────┴──────────────┘

Run promptfoo show eval <id> to see details of a specific evaluation.

$ promptfoo list

┌─────────────────────────────────────────────────────────────────────────────────┐
│ Evaluations (42 items)                                                          │
├─────────────────────────────────────────────────────────────────────────────────┤
│ Search: (press / to search)                                                     │
├─────────────────────────────────────────────────────────────────────────────────┤
│ ▶ eval-2024-01-15T10:30  API testing for new endpoints      today               │
│   eval-2024-01-14T15:45  Prompt comparison study            yesterday           │
│   eval-2024-01-13T09:00  Redteam security scan              2d ago      redteam │
│   eval-2024-01-12T14:20  Model benchmarking                 3d ago              │
│   eval-2024-01-11T11:00  Customer support prompts           4d ago              │
│   ...                                                                           │
├─────────────────────────────────────────────────────────────────────────────────┤
│ Showing 1-10 of 42 (more available)                                             │
├─────────────────────────────────────────────────────────────────────────────────┤
│ ↑↓/jk: navigate | Enter: select | /: search | r: refresh | q: quit             │
└─────────────────────────────────────────────────────────────────────────────────┘

# Foundation (Core Infrastructure)
src/ui/constants.ts
src/ui/interactiveCheck.ts
src/ui/render.ts
src/ui/index.ts
src/ui/noninteractive/index.ts
src/ui/noninteractive/progress.ts
src/ui/noninteractive/textOutput.ts
src/cliState.ts

# List UI (User-Facing Feature)
src/ui/list/ListApp.tsx
src/ui/list/listRunner.tsx
src/ui/list/index.ts
src/ui/init/components/shared/TextInput.tsx

# Command Integration
src/commands/list.ts

# Tests
test/ui/render.test.ts
test/ui/noninteractive.test.ts
test/ui/list/listRunner.test.ts

# Config
src/envars.ts
tsconfig.json
vitest.config.ts
package.json
package-lock.json

# Total: 18 files, ~2,520 lines

┌─────────────────────────────────────────────────────────────────┐
│                    src/commands/list.ts                         │
│                           │                                     │
│                           ▼                                     │
│              ┌────────────────────────┐                         │
│              │   src/ui/list/         │                         │
│              │   ├── listRunner.tsx   │ ← Dynamic import entry  │
│              │   ├── ListApp.tsx      │ ← React component       │
│              │   └── index.ts         │                         │
│              └────────────┬───────────┘                         │
│                           │                                     │
│              ┌────────────┴───────────┐                         │
│              ▼                        ▼                         │
│  ┌─────────────────────┐  ┌──────────────────────────┐          │
│  │ src/ui/render.ts    │  │ src/ui/init/components/  │          │
│  │ (lazy Ink loading)  │  │ shared/TextInput.tsx     │          │
│  └─────────┬───────────┘  └──────────────────────────┘          │
│            │                                                    │
│            ▼                                                    │
│  ┌─────────────────────────────────┐                            │
│  │ src/ui/interactiveCheck.ts      │                            │
│  │ (TTY/CI detection)              │                            │
│  └─────────────────────────────────┘                            │
│                                                                 │
│  ┌─────────────────────────────────┐                            │
│  │ src/ui/constants.ts             │ ← Used by all components   │
│  └─────────────────────────────────┘                            │
└─────────────────────────────────────────────────────────────────┘

// src/ui/list/listRunner.tsx
export async function runInkList(options: ListRunnerOptions): Promise<ListResult> {
  // Dynamic imports - only loaded when called
  const [React, { renderInteractive }, { ListApp }] = await Promise.all([
    import('react'),
    import('../render'),
    import('./ListApp'),
  ]);

  // ... render the component
}

// src/commands/list.ts
import { runInkList, shouldUseInkList } from '../ui/list';

.action(async (cmdObj) => {
  // Check if Ink UI should be used
  if (cmdObj.interactive && shouldUseInkList()) {
    // Transform data for Ink UI
    const items: EvalItem[] = evals.map(evl => ({ ... }));

    // Run interactive UI
    const result = await runInkList({
      resourceType: 'evals',
      items,
    });

    // Handle selection
    if (result.selectedItem) {
      logger.info(`Selected: ${result.selectedItem.id}`);
    }
    return;
  }

  // Fall back to table output
  logger.info(wrapTable(tableData, columnWidths));
});

# Enable interactive UI
PROMPTFOO_ENABLE_INTERACTIVE_UI=true promptfoo list evals

# Default behavior (table output)
promptfoo list evals

# Start from the feature branch
git checkout ink-ui
git pull origin ink-ui

# Create PR 1 branch
git checkout -b ink-ui/foundation-with-list

# If using cherry-pick approach, cherry-pick relevant commits
# Or use git reset/checkout to include only PR 1 files

# Verify files match the inventory
git diff --name-only origin/main...HEAD

# Run tests
npm run build && npm test

# Push branch
git push -u origin ink-ui/foundation-with-list

# Create PR
gh pr create --title "feat(ui): Add Ink-based interactive list UI" \
  --body "## Summary
- Add foundation for Ink-based CLI UI (opt-in)
- Implement interactive \`promptfoo list\` command
- Support keyboard navigation, search, pagination
- Graceful fallback for non-TTY environments

## Usage
\`\`\`bash
# Enable interactive UI (opt-in)
PROMPTFOO_ENABLE_INTERACTIVE_UI=true promptfoo list evals

# Default behavior (table output)
promptfoo list evals
\`\`\`

## Environment Variable
- \`PROMPTFOO_ENABLE_INTERACTIVE_UI=true\` - Enable Ink-based interactive UI

## Test Plan
- [ ] Test with env var in iTerm2
- [ ] Test with env var in VS Code terminal
- [ ] Test piped output falls back to table
- [ ] Test default behavior (table output)
"

# Revert the entire PR
git revert <pr1-merge-commit>

# Or revert just the list.ts changes to restore old behavior
git checkout main -- src/commands/list.ts

## Summary

Add foundation for Ink-based interactive CLI UI with a working `promptfoo list` command.

### What's Included

**Infrastructure:**

- Environment detection (TTY check)
- Opt-in via `PROMPTFOO_ENABLE_INTERACTIVE_UI=true`
- Lazy Ink/React loading (no bundle impact for library users)
- Non-interactive fallback (table output)
- Signal handling with proper exit codes

**User-Facing Feature:**

- Interactive `promptfoo list` command with keyboard navigation
- Search functionality (press `/`)
- Pagination with auto-loading
- Support for evals, prompts, and datasets views

### Usage

```bash
# Enable interactive mode (opt-in)
PROMPTFOO_ENABLE_INTERACTIVE_UI=true promptfoo list evals
PROMPTFOO_ENABLE_INTERACTIVE_UI=true promptfoo list prompts
PROMPTFOO_ENABLE_INTERACTIVE_UI=true promptfoo list datasets

# Default behavior (table output)
promptfoo list evals
```

---

## What's Left for Future PRs

After PR 1 merges, remaining PRs can build on this foundation:

| PR | What It Adds | Dependencies |
|----|-------------|--------------|
| PR 2 | Hooks, Utils, Shared Components | PR 1 |
| PR 3 | Eval UI (core feature) | PR 1, PR 2 |
| PR 4 | Auth, Cache, Menu, Share UIs | PR 1, PR 2 |
| PR 5 | Init Wizard | PR 1, PR 2 |
| PR 6 | Redteam Generate UI | PR 1, PR 2 |

**Note:** TextInput.tsx is placed in `src/ui/init/components/shared/` in the current branch. After PR 1 merges, PR 5 (Init Wizard) will use this component as-is. No duplication needed.