> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codemod.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codemod Wish

Codemod Wish is the in-app Codemod AI assistant. It understands the page you are on and can help with Codemod workflows without requiring you to leave the app.

Use Wish to inspect current platform state, ask follow-up questions, and start repeatable codebase work from the context you already have open.

## What Wish can help with

Wish can help with work across the Codemod platform:

* **Campaigns**: review campaign progress, inspect failed or stuck tasks, and plan the next rollout step.
* **Automations**: explain triggers and actions, identify missing guardrails, and help configure automation steps.
* **Insights**: inspect dashboards, create widgets, and reason about migration readiness or adoption trends.
* **Grep**: search indexed repositories with Pattern, Regex, or YAML queries, and create Insights dashboards from a completed search.
* **Registry packages**: search for relevant codemods and inspect package details before applying them.
* **Repositories**: use indexed repository context to search files, dependencies, and code patterns when repository access is available.
* **Investigations**: answer behavioral questions with source-backed findings, reproducible searches, relationship maps, and explicit limitations.
* **Codemod creation**: turn repeatable transformations or analysis ideas into generated codemod packages.

<Info>
  Wish uses the current page as context. If you ask about a Campaign, Automation, or Insights dashboard while viewing it, Wish can use that page state to give more specific help.
</Info>

## Start a conversation

<Steps>
  <Step title="Open Wish">
    Click **Ask Codemod Wish** in the bottom-right corner of the app. You can also use `Cmd+J` on macOS or `Ctrl+J` on Windows and Linux.
  </Step>

  <Step title="Ask from the current page">
    Ask about the Campaign, Automation, Insights dashboard, Registry package, or repository context you are viewing.
  </Step>

  <Step title="Review suggested actions">
    When Wish needs to navigate, create follow-up work, or choose between next steps, review the suggested action before continuing.
  </Step>
</Steps>

## Investigate repository behavior

Add `@investigate` and one or more repository mentions to ask a source-backed question about code behavior. Wish records the Grep searches it uses, links findings to precise source excerpts, maps related code concepts, and separates unresolved questions into limitations.

See [Investigation mode](/enterprise/wish-investigation) for a complete walkthrough of the report and its evidence checks.

## Build codemod packages

For repeatable code transformations or reusable analysis, Wish can generate a codemod package and publish it to the registry.

Generated packages are private by default unless you explicitly choose public visibility. When you are working in an organization, generated packages use that organization's registry scope.

After a package is ready, Wish can continue with follow-up work such as creating a Campaign or building an Insights dashboard that uses the generated package.

The same prompting guidance for [building better codemods in Studio](/enterprise/codemod-studio#tips-for-building-better-codemods) applies to Wish: keep the transformation focused, describe the intended behavior clearly, and include examples when they help.

## Related docs

<CardGroup cols={2}>
  <Card title="Investigation" icon="microscope" href="/enterprise/wish-investigation">
    Answer codebase questions with inspectable source evidence.
  </Card>

  <Card title="Campaigns" icon="arrow-up-right-dots" href="/enterprise/campaigns">
    Run codemods with automated PRs and centralized tracking.
  </Card>

  <Card title="Automations" icon="bolt" href="/enterprise/automations">
    Create rules that react to events across your projects.
  </Card>

  <Card title="Insights" icon="chart-simple" href="/enterprise/insights">
    Create dashboards for migration and codebase visibility.
  </Card>

  <Card title="Grep" icon="magnifying-glass" href="/enterprise/grep">
    Search indexed private repositories with patterns, regex, or YAML rules.
  </Card>

  <Card title="Registry" icon="globe" href="/enterprise/registry">
    Find and apply public, private, or pro codemod packages.
  </Card>

  <Card title="MCP" icon="server" href="/enterprise/codemod-mcp">
    Let Claude, Cursor, and other AI assistants search your code and manage migrations.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.