.codex-plugin/plugin.json

{
  "name": "bill-calendar",
  "version": "1.0.0",
  "description": "A printable bill payment calendar, reminders for each bill, and which paycheck pays which bill.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://bill-calendar.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "bill payment calendar",
    "bill tracker printable",
    "monthly bill calendar",
    "bill calendar",
    "bill due date calendar",
    "bill reminders",
    "paycheck budget",
    "which paycheck pays which bill",
    "bill pay schedule",
    "ics"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Bill Calendar",
    "shortDescription": "Bill calendar and reminders",
    "longDescription": "Make a bill payment calendar from your list of bills: a printable monthly bill calendar, a reminder in your own calendar before each bill, and a plan that shows which paycheck pays which bill. Zovo Bill Calendar takes each bill's name, amount, due day or date, how often it repeats (monthly, weekly, biweekly, twice a month, quarterly, semiannual, yearly or once) and whether it is on autopay.\n\nThe bill tracker printable has one landscape page per month, Letter or A4, with each bill written on its due day with its amount, paydays marked, a total for each day with 2 or more bills and a total for the month. You choose 1 to 12 months.\n\nA bill due on the 29th, 30th or 31st moves to the last day of a shorter month (a phone bill due on the 31st is due on February 28), and the calendar says so. An optional weekend rule moves a Saturday or Sunday due date to the Friday before or the Monday after.\n\nThe calendar file (ICS) has one event per bill payment with a reminder 2 days before at 9:00 by default; you can set the days and the time. It imports into Google Calendar, Outlook and Apple Calendar.\n\nAdd your paychecks (amount, how often and one pay date) and the Excel plan assigns each bill to the last paycheck on or before its due date, with the money left from each paycheck and a warning when a paycheck does not cover its bills. Give the money in your account before the first paycheck in the plan and it also shows the lowest point.\n\nBills can be typed, pasted as a list, or read from a screenshot by the assistant. The tool does not pay bills or connect to bank accounts, and the business-day rule skips weekends only, not bank holidays. Up to 60 bills, 8 paychecks and 12 months per calendar.",
    "developerName": "Zovo",
    "category": "Finance",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://bill-calendar.zovo.one",
    "supportURL": "https://bill-calendar.zovo.one/support",
    "privacyPolicyURL": "https://bill-calendar.zovo.one/privacy",
    "termsOfServiceURL": "https://bill-calendar.zovo.one/terms",
    "defaultPrompt": [
      "Bill calendar Nov 2026-Jan 2027: rent 1500 on the 1st, phone 65 on the 31st autopay, car 389 on the 15th, gym 25 on the 30th",
      "Which paycheck pays which bill? Paid 2,100 biweekly from Nov 6 2026; rent 1,500 on 1st, car 389 on 15th, phone 65 on 31st",
      "Bill tracker printable, Dec 2026, A4, weekend dues to Fri: rent 1200 on 5th, insurance 300 quarterly from Dec 20, water 45 on 31"
    ],
    "brandColor": "#8C295C",
    "brandColorDark": "#f09cc6",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/bill-calendar/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Three-month calendar with a bill on the 31st (starter prompt 1)",
              "prompt": "Bill calendar Nov 2026-Jan 2027: rent 1500 on the 1st, phone 65 on the 31st autopay, car 389 on the 15th, gym 25 on the 30th",
              "tools_triggered": "generate_bill_calendar",
              "expected_behavior": "Calls generate_bill_calendar with start_month 2026-11, months 3 and 4 bills. 12 bill payments, 5,937.00 in total, 1,979.00 each month. Phone moves to Nov 30. PDF, ICS and Excel links."
            },
            {
              "description": "Biweekly paychecks (starter prompt 2)",
              "prompt": "Which paycheck pays which bill? Paid 2,100 biweekly from Nov 6 2026; rent 1,500 on 1st, car 389 on 15th, phone 65 on 31st",
              "tools_triggered": "generate_bill_calendar",
              "expected_behavior": "Calls generate_bill_calendar with a biweekly paycheck of 2100 from 2026-11-06. The Nov 6 paycheck pays the car 389.00 (left 1,711.00); the Nov 20 paycheck pays phone 65.00 and the Dec 1 rent 1,500.00 (left 535.00)."
            },
            {
              "description": "A4 with the weekend rule (starter prompt 3)",
              "prompt": "Bill tracker printable, Dec 2026, A4, weekend dues to Fri: rent 1200 on 5th, insurance 300 quarterly from Dec 20, water 45 on 31",
              "tools_triggered": "generate_bill_calendar",
              "expected_behavior": "Calls generate_bill_calendar for December 2026 with page_size A4 and weekend_rule previous_business_day. Rent moves from Sat Dec 5 to Fri Dec 4, insurance from Sun Dec 20 to Fri Dec 18; total 1,545.00."
            },
            {
              "description": "Reminders 3 days before",
              "prompt": "Bill reminders 3 days before for Jan and Feb 2027: rent 1500 on the 1st, credit card 200 on the 28th, streaming 15.99 on the 30th",
              "tools_triggered": "generate_bill_calendar",
              "expected_behavior": "Calls generate_bill_calendar with reminder_days_before 3 for January and February 2027. 6 bill payments, 3,431.98 in total; streaming moves to Feb 28. The ICS file has a reminder 3 days before each bill."
            },
            {
              "description": "Twice-a-month pay and a starting balance",
              "prompt": "Bill plan for Feb 2027: paid 1,800 on the 15th and the last day; 400 in the bank now; rent 1,300 on the 1st, car 350 on the 20th, phone 60 on 31st",
              "tools_triggered": "generate_bill_calendar",
              "expected_behavior": "Calls generate_bill_calendar with a semimonthly 1800 paycheck and starting_balance 400. The Jan 31 paycheck pays rent 1,300.00 (left 500.00), Feb 15 pays the car 350.00 (left 1,450.00), Feb 28 pays the phone 60.00."
            }
          ],
          "negative": [
            {
              "description": "Budget advice without bills to schedule. Expected: no call to generate_bill_calendar.",
              "prompt": "How much of my salary should go to rent?"
            },
            {
              "description": "Paying a bill is an action the tool cannot take. Expected: the assistant answers directly without a tool.",
              "prompt": "Pay my electric bill for me"
            },
            {
              "description": "A calendar of holidays is a different job. Expected: no call to generate_bill_calendar.",
              "prompt": "Make me a printable 2027 calendar with US holidays"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://bill-calendar.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: printable monthly bill calendar PDF, ICS reminders per bill, and a paycheck plan in Excel that assigns each bill to the last paycheck on or before its due date.",
        "translations": {
          "pl-PL": {
            "subtitle": "Kalendarz rachunk\u00f3w",
            "description": "Kalendarz p\u0142atno\u015bci rachunk\u00f3w z listy rachunk\u00f3w: miesi\u0119czny kalendarz do druku, przypomnienie w Twoim kalendarzu przed ka\u017cdym rachunkiem i plan, kt\u00f3ry pokazuje, z kt\u00f3rej wyp\u0142aty zap\u0142aci\u0107 kt\u00f3ry rachunek. Podajesz nazw\u0119, kwot\u0119, dzie\u0144 lub dat\u0119 p\u0142atno\u015bci, cz\u0119stotliwo\u015b\u0107 (co miesi\u0105c, co tydzie\u0144, co 2 tygodnie, dwa razy w miesi\u0105cu, co kwarta\u0142, co p\u00f3\u0142 roku, co rok lub raz) i informacj\u0119 o p\u0142atno\u015bci automatycznej. Rachunek p\u0142atny 29., 30. lub 31. dnia przesuwa si\u0119 na ostatni dzie\u0144 kr\u00f3tszego miesi\u0105ca. Opcjonalnie termin w weekend przesuwa si\u0119 na pi\u0105tek przed nim. Plik ICS ma przypomnienie 2 dni przed ka\u017cdym rachunkiem, a plan Excel przypisuje ka\u017cdy rachunek do ostatniej wyp\u0142aty w dniu terminu lub przed nim i pokazuje, ile zostaje. Narz\u0119dzie nie p\u0142aci rachunk\u00f3w."
          },
          "de-DE": {
            "subtitle": "Rechnungskalender",
            "description": "Ein Zahlungskalender f\u00fcr Ihre Rechnungen: ein druckbarer Monatskalender, eine Erinnerung im eigenen Kalender vor jeder Rechnung und ein Plan, welches Gehalt welche Rechnung bezahlt. Sie geben Name, Betrag, F\u00e4lligkeitstag oder Datum, Rhythmus (monatlich, w\u00f6chentlich, alle 2 Wochen, zweimal im Monat, viertelj\u00e4hrlich, halbj\u00e4hrlich, j\u00e4hrlich oder einmalig) und Lastschrift an. Eine Rechnung zum 29., 30. oder 31. r\u00fcckt in k\u00fcrzeren Monaten auf den letzten Tag. Optional r\u00fccken F\u00e4lligkeiten am Wochenende auf den Freitag davor. Die ICS-Datei erinnert 2 Tage vor jeder Rechnung, und der Excel-Plan ordnet jede Rechnung dem letzten Gehalt am oder vor dem F\u00e4lligkeitstag zu, mit dem verbleibenden Betrag. Das Tool bezahlt keine Rechnungen."
          },
          "es-ES": {
            "subtitle": "Calendario de facturas",
            "description": "Un calendario de pago de facturas a partir de su lista: un calendario mensual para imprimir, un recordatorio en su propio calendario antes de cada factura y un plan que muestra qu\u00e9 n\u00f3mina paga cada factura. Indique nombre, importe, d\u00eda o fecha de vencimiento, frecuencia (mensual, semanal, cada 2 semanas, dos veces al mes, trimestral, semestral, anual o una vez) y si est\u00e1 domiciliada. Una factura que vence el 29, 30 o 31 pasa al \u00faltimo d\u00eda de los meses m\u00e1s cortos. Opcionalmente, un vencimiento en fin de semana pasa al viernes anterior. El archivo ICS avisa 2 d\u00edas antes de cada factura y el plan en Excel asigna cada factura al \u00faltimo cobro en su fecha o antes, con el dinero que queda. La herramienta no paga facturas."
          },
          "fr-FR": {
            "subtitle": "Calendrier des factures",
            "description": "Un calendrier de paiement de vos factures : un calendrier mensuel \u00e0 imprimer, un rappel dans votre propre agenda avant chaque facture et un plan qui montre quelle paie r\u00e8gle quelle facture. Indiquez le nom, le montant, le jour ou la date d'\u00e9ch\u00e9ance, la fr\u00e9quence (mensuelle, hebdomadaire, toutes les 2 semaines, deux fois par mois, trimestrielle, semestrielle, annuelle ou unique) et le pr\u00e9l\u00e8vement automatique. Une facture due le 29, le 30 ou le 31 passe au dernier jour des mois plus courts. En option, une \u00e9ch\u00e9ance le week-end passe au vendredi pr\u00e9c\u00e9dent. Le fichier ICS rappelle chaque facture 2 jours avant, et le plan Excel affecte chaque facture \u00e0 la derni\u00e8re paie \u00e0 sa date ou avant, avec le reste. L'outil ne paie pas les factures."
          },
          "ja-JP": {
            "subtitle": "\u8acb\u6c42\u66f8\u306e\u652f\u6255\u3044\u30ab\u30ec\u30f3\u30c0\u30fc",
            "description": "\u8acb\u6c42\u66f8\u306e\u4e00\u89a7\u304b\u3089\u652f\u6255\u3044\u30ab\u30ec\u30f3\u30c0\u30fc\u3092\u4f5c\u308a\u307e\u3059\u3002\u5370\u5237\u3067\u304d\u308b\u6708\u9593\u30ab\u30ec\u30f3\u30c0\u30fc\u3001\u5404\u8acb\u6c42\u66f8\u306e\u524d\u306b\u5c4a\u304f\u30ab\u30ec\u30f3\u30c0\u30fc\u306e\u30ea\u30de\u30a4\u30f3\u30c0\u30fc\u3001\u3069\u306e\u7d66\u6599\u3067\u3069\u306e\u8acb\u6c42\u66f8\u3092\u6255\u3046\u304b\u3092\u793a\u3059\u8a08\u753b\u8868\u3067\u3059\u3002\u540d\u524d\u3001\u91d1\u984d\u3001\u652f\u6255\u65e5\u307e\u305f\u306f\u65e5\u4ed8\u3001\u983b\u5ea6(\u6bce\u6708\u3001\u6bce\u9031\u30012\u9031\u9593\u3054\u3068\u3001\u67082\u56de\u3001\u56db\u534a\u671f\u3001\u534a\u5e74\u3001\u6bce\u5e74\u30011\u56de)\u3001\u81ea\u52d5\u5f15\u304d\u843d\u3068\u3057\u306e\u6709\u7121\u3092\u5165\u529b\u3057\u307e\u3059\u300229\u65e5\u300130\u65e5\u300131\u65e5\u304c\u671f\u65e5\u306e\u8acb\u6c42\u66f8\u306f\u3001\u77ed\u3044\u6708\u3067\u306f\u6708\u672b\u65e5\u306b\u79fb\u308a\u307e\u3059\u3002\u9031\u672b\u306e\u671f\u65e5\u3092\u524d\u306e\u91d1\u66dc\u65e5\u306b\u79fb\u3059\u3053\u3068\u3082\u3067\u304d\u307e\u3059\u3002ICS\u30d5\u30a1\u30a4\u30eb\u306f\u5404\u8acb\u6c42\u66f8\u306e2\u65e5\u524d\u306b\u901a\u77e5\u3057\u3001Excel\u306e\u8a08\u753b\u8868\u306f\u5404\u8acb\u6c42\u66f8\u3092\u671f\u65e5\u5f53\u65e5\u304b\u305d\u308c\u4ee5\u524d\u306e\u6700\u5f8c\u306e\u7d66\u6599\u306b\u5272\u308a\u5f53\u3066\u3001\u6b8b\u308b\u91d1\u984d\u3092\u793a\u3057\u307e\u3059\u3002\u652f\u6255\u3044\u305d\u306e\u3082\u306e\u306f\u884c\u3044\u307e\u305b\u3093\u3002"
          },
          "pt-BR": {
            "subtitle": "Calend\u00e1rio de contas",
            "description": "Um calend\u00e1rio de pagamento das suas contas: um calend\u00e1rio mensal para imprimir, um lembrete na sua agenda antes de cada conta e um plano que mostra qual sal\u00e1rio paga qual conta. Informe nome, valor, dia ou data de vencimento, frequ\u00eancia (mensal, semanal, a cada 2 semanas, duas vezes por m\u00eas, trimestral, semestral, anual ou \u00fanica) e se \u00e9 d\u00e9bito autom\u00e1tico. Uma conta que vence no dia 29, 30 ou 31 passa para o \u00faltimo dia dos meses mais curtos. Opcionalmente, um vencimento no fim de semana passa para a sexta-feira anterior. O arquivo ICS lembra 2 dias antes de cada conta, e o plano em Excel atribui cada conta ao \u00faltimo pagamento na data ou antes, com o que sobra. A ferramenta n\u00e3o paga contas."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}