ApprovalUI

A tiny open-source loop for reviewing UI fixes inside terminal-based AI agents.

Terminal agents are great for code. They are bad at UI feedback, because UI feedback needs eyes, not paragraphs.

ApprovalUI renders a clickable HTML approval page from a simple JSON spec. You open it in a browser, tick approve or reject per item, generate a review, and paste it back into the agent.

Quick links

• Why ApprovalUI?
• Architecture and data flow
• Advanced usage
• Troubleshooting
• Claude Code example
• Codex example
• Kimi example
• GitHub repository
• PyPI package

Install

pip install approvalui

Quick start

approvalui example/fixes.json example/approval.html
open example/approval.html

License

MIT