Agentroy · cm.agentroy.xyz

Field Manual

Open dashboard Print

Everything the rig sends you — photos, spreadsheets, CSV exports, vendor tickets — goes into one place from the phone in your pocket. No install, no company laptop, no VPN. Open the link, drop the file, and the tanks, mud and drilling numbers update on a screen anyone you choose can see.

The whole thing in one picture

WHAT THE RIG SENDS YOU YOUR PHONE WHAT YOU GET BACK Mud engineer's daily check photo of the sheet · .xlsx · .csv Tank strap / pit volumes photo of the board or strap book EDR / driller's screen photo of the monitor · .csv export Fuel & water tickets photo · vendor .xlsx Daily sheet, whiteboard, notes photo · typed in by you 📷 SNAP 📄 DROP FILE OR TYPE IT cm.agentroy.xyz seconds Live dashboard tanks · mud · drilling · cost vs AFE Alerts with an action pit gain · low diesel · gas · torque Daily report, print or PDF one page, ready for the office A link you can share town, partner, service company
Nothing is installed on your phone. It is a web page — bookmark it and put it on your home screen.

First two minutes

Step 1

Open the link

Type cm.agentroy.xyz in your phone browser. Tap Share → Add to Home Screen so it sits next to your other apps.

iPhone: Safari · Android: Chrome ⋮ menu
Step 2

Pick your well

The dropdown at the top is your well list. Add yours with + Add well… — name, rig, operator. Do this once.

Lobo 14H · Patterson 452
Step 3

Feed it once a tour

Photo of the mud check and the pit board at tour change is enough to keep the whole screen honest.

06:00 and 18:00

Three ways to get data in

All three go to the same place — the Data intake box on the dashboard. Use whichever is fastest with what is in your hand.

Way 1 · fastest

📷 Take a picture

Anything with numbers printed or written on it. Mud check sheet, pit volume board, the EDR monitor, the driller's tour sheet, a fuel ticket, even a whiteboard.

The numbers are read out of the picture and dropped into the right boxes. The original photo stays attached to the day, so there is always proof of where a number came from.

jpg · png · heic — straight from the camera
Way 2 · no typing

📄 Drop the file

The mud company, the MWD hand and the rig all email spreadsheets. Save the attachment on your phone, then drop it in the same box. Column names are matched automatically — MW, Mud Weight (ppg) and mud wt all land in the same place.

Anything it cannot place is listed back to you instead of guessed at.

.xlsx · .csv · .tsv · .json
Way 3 · always works

✎ Type it in

No paper, no file, no signal on the vendor's end — use Update today's numbers. Four tabs: tanks, mud, drilling, cost & crew. Type only what changed and hit Save.

This is also how you correct anything a photo or spreadsheet got wrong. What you type always wins.

works with gloves on — big fields, no menus
The rule that matters: you are the last check. Numbers that trigger well-control decisions — pit gain, gas, mud weight — get confirmed with the driller before you act on them, exactly like you would with any sheet handed to you.

What goes where

WHAT YOU SEND WHERE IT SHOWS UP Mud check sheet Pit / tank strap board EDR screen or export Fuel / water ticket Daily drilling report Mud properties card MW · vis · PV/YP · fluid loss · pH · ECD Tank gauges + pit gain/loss active · reserve · trip · water · diesel · cuttings Drilling parameters WOB · RPM · torque · ROP · SPP · gas · bit hrs Diesel & water levels, cost feeds the "call the fuel vendor" alert Summary · cost vs AFE · safety activity, next 24 h, POB, days since LTI
One document can fill several cards at once — a daily sheet usually carries depth, tanks and cost together.

File names and formats

You haveSend asWhat happens
Paper, board, screen.jpg .png .heic Read out into numbers, photo kept with the day as the record
Vendor spreadsheet.xlsx Labels or column headers matched to fields; unmatched columns reported back
EDR / system export.csv .tsv Header row matched; if it has a Date column that day gets the values
Something automated.json Merged straight in — this is how a script or another system feeds the well
An old .xlsre-save as .xlsx The 1990s format is not read; Excel's "Save As" fixes it in one step
Backdating anything: put the date at the front of the file name and it lands on that day instead of today — 2026-09-09 mud check.jpg. Handy when you catch up on two days of paper at once. Without a date in the name, today is used (or the date inside the spreadsheet, if it has one).

A day on the rig

1 06:00 Tour change Photo: mud check + pit board 2 MID-DAY Email comes in Drop the .xlsx / .csv mud co · MWD · fuel ticket 3 18:00 Tour change Check the alerts order mud, fuel, water now 4 REPORT Send it Open daily report print → PDF → email
Two photos a day is the floor. Everything else is whatever lands in your inbox.

Alerts — and what they are telling you to do

Every alert carries the action, not just the number. They are recalculated the moment anything changes.

Critical · well control

Pit GAIN of 6 bbl reported.

Flow check. Confirm with the driller now. The same band covers gas above your set limit and ECD creeping up on the frac gradient.

Warning · tanks

Diesel at 21.7%.

Call the fuel vendor today. Same for low active mud before a trip, low water, and a cuttings bin that needs hauling — all the things that stop a rig for a stupid reason.

Warning · drilling

SPP changed +155 psi at similar flow.

Possible washout or plugged nozzle. Torque climbing and mud weight swinging between checks show up here too.

Note · planning

Bit #3 at 157 hrs. ROP down 49% vs previous.

Nothing is on fire — this is the "start planning a trip" nudge, alongside days over AFE and cost against the AFE number.

Thresholds are yours, not ours. Every limit — pit gain size, gas units, minimum mud volume, frac gradient — is set per well. Tell Agentroy what your operator uses and they are changed for your rig.

When there is no signal

On location, bars are gone

Take the photos anyway

Photograph everything as normal. When you get a bar — in the truck, at the gate, back at the yard — drop them in with the date in the file name. Nothing is lost.

No signal at all, all hitch

Run it on the laptop

The same app runs on a laptop with no internet at all. Everything lives in one folder you choose. See below.

Running it on your own laptop — the folder connection

If you would rather not touch the internet, or the company laptop is locked down, the whole thing runs locally and keeps every bit of data in one folder you pick — a USB stick, a synced folder, a drive on the rig LAN. Copy the folder and you have moved or backed up the entire well.

D:\RigData\ cm.sqlite3 all your reports photos\ every original inbox\<well>\ ◀ DROP ANYTHING HERE _done\ _failed\ 📱 Phone photos syncing in 📄 Vendor .xlsx saved here 🖥 EDR .csv dropped by the hand 💾 USB stick from the office checked every 5 seconds · processed files move to _done
Point the folder at a phone-synced folder and photos taken at the pits appear on the dashboard by themselves — no uploading at all.
To do thisDo that
Start it on WindowsDouble-click run.bat, or run.bat D:\RigData to put the data on a USB stick
Start it on Mac / Linux./run.sh ~/RigData
Open ithttp://localhost:8787 — it opens by itself
See it on your phone tooSame Wi-Fi or hotspot: http://<laptop-ip>:8787
Back it up / change laptopsCopy the folder. That is the whole backup.

Sharing what you see

Copy dashboard link on the dashboard gives you a link anyone can open — town, your partner on the other tour, the service company you are chasing. Open daily report gives you the one-page version: print it, or "save as PDF" and email it like any other daily.

Who can see it? The demo well at cm.agentroy.xyz is public on purpose. A real well is set up on its own private address — cm.youroperator.com — with your logo, your alert limits, and your data kept separate from everyone else's.

If something looks wrong

What you seeWhat to do
A number came out wrong from a photoType the right one in Update today's numbers and save — yours wins
"No rig values recognised"The sheet's labels are unusual. Send it to Agentroy once and it is taught that layout for good
Columns listed as skippedThose are fields nothing is tracked for yet — tell us if you want them on the screen
An alert you disagree withIt is a threshold, not a judgement. Have it changed for your well
Page will not load on locationNo signal. Keep shooting photos; upload when you have a bar