← Files HomeLoadARCHIVED FILE
.codex-plugin/plugin.json
10.7 KB · Nov 18, 2026 · 06:19 UTC
{
"name": "homeload",
"version": "1.0.4",
"description": "Size an AC or heat pump, a generator, or check electrical-panel headroom for a US home by city or ZIP code.",
"author": {
"name": "Datacleave Ltd",
"url": "https://homeload.datacleave.com"
},
"homepage": "https://homeload.datacleave.com",
"license": "UNLICENSED",
"keywords": [
"hvac",
"air conditioner",
"heat pump",
"generator",
"electrical panel",
"ev charger",
"furnace",
"BTU",
"tonnage",
"Manual J",
"load calculation",
"standby generator",
"200 amp",
"panel upgrade",
"sizing"
],
"skills": "./skills/",
"mcpServers": "./.mcp.json",
"interface": {
"displayName": "HomeLoad",
"shortDescription": "Size home AC, generator, panel",
"longDescription": "Get the AC or heat-pump size, generator size or electrical-panel headroom for a US house, or check a size a contractor quoted. Tell HomeLoad your city or ZIP code and square feet; the result shows the county design temperatures and the standards behind it. Every card says what the figures were checked against.\n\nAC, heat pump or furnace: the cooling and heating load from floor area, stories, insulation and windows, using the county's 1% cooling and 99% heating design temperatures (EPA ENERGY STAR county reference, ASHRAE and ACCA Manual J values) and its IECC 2021 climate zone, then the range of equipment sizes in tons that ACCA Manual S allows for that load, what a heat pump of that size puts out at the design temperature, and the backup heat it leaves.\n\nGenerator: tick the appliances to keep running in an outage and get running watts, starting watts (the largest motor surge added once, the way manufacturers' sizing guides do it) and the portable or home-standby class that covers them, with fuel figures for standby units, or check whether a generator you have will run them.\n\nElectrical panel headroom: the NEC 220.83 optional calculation for an existing dwelling, step by step: general lighting by floor area, the fixed appliances at nameplate, the demand factors, then the EV charger, heat pump or appliance you want to add, with a fits / tight / upgrade verdict and the breaker size the new circuit needs.\n\nEvery result is an estimate with its inputs and a stated band, to confirm with a contractor's full Manual J or a licensed electrician. A 'Get my installer sheet' button opens the HomeLoad website with the figures, the questions to ask and where to ask them. HomeLoad needs no account and never asks for an address.",
"developerName": "Datacleave Ltd",
"category": "Other",
"capabilities": [
"Interactive"
],
"brandColor": "#9e205c",
"logo": "./assets/logo.png",
"composerIcon": "./assets/logo.png",
"websiteURL": "https://homeload.datacleave.com",
"supportURL": "https://homeload.datacleave.com/support",
"privacyPolicyURL": "https://homeload.datacleave.com/privacy",
"termsOfServiceURL": "https://homeload.datacleave.com/terms",
"defaultPrompt": [
"A contractor quoted 4 tons for my 1,800 sq ft house in Austin. Is that the right size?",
"What size generator runs my fridge, sump pump, furnace blower and lights in an outage?",
"Can my 100 A panel take a 48 A EV charger? 1,600 sq ft in Phoenix, electric range and dryer."
]
},
"extensions": {
"com.openai": {
"review": {
"test_cases": {
"positive": [
{
"description": "AC sizing with the ZIP code and square feet given, one story, no construction details (defaults: average insulation, double-pane (average) windows, 3 occupants). Austin, TX.",
"prompt": "Use HomeLoad to size the AC for my 1,800 sq ft single-story house in ZIP 78701.",
"tools_triggered": "size_hvac",
"expected_behavior": "Calls size_hvac with zip 78701, sqft 1800, stories 1 and no address. The card shows Travis County, TX, climate zone 2A, a cooling load near 29,300 Btu/h with the Manual S equipment size 2.5 tons (the band 26,400\u201333,700 Btu/h holds no other catalogue size), a heating load near 31,700 Btu/h at 30 \u00b0F, the assumptions (average insulation, double-pane (average) windows, 3 occupants), how the size moves if the insulation is poor or good, a 'Checked against' block naming the EPA ENERGY STAR county design temperatures, the ZIP and climate-zone tables and ACCA Manual S, and a 'Get my installer sheet' button. The answer gives the size in a sentence or two, names the assumption that moves it most, calls it an estimate to confirm with a contractor's Manual J, and does not repeat the table or paste the link."
},
{
"description": "Heat-pump sizing for an older two-story house where the user names a city and no ZIP code, gives the year built instead of the insulation level and names the household size. HomeLoad needs only the county, so ChatGPT picks a ZIP code in the city rather than asking. A heating-dominated climate, so the heat-pump note about Manual S's 125% allowance applies.",
"prompt": "Use HomeLoad to size a heat pump for a 2,400 sq ft two-story house built in 1965 in Minneapolis, MN, four people live there.",
"tools_triggered": "size_hvac",
"expected_behavior": "Does not ask for a ZIP code. Calls size_hvac with a ZIP code in Minneapolis (the exact ZIP may vary), sqft 2400, stories 2, year_built 1965, occupants 4 and no insulation value (the tool infers 'poor' from the year). The card shows Hennepin County, MN, zone 6A, design temperatures 88 \u00b0F and \u22128 \u00b0F, a cooling load near 37,000 Btu/h with a 3 to 3.5 ton range, and a heating load near 98,000 Btu/h; the heating note says the climate is heating-dominated, and the Heat pump row gives a cold-climate unit's output at -8 \u00b0F, says a standard unit is not counted below 5 \u00b0F, and names the backup heat from a furnace. The answer relays the range and the backup as an estimate."
},
{
"description": "Portable generator sizing from a short list of named loads. No ZIP code is needed for this tool.",
"prompt": "Use HomeLoad to size a portable generator that runs my fridge, sump pump, gas furnace blower, a few lights, the TV and internet, and a half-horsepower well pump.",
"tools_triggered": "size_generator",
"expected_behavior": "Calls size_generator with mode 'portable' and the load ids refrigerator, sump_pump, furnace_fan_gas, lights_essential, tv_and_internet, well_pump_half_hp (no custom loads). The card shows 3,900 W running and 5,900 W starting (the well pump's 2,000 W surge added once), the load bars largest surge first, and the class 'Portable 5\u20136.5 kW' or the next size up inside a fold. The answer names the running and starting figures and the transfer-switch warning, and does not recommend a brand."
},
{
"description": "Home standby generator sizing where a 3-ton central air conditioner is the largest surge, with a gas water heater and furnace blower among the loads.",
"prompt": "Use HomeLoad to size a standby generator for a 3-ton central AC, the fridge, whole-house lights, the gas furnace blower, a half-horsepower well pump and a gas water heater.",
"tools_triggered": "size_generator",
"expected_behavior": "Calls size_generator with mode 'standby' and the ids central_ac_3t, refrigerator, lights_whole_house, furnace_fan_gas, well_pump_half_hp, water_heater_gas. The card shows 8,400 W running and 18,400 W starting (the air conditioner's 10,000 W surge added once), the class 'Standby 22 kW', a soft-starter line naming a smaller class, and fuel figures with the natural-gas rating. The answer gives those figures as an estimate and notes that a standby unit needs an automatic transfer switch installed by an electrician."
},
{
"description": "Panel headroom for adding a 48 A EV charger to a 100 A service in Phoenix, AZ, with an electric range, an electric dryer and a 3-ton central AC already on the panel. Under NEC 220.83(A) the result is an upgrade verdict.",
"prompt": "Use HomeLoad to check if my 100 amp panel can take a 48 amp EV charger. 1,600 sq ft house in 85032 with an electric range, electric dryer and a 3-ton central AC.",
"tools_triggered": "panel_headroom",
"expected_behavior": "Calls panel_headroom with zip 85032, sqft 1600, panel_amps 100, major_loads electric_range, dryer_electric, central_ac_3t and new_load ev_charger_48a. The card shows the method NEC 220.83(A), a calculated load near 121 A on a 100 A service, the verdict 'Over the rating' with about 21 A over the rating, a 60 A breaker for the new circuit, the NEC 220.87 measured-demand route, and the numbered breakdown (lighting 4,800 VA, small-appliance and laundry 4,500 VA, the appliances at nameplate, first 8,000 VA at 100% and the rest at 40%, the EV charger at 100%). The card also says whether a smaller listed charger would fit (here none does without load management). The answer says the panel does not have the headroom under this calculation and that a licensed electrician must confirm, without approving or forbidding the work itself."
}
],
"negative": [
{
"description": "A maintenance question with nothing to size. HomeLoad must not be called; ChatGPT answers from its own knowledge.",
"prompt": "How often should I change the filter on my central AC?"
},
{
"description": "A brand-comparison question. HomeLoad sizes equipment and never recommends brands, so it must not be called.",
"prompt": "Is Carrier or Trane the better heat pump brand?"
},
{
"description": "A commercial building. HomeLoad covers single-family houses only and must not be called for a warehouse rooftop unit.",
"prompt": "What size rooftop unit do I need for a 20,000 square foot warehouse in Dallas?"
}
]
},
"demo_recording_url": "https://www.youtube.com/watch?v=PUmPPQzXKYI",
"commerce": false,
"commerce_description": "HomeLoad does not sell products, take payments or process transactions. Its 'Get my installer sheet' or 'Get my electrician sheet' button opens the HomeLoad website (our own domain), which shows the sizing sheet and links to third-party installer directories; those links pass through our site, which counts clicks and attaches no referral code."
},
"publication": {
"release_notes": "Initial release: AC and heat-pump sizing by city or ZIP code, generator sizing, and NEC 220.83 panel headroom."
}
}
},
"apps": "./.app.json"
}
SHA-256: 0f28e58126c20223be1ac892b244a2d00c72026fd143b0a39f2adf25f44fad44