Skip to content
changAIs changAIs Docs

Reports

Reports connect your changed files with AI-generated notes. changAIs uses them to show what changed, where a note belongs, and what review state has already been recorded.

changAIs report-driven review showing changed files, note counts, and a selected diff

Where Reports Come From

Section titled “Where Reports Come From”

Reports may come from:

  • A changAIs-compatible AI coding workflow.
  • A report file generated by another supported changAIs workflow.
  • A manually selected local report file.

The current release supports setup workflows for Claude Code, GitHub Copilot, Cursor, Windsurf, Aider, Gemini CLI, OpenCode, and Qwen Code. Additional AI coding tools are planned on the Roadmap.

The report must match the project and file state you are reviewing.

If you want to create a report manually or from automation, use the JSON shape documented in Report Format.

Loading a Report

Section titled “Loading a Report”
  1. Open the project that contains the changed files.
  2. Open the changAIs review surface provided by your installed extension build.
  3. Select or load the report file if the extension asks for one.
  4. Review the changed files and notes shown by the extension.

If the report does not match the current project, notes may not line up with the files you expect.

VS Code Command Palette showing changAIs report and review commands

Sending Questions Back to AI

Section titled “Sending Questions Back to AI”

Replies create a feedback loop for the current report:

  1. Review a note in changAIs.
  2. Add a reply such as question, agree, disagree, or will-fix.
  3. Run changAIs: Prepare AI Follow-up Prompt, or click Prepare AI Prompt in the changAIs review toolbar.
  4. Review .changais/prompt.md, then give it to your AI tool or pass it through your own workflow.
  5. The AI should read .changais/prompt.md, .changais/report.json, and .changais/replies.json, answer any question replies, act on accepted fixes, and update .changais/report.json with fresh notes for the current code state.

changAIs does not send your code or replies to an AI service automatically. It writes a local .changais/prompt.md file. You decide whether to paste that prompt into your AI assistant or pass it through your own workflow.

Use question when you need the AI to explain a note or clarify why it changed something. Use agree or will-fix when you want the AI to make the requested change.

What to Expect

Section titled “What to Expect”

A report can include:

  • Changed file paths.
  • Diff metadata.
  • AI notes attached to files or specific lines.
  • Reply history.
  • Checked or resolved state for notes.

Troubleshooting

Section titled “Troubleshooting”

If nothing appears after loading a report, confirm that:

  • You opened the correct project folder.
  • The report was generated for the same codebase.
  • The changed files still exist.
  • The extension build supports the report format you selected.

If you still need help, contact support and include your changAIs version, editor version, operating system, install method, reproduction steps, and safe screenshots or logs.