Skip to main content

Set up your workspace

OpenCareLoop runs on your own device through an AI coding agent. You don't need to be technical — once the agent is open, it handles the setup for you. Three steps: get the workspace, open it in an agent, and let the agent set itself up.

Alpha software: use carefully

OpenCareLoop is an alpha release. Expect rough edges, incomplete workflows, and mistakes. Review important details yourself, and do not rely on it for urgent, time-sensitive, or high-risk decisions.

Not for emergencies or medical advice

OpenCareLoop helps you organize your health and ask better questions. It is not a replacement for a doctor, pharmacist, nurse, or emergency service, and its suggestions are never medical orders. If something is sudden, severe, or dangerous, stop and get medical help. See When not to use it.

1. Get the workspace

Download or unzip the OpenCareLoop folder and put it somewhere easy to find on your computer. Everything — your dossiers and any records you add — stays inside this folder, on your device.

Download OpenCareLoop Alpha
The workspace lives on your machine

Your dossiers and records are plain files on your own computer — OpenCareLoop has no servers and never collects your data. Keep it that way: once the folder holds real health information, don't publish, commit, or share it. (The AI agent you choose does send what you discuss to its provider — see the next step.)

2. Open it in an AI agent

OpenCareLoop works with an AI coding agent. Either of these is fine:

Install one, then open the OpenCareLoop folder in it.

Privacy: your data is sent to the agent provider

To do its job, the agent sends what you share — your prompts, dossier text, and records — to its provider (for example, Anthropic for Claude Code or OpenAI for Codex). What happens to that data depends entirely on the plan and terms you have with that provider. Some plans use your data to train models or for other purposes; others don't.

It is your responsibility to choose a provider and a plan whose privacy terms you're comfortable with for sensitive health information, and to review those terms before adding real records. OpenCareLoop does not control and is not responsible for how any provider processes, stores, or uses the data you send them.

Use a capable model

Your results are only as good as the model behind the agent. We recommend running GPT‑5.5 High (or an equivalent or better model). Reasoning about scattered health data over time is hard work — a stronger model catches more, guesses less, and asks sharper questions.

3. Let the agent set up

In the agent, send this message:

Set up OpenCareLoop and create a new person dossier.

The agent prepares the workspace — including a one-time install of the tools it needs to read PDFs and reports — and then starts your first dossier with a few simple questions.

That's it. Next: start your first dossier.

Adding records later

When you have a record to add — a lab report, a prescription, a photo of a medicine box — put the file here:

people/<person-slug>/raw-data-dump/

The <person-slug> is just that person's folder name, like karan. Then tell the agent it's there and it will sort and read it for you. More in Add your records.