Project Info
Inspiration
After a stressful incident, people must collect evidence, remember important details, and translate an ordinary explanation into an unfamiliar insurance form. ClaimDone makes that first step feel as simple as sharing a few photos and explaining what happened.
What it does
ClaimDone turns one to three accident photos plus a short text or voice description into a clear insurance-claim. The multimodal claim agent reviews the visible evidence and the customer statement. Once the claim is complete, Computer Use opens a dummy insurer website, navigates from its home page to the claim form and fills only the approved claim values. How I built it with Codex and GPT-5.6 The runtime AI pipeline uses: GPT-5.6 for multimodal image and statement analysis through the OpenAI Responses API gpt-4o-mini-transcribe for voice memos gpt-5.4-mini Computer Use for the restricted insurer-portal handoff Codex was my used for all of the development. I used it to plan the product flow, implement the frontend and backend, create the restricted Computer Use workflow, review the responsive interface in a browser, diagnose failures, write tests, and prepare the repository and demo. GPT-5.6 Sol extra high was used for deep planning. GPT-5.6 ULTRA for milestone-based goals, and GPT-5.6 Terra supported fast iteration and day-to-day questions. A key workflow lesson was to define the product in Plan mode first, when I don't know what exactly to build. Then give longer Codex goals with explicit milestone stops. After every milestone I reviewed the working experience, gave feedback, and continued after approval. That produced a much smaller and more coherent result than giving a long-running agent an underspecified destination. Accomplishments I'm proud of Real Computer Use navigation and form filling inside a safe synthetic portal One simple customer flow with only four states: input, analyzing, needs information, and ready Observable agent activity that remains useful without exposing hidden reasoning P.S. I learned that Codex works best for ambitious builds when product uncertainty is resolved before implementation. Planning, precise goals, and review checkpoints made the agent dramatically more effective.
ClaimDone
ClaimDone turns one to three accident photos and a short written or spoken description into a reviewed insurance claim, then uses Computer Use to complete a synthetic insurer portal.
Run locally
You need:
- Node.js 24
- an OpenAI API key
- Google Chrome for the Computer Use handoff
Clone the repository and install the dependencies:
git clone https://github.com/janikdotzel/claimdone.git
cd claimdone
npm install
cp .env.example .env.local
Open .env.local and add your server-side API key:
OPENAI_API_KEY=your_openai_api_key
To watch the isolated Chrome window while Computer Use runs, add this optional setting:
CLAIMDONE_SHOW_COMPUTER_USE_BROWSER=true
Start ClaimDone:
npm run dev
Open the presenter experience at http://127.0.0.1:3001/demo. Three synthetic accident photos and a sample description are already prepared, so you can select Analyze accident immediately.
Built with Codex and OpenAI
ClaimDone was planned, implemented, reviewed, debugged, and documented with Codex. The project began as a much broader insurance product, but that first direction was too complex for a focused hackathon demo. The most important improvement was changing how Codex was used before rebuilding it.
Planning before implementation
We used Codex Plan mode with GPT-5.6 Sol at high reasoning effort to turn an open-ended idea into a deliberately small product. The planning process defined the four user-facing states, the one-question limit, the sandbox boundary, the presenter experience, and explicit non-goals such as dashboards, persistence, queues, authentication, and real insurer submission.
This let us review the product direction before generating the application. Questions and visual references were resolved while changes were still inexpensive.
Building with milestone goals
Once the desired experience was clear, we created a precise Codex goal for implementation with GPT-5.6 Sol. The goal was divided into approval milestones covering the static experience, interactive flow, live AI integration, Computer Use handoff, and final polish.
Codex stopped after every milestone. We ran the app, reviewed it in the browser, gave concrete feedback, and approved the next stage only when the current one felt right. This kept a long-running agent aligned without losing the speed of autonomous implementation.
Fast iteration and review
GPT-5.6 Terra at high reasoning effort was the main model for everyday product questions, smaller frontend and user-flow improvements, debugging, and final review. Codex also helped:
- simplify the original production-oriented repository into this standalone demo;
- implement the customer flow and presenter-only agent activity view;
- build and restrict the Computer Use browser loop;
- diagnose safety blocks and provider failures;
- review spacing, responsive behavior, accessibility, and demo pacing in the browser;
- write focused tests and prepare the repository, README, Devpost submission, and demo script.
The result came from a lightweight Codex setup with a small number of useful skills and tools, rather than a large collection of third-party extensions.
Runtime model roles
| Model | Role in ClaimDone |
|---|---|
gpt-5.6 | Reviews the accident photos and customer statement, extracts claim details, and decides whether one essential detail is missing. |
gpt-4o-mini-transcribe | Converts a short voice memo into text before the claim analysis. |
gpt-5.4-mini | Uses the built-in Computer Use tool to navigate and complete the restricted local insurer sandbox. |
The application is built with Next.js 16, React 19, TypeScript, CSS Modules, the OpenAI Responses API, Playwright Core, and Zod. Claim data stays in memory, and the insurer portal is entirely synthetic.
License
ClaimDone is available under the MIT License.
Analysis
View
Metric
- 5
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- Next.jsIn code
- OpenAIIn code
- ReactIn code
- TypeScriptIn code
5 of 5 appear in the indexed code.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
311 KB
Source files
55
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
janikdotzel/claimdone
67 files · 1.5 MB · @ 1de25c0
Structure
Interface
17 files · 25%Screens, components and styles rendered to the user.
API & routing
9 files · 13%Request entry points: routes, handlers and controllers.
Application logic
8 files · 12%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- TypeScript78%
- CSS18%
- Markdown4%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm · 17- next
- openai
- playwright-core
- react
- react-dom
- zod
- +11 more
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.