Skip to content

[plan] Add engine comparison table to engines.md #12032

Closed as not planned
Closed as not planned

Description

@github-actions

Context

As identified in discussion #12027, users lack a clear comparison between engines to make informed decisions. The current documentation explains each engine separately but never compares them directly.

Problem

  • Claude Code users want to know "what am I giving up by not using Copilot?"
  • No table showing feature parity across engines
  • No guidance on "when to choose X vs Y"
  • Users cannot easily assess which engine fits their needs

Objective

Add a comprehensive engine comparison table and "when to choose" guidance to help users select the appropriate engine.

Proposed Solution

Add to docs/src/content/docs/reference/engines.md after the introduction:

## Engine Comparison

| Feature | Copilot CLI | Claude | Codex |
|---------|-------------|--------|-------|
| All workflow triggers | ✅ | ✅ | ✅ |
| GitHub tools & MCP | ✅ | ✅ | ✅ |
| Safe outputs | ✅ | ✅ | ✅ |
| Custom MCP servers | ✅ | ✅ | ✅ |
| Web search (MCP) | ⚠️ Tavily MCP | ✅ Built-in + MCP | ⚠️ Tavily MCP |
| Agent sessions | ✅ | ❌ | ❌ |
| Bot assignments | ✅ | ❌ | ❌ |
| Setup complexity | PAT required | API key | API key |

### When to Choose

- **Claude**: Best for general-purpose automation, excellent reasoning, simple API key setup
- **Copilot**: Best when you need agent sessions or Copilot bot assignments
- **Codex**: Alternative OpenAI-based option for API-based workflows

> [!TIP]
> 95%+ of features work identically across all engines. Only Copilot-specific features (agent sessions, bot assignments) require Copilot.

Files to Modify

  • docs/src/content/docs/reference/engines.md

Acceptance Criteria

  • Add comparison table showing feature parity
  • Add "When to Choose" section with clear guidance
  • Add tip callout about 95%+ feature parity
  • Verify table renders correctly in documentation site
  • Ensure accuracy of feature comparison (based on current codebase)

References

AI generated by Plan Command for discussion #12027

Activity

  1. github-actions commented on Jan 28, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster has assigned this to Copilot!

    I've identified this issue as a good candidate for automated resolution and assigned it to the Copilot agent.

    The Copilot agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    AI generated by Issue Monster

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions