PHEV Tracker is a Claude Code skill for plug-in hybrid vehicle owners. It logs refueling sessions through a guided conversational flow and generates efficiency analysis reports broken down by fuel (HEV), electric (EV), and combined driving.
The tracker covers the full PHEV ownership loop:
- Interactive logging — guided prompts collect odometer readings, fuel volume, cost, plug-in meter, and electricity tariff at each fill-up
- Session analysis — per-refuel metrics including km/L, km/kWh, and cost per km for each mode
- Cumulative reporting — side-by-side last refuel vs all-time comparison across HEV, EV, and combined dimensions
- AI analysis — efficiency trends, cost optimization, performance vs vehicle class (PHEV/EV/ICE), and maintenance tracking
Trigger words: refuel, refuelling, re-fuel, fill up, fill-up, fuel log, log fuel, track fuel, gas station, petrol, pump, PHEV log, EV log, odometer, plug meter, plug-in meter, kWh reading, km/L, charging cost, log a refuel, track mileage, fuel tracker, update soh, battery soh, update vehicle, vehicle info, change units, mpg, L/100km.
Once triggered, the skill confirms intent before taking any action:
- Log a refuel — two rounds of guided input (odometers and meter first, then fuel and costs), a confirmation screen showing all values, then writes to the log and displays the updated analysis report
- Show report — immediately renders the last-refuel vs cumulative analysis without prompting for data
- Extended report with AI analysis — full report plus AI-driven insights covering efficiency trends, cost optimization, performance vs vehicle class (PHEV/EV/ICE), maintenance status, and recommendations. On first use, asks for vehicle info (make/model, acquisition date, battery SOH)
- Update battery SOH — record your latest battery State of Health reading from PMS or Electro app
- Update vehicle info — change make, model, or acquisition date
- Change units — switch between km/L, L/100km, or mpg
The tariff field pre-fills with the last recorded value to reduce repetitive entry.
The report uses a pivoted layout with HEV, EV, and Combined as rows:
| Distance | Fuel/Energy | Efficiency | Cost | Cost/km | |
|---|---|---|---|---|---|
| HEV | 481 km | 43.27 L | 11.12 km/L | ₱2,460.13 | ₱5.11 |
| EV | 735 km | 134.3 kWh | 5.47 km/kWh | ₱1,947.35 | ₱2.65 |
| Combined | 1,216 km | — | 15.69 km/L* | ₱4,407.48 | ₱3.62 |
| Distance | Fuel/Energy | Efficiency | Cost | Cost/km | |
|---|---|---|---|---|---|
| HEV | 1,620 km | 140.71 L | 11.51 km/L | ₱7,761.19 | ₱4.79 |
| EV | 2,445 km | 420.2 kWh | 5.82 km/kWh | ₱6,092.90 | ₱2.49 |
| Combined | 4,065 km | — | 16.18 km/L* | ₱13,854.09 | ₱3.41 |
Usage: 40% F / 60% EV (last) · 40% F / 60% EV (cumulative)
* Combined efficiency: EV cost converted to equivalent fuel liters
The combined efficiency metric converts EV electricity cost to equivalent fuel liters (based on your fuel price per liter), then calculates total distance divided by total equivalent fuel consumption. This gives a single km/L figure that accounts for both fuel and electricity costs.
- Efficiency units: User configurable —
km/L(default),L/100km, ormpg - Currency: Inferred from context (default: ₱ for Philippines)
- Storage: Always metric (km, L, kWh) — converted on display
Data is stored at ~/.local/share/phev-tracker/ — outside the repository — so it survives re-clones, skill reinstalls, and working directory changes:
phev_log.csv— refuel log entriesconfig.json— vehicle info and preferences (make, model, acquired, battery_soh, units)
The directory is created automatically on first run. Both files are gitignored.
- Claude Code (Pro, Max, or API key)
- Python 3 (standard library only — no pip dependencies)
Run these two commands inside Claude Code:
/plugin marketplace add marfillaster/phev-tracker
/plugin install phev-tracker@marfillaster-phev-tracker
Restart Claude Code, then type refuel or log a refuel. The skill should intercept the message and present the intent confirmation.
If you have a phev_log.csv from a previous installation:
mkdir -p ~/.local/share/phev-tracker
cp /path/to/old/phev_log.csv ~/.local/share/phev-tracker/phev_log.csv| Requirement | Detail |
|---|---|
| Python | 3.8 or later |
| Dependencies | None (standard library only) |
| Claude Code | Required to run the skill |
| Storage | ~/.local/share/phev-tracker/ |
Efficiency figures, cost calculations, and usage splits are derived from odometer and meter readings you provide. Accuracy depends on the accuracy of those inputs. Values are for personal tracking purposes and should not be used for warranty claims, tax filings, or official reporting without independent verification.