# Usage - Qodo Merge (and open-source PR-Agent)

Skip to content

# Usage Guide for Qodo Merge CLI

## Understanding the Interface

### Why a Structured Table?

The suggestions table serves as the core interface for reviewing and managing AI feedback.

The table provides a structured overview of all suggestions with key metadata. Users can efficiently prioritize, explore, and implement suggestions through an intuitive workflow.

The interface guides you from high-level overviews to detailed implementation context. This consistent user-friendly structure streamlines the review process, reducing time from feedback to implementation.

### Navigation Instructions

Use `↑`/`↓` to navigate suggestions, `Enter` to implement, `Space` for multi-select, and `ESC` to exit.

The table includes:

- Selection (`○`/`◉`): Multi-selection mode
- Category: Security, Performance, General, etc.
- Impact: High, Medium, Low importance
- Suggestion: Brief description
- Status: `✓` implemented, `✗` declined, blank = pending
- Detail Panel (if wide enough): Full suggestion text, affected files, impact analysis

## Flow

### Explore the suggestions

You can explore the suggestions in detail before implementing them. You can view the proposed code changes in a diff format, jump to the relevant code in your IDE, or chat about any suggestion for clarification.

Exploring the suggestions

Diff View (`D/S`)Jump to Code (`O`)Chat (`C`)
Unified Diff View (`D`)Side-by-Side View (`S`)

- Press `D` to view proposed code changes
- Standard unified diff format with line numbers
- Syntax highlighting for additions/removals
- `↑`/`↓` to scroll through changes

- Press `S` for side-by-side diff view
- Enhanced layout for complex changes
- Better context understanding
- Clear before/after comparison

IDE Integration

- Press `O` to open the suggestion's source file in your IDE
- Supports all major IDEs when terminal is running inside them
- Direct navigation to relevant code location
- Seamless transition between CLI and editor

Suggestion-Specific Discussion

- Press `C` to discuss the current suggestion
- Context automatically included (files, lines, description)
- Ask questions, request modifications
- `Ctrl+J` for new lines, `ESC` to return

### Implement

You can implement a single suggestion, multiple selected suggestions, or all suggestions at once. You can also chat about any suggestion before implementing it.

Multiple implementation modes available

1. Single Suggestion2. Multi-Select3. Address All4. Chat then Implement

Direct individual implementation

1. Navigate to any specific suggestion
2. Press `Enter` to implement just that suggestion

Select multiple related suggestions

1. Use `Space` to select specific suggestions (◉)
2. Navigate and select multiple related suggestions
3. Press `Enter` on any selected suggestion to start implementation
4. AI implements selected suggestions together

Reflect and address all suggestions (Always available as first row)

1. Press `Enter` on the first row "Reflect and address all suggestions"
2. AI implements all suggestions simultaneously and intelligently
3. Handles conflicts and dependencies automatically
4. Review the comprehensive summary

Discuss then implement

1. Press `C` on any suggestion to start a chat
2. Ask questions, request modifications, get clarifications
3. Once satisfied, request implementation via chat
4. AI implements based on your discussion

#### Implementation Summary

After the AI completes the implementation, you receive a structured output showing detailed results for each suggestion:

- Status: `✓ IMPLEMENTED`, `SKIPPED`, or `✗ REJECTED`
- Suggestion: Brief description of what was addressed
- Reasoning: Explanation of the implementation approach
- Changes: Summary of code modifications made

Each suggestion gets its own implementation summary, providing full transparency into what was done and why.

### Finalize

After implementing the suggestions, you have several options to proceed:

Post Implementation Actions

Return to Table (`ESC`)Continue Chatting (`C`)Commit Changes (`M`)Open Edited File (`O`)

The first option returns you to the main table where you can see:

- Updated Status: Implemented suggestions now show `✓` green checkmark
- Real-time Updates: Status changes reflect immediately
- Continue Workflow: Handle remaining pending suggestions

Discuss the implementation details:

- Review changes made by the AI
- Request refinements or modifications
- Get explanations of implementation approach
- Continuous improvement cycle

Auto-generate commit messages:

- AI-generated commit messages based on changes
- Editable before committing
- Standard git conventions
- Seamless workflow integration

Open the implemented code directly in your IDE:

- View the exact changes made
- See implementation in full context
- Continue development seamlessly
- Integrated with your existing workflow

## Tips for Success

- Start with "Fix All" to let AI handle everything intelligently
- Use Chat liberally - ask questions about unclear suggestions
- Decline appropriately - press `X` and provide reasons for inappropriate suggestions
- Multi-select strategically - group related suggestions together

Footer