.codex-plugin/plugin.json

{
  "name": "installment-plan",
  "version": "1.0.0",
  "description": "Split an amount into a printable payment plan schedule with calendar reminders.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://installment-plan.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "payment plan",
    "installment plan",
    "payment schedule",
    "installments",
    "payment plan template",
    "deposit",
    "pay in installments",
    "calendar reminders"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Zovo Installment Planner",
    "shortDescription": "Payment plans with reminders",
    "longDescription": "Split an amount into a payment plan schedule with exact installments, due dates and a printable schedule. Zovo Installment Planner takes the amount owed, the number of installments (or how much each one is), how often they are due (weekly, every 2 weeks, twice a month, monthly or quarterly) and the first due date, and returns every installment with its due date and the balance left after it.\n\nAdd a deposit as an amount or a percent, with the date it is paid. If the parties agreed interest, add a yearly rate: the plan uses flat simple interest on the amount paid in installments and writes the method out (it is not an APR). Amounts are exact to the cent, or to the yen for currencies without cents, and the installments always add up to the total. A rounding rule decides which installment takes the leftover cents, and you can round installments to whole amounts such as 5 or 10. Due dates on the 29th to 31st move to the last day of shorter months and then return, and weekend due dates can move to the Friday before or the Monday after.\n\nYou get a printable payment schedule PDF (Letter or A4) with the payer, the payee, a reference, the schedule table and signature and date lines; an Excel workbook with the schedule and a summary; a CSV; and a calendar file with a reminder a few days before each payment.\n\nGood for customer payment plans, tuition and dental or medical bill plans, paying a friend or family member back, contractor deposits, and splitting a large purchase.\n\nLimitations: it does not collect payments or send reminders by itself, does not check credit, does not compute amortizing loan or mortgage payments or APR, skips weekends but not public holidays, and handles up to 360 installments. The schedule is not a contract and is not legal or financial advice.",
    "developerName": "Zovo",
    "category": "Finance",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://installment-plan.zovo.one",
    "supportURL": "https://installment-plan.zovo.one/support",
    "privacyPolicyURL": "https://installment-plan.zovo.one/privacy",
    "termsOfServiceURL": "https://installment-plan.zovo.one/terms",
    "defaultPrompt": [
      "Split 1200 into 6 monthly payments starting 2026-12-01",
      "Payment plan: 2500 total, 20% deposit on 2026-11-01, rest in 5 payments every 2 weeks from 2026-11-13",
      "Customer owes 840 and pays 150 every week from 2026-11-06. Make the payment schedule for Bright Lawn Care"
    ],
    "brandColor": "#0F6B5E",
    "brandColorDark": "#6FD3C1",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/installment-plan/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Equal monthly installments (starter prompt 1)",
              "prompt": "Split 1200 into 6 monthly payments starting 2026-12-01",
              "tools_triggered": "generate_installment_plan",
              "expected_behavior": "Calls generate_installment_plan with total_amount 1200, installments 6, frequency monthly, first_due_date 2026-12-01. Six installments of 200.00 from 2026-12-01 to 2027-05-01, total 1,200.00. PDF, Excel, ICS and CSV links."
            },
            {
              "description": "Deposit as a percent, then every 2 weeks (starter prompt 2)",
              "prompt": "Payment plan: 2500 total, 20% deposit on 2026-11-01, rest in 5 payments every 2 weeks from 2026-11-13",
              "tools_triggered": "generate_installment_plan",
              "expected_behavior": "Calls generate_installment_plan with deposit 20% and frequency biweekly. Deposit 500.00 on 2026-11-01, then 5 installments of 400.00 from 2026-11-13 to 2027-01-08; total 2,500.00."
            },
            {
              "description": "Leftover cent goes to the last installment",
              "prompt": "Split 1000 into 3 monthly installments, first one due 2026-11-15",
              "tools_triggered": "generate_installment_plan",
              "expected_behavior": "Calls generate_installment_plan with total_amount 1000, installments 3, first_due_date 2026-11-15. Installments 333.33, 333.33 and 333.34 (installment 3 takes the rest), last due 2027-01-15, remaining 0.00."
            },
            {
              "description": "Flat simple interest written out",
              "prompt": "Payment schedule for 5000 at 6% simple interest a year, 12 monthly payments starting 2026-12-01",
              "tools_triggered": "generate_installment_plan",
              "expected_behavior": "Calls generate_installment_plan with annual_interest_rate 6. Interest 300.00 (flat simple interest, 1 year), total 5,300.00: 11 installments of 441.67 and installment 12 of 441.63, last due 2027-11-01."
            },
            {
              "description": "Fixed installment amount with a smaller last one (starter prompt 3)",
              "prompt": "Customer owes 840 and pays 150 every week from 2026-11-06. Make the payment schedule for Bright Lawn Care",
              "tools_triggered": "generate_installment_plan",
              "expected_behavior": "Calls generate_installment_plan with installment_amount 150, frequency weekly, payee_name Bright Lawn Care. 6 installments: five of 150.00 and installment 6 of 90.00, from 2026-11-06 to 2026-12-11."
            }
          ],
          "negative": [
            {
              "description": "Amortizing mortgage payment and APR are out of scope. Expected: the tool is not called; the assistant answers without this plugin or points to a loan calculator.",
              "prompt": "What is my monthly payment on a 30-year mortgage of 400000 at 6.5% APR?"
            },
            {
              "description": "Legal advice about a payment agreement is out of scope. Expected: the tool is not called; the assistant does not give legal advice through this plugin.",
              "prompt": "Is a payment plan agreement I wrote myself legally enforceable in California?"
            },
            {
              "description": "Collecting money or setting up automatic bank payments is out of scope. Expected: the tool is not called; the assistant explains the plugin does not collect or move money.",
              "prompt": "Set up automatic withdrawals from my bank account for my car payments"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://installment-plan.zovo.one/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: installment plans by count or fixed amount, weekly to quarterly, optional deposit and flat simple interest, rounding rules, month-end and weekend date rules, printable PDF schedule with signature lines, Excel, CSV and calendar reminders.",
        "translations": {
          "pl-PL": {
            "subtitle": "Plany sp\u0142at z przypomnieniami",
            "description": "Podziel kwot\u0119 na harmonogram p\u0142atno\u015bci z dok\u0142adnymi ratami, terminami i harmonogramem do wydruku. Zovo Installment Planner przyjmuje nale\u017cn\u0105 kwot\u0119, liczb\u0119 rat (albo wysoko\u015b\u0107 jednej raty), cz\u0119stotliwo\u015b\u0107 (co tydzie\u0144, co 2 tygodnie, dwa razy w miesi\u0105cu, co miesi\u0105c lub co kwarta\u0142) i termin pierwszej raty, a zwraca ka\u017cd\u0105 rat\u0119 z terminem i saldem pozosta\u0142ym po jej zap\u0142acie.\n\nMo\u017cesz doda\u0107 zaliczk\u0119 jako kwot\u0119 lub procent, z dat\u0105 wp\u0142aty. Je\u015bli strony uzgodni\u0142y odsetki, podaj roczn\u0105 stop\u0119: plan stosuje proste odsetki liczone od kwoty sp\u0142acanej w ratach i opisuje metod\u0119 (to nie jest RRSO). Kwoty s\u0105 dok\u0142adne co do grosza, a raty zawsze sumuj\u0105 si\u0119 do ca\u0142o\u015bci. Regu\u0142a zaokr\u0105glania decyduje, kt\u00f3ra rata przejmuje reszt\u0119 groszy. Terminy przypadaj\u0105ce na 29.\u201331. dzie\u0144 przechodz\u0105 na ostatni dzie\u0144 kr\u00f3tszych miesi\u0119cy, a terminy w weekend mog\u0105 zosta\u0107 przesuni\u0119te na pi\u0105tek lub poniedzia\u0142ek.\n\nOtrzymujesz harmonogram PDF do druku (Letter lub A4) z p\u0142atnikiem, odbiorc\u0105, numerem referencyjnym, tabel\u0105 i miejscami na podpisy, skoroszyt Excel, plik CSV oraz plik kalendarza z przypomnieniem przed ka\u017cd\u0105 p\u0142atno\u015bci\u0105.\n\nOgraniczenia: nie pobiera p\u0142atno\u015bci, nie sprawdza zdolno\u015bci kredytowej, nie liczy rat kredytu annuitetowego ani RRSO, pomija weekendy, ale nie \u015bwi\u0119ta, obs\u0142uguje do 360 rat. Harmonogram nie jest umow\u0105 ani porad\u0105 prawn\u0105 czy finansow\u0105."
          },
          "de-DE": {
            "subtitle": "Ratenpl\u00e4ne mit Erinnerungen",
            "description": "Teilen Sie einen Betrag in einen Zahlungsplan mit exakten Raten, F\u00e4lligkeiten und einem druckbaren Ratenplan auf. Zovo Installment Planner nimmt den geschuldeten Betrag, die Anzahl der Raten (oder die H\u00f6he jeder Rate), den Rhythmus (w\u00f6chentlich, alle 2 Wochen, zweimal im Monat, monatlich oder viertelj\u00e4hrlich) und das erste F\u00e4lligkeitsdatum und liefert jede Rate mit F\u00e4lligkeit und dem Restbetrag danach.\n\nF\u00fcgen Sie eine Anzahlung als Betrag oder Prozentsatz mit Datum hinzu. Wenn die Parteien Zinsen vereinbart haben, geben Sie einen Jahreszins an: Der Plan verwendet einfache Zinsen auf den in Raten gezahlten Betrag und beschreibt die Methode (kein effektiver Jahreszins). Betr\u00e4ge sind centgenau, und die Raten ergeben immer die Gesamtsumme. Eine Rundungsregel bestimmt, welche Rate die restlichen Cent \u00fcbernimmt. F\u00e4lligkeiten am 29. bis 31. r\u00fccken in k\u00fcrzeren Monaten auf den Monatsletzten, Wochenendtermine k\u00f6nnen auf Freitag oder Montag verschoben werden.\n\nSie erhalten einen druckbaren Zahlungsplan als PDF (Letter oder A4) mit Zahler, Empf\u00e4nger, Referenz, Tabelle und Unterschriftszeilen, eine Excel-Datei, eine CSV-Datei und eine Kalenderdatei mit einer Erinnerung vor jeder Zahlung.\n\nEinschr\u00e4nkungen: Es zieht keine Zahlungen ein, pr\u00fcft keine Bonit\u00e4t, berechnet keine Annuit\u00e4tendarlehen oder effektiven Jahreszins, ber\u00fccksichtigt Wochenenden, aber keine Feiertage, und unterst\u00fctzt bis zu 360 Raten. Der Plan ist kein Vertrag und keine Rechts- oder Finanzberatung."
          },
          "es-ES": {
            "subtitle": "Planes de pago y recordatorios",
            "description": "Divide un importe en un calendario de pagos con cuotas exactas, fechas de vencimiento y un calendario imprimible. Zovo Installment Planner recibe el importe adeudado, el n\u00famero de cuotas (o el importe de cada una), la frecuencia (semanal, cada 2 semanas, dos veces al mes, mensual o trimestral) y la fecha del primer pago, y devuelve cada cuota con su fecha y el saldo pendiente despu\u00e9s de pagarla.\n\nA\u00f1ade un anticipo como importe o porcentaje, con su fecha. Si las partes acordaron intereses, indica una tasa anual: el plan aplica inter\u00e9s simple sobre el importe pagado en cuotas y explica el m\u00e9todo (no es una TAE). Los importes son exactos al c\u00e9ntimo y las cuotas siempre suman el total. Una regla de redondeo decide qu\u00e9 cuota absorbe los c\u00e9ntimos restantes. Los vencimientos del 29 al 31 pasan al \u00faltimo d\u00eda de los meses m\u00e1s cortos, y las fechas en fin de semana pueden moverse al viernes anterior o al lunes siguiente.\n\nObtienes un calendario de pagos en PDF (Letter o A4) con pagador, beneficiario, referencia, tabla y l\u00edneas de firma, un libro de Excel, un CSV y un archivo de calendario con un recordatorio antes de cada pago.\n\nLimitaciones: no cobra pagos, no eval\u00faa el cr\u00e9dito, no calcula cuotas de pr\u00e9stamos amortizables ni la TAE, no tiene en cuenta los festivos y admite hasta 360 cuotas. El calendario no es un contrato ni asesoramiento legal o financiero."
          },
          "fr-FR": {
            "subtitle": "\u00c9ch\u00e9anciers avec rappels",
            "description": "Divisez un montant en \u00e9ch\u00e9ancier de paiement avec des \u00e9ch\u00e9ances exactes, des dates et un \u00e9ch\u00e9ancier imprimable. Zovo Installment Planner prend le montant d\u00fb, le nombre d'\u00e9ch\u00e9ances (ou le montant de chacune), la fr\u00e9quence (hebdomadaire, toutes les 2 semaines, deux fois par mois, mensuelle ou trimestrielle) et la date de la premi\u00e8re \u00e9ch\u00e9ance, puis renvoie chaque \u00e9ch\u00e9ance avec sa date et le solde restant.\n\nAjoutez un acompte en montant ou en pourcentage, avec sa date. Si les parties ont convenu d'int\u00e9r\u00eats, indiquez un taux annuel : le plan applique un int\u00e9r\u00eat simple sur le montant pay\u00e9 en \u00e9ch\u00e9ances et d\u00e9crit la m\u00e9thode (ce n'est pas un TAEG). Les montants sont exacts au centime et les \u00e9ch\u00e9ances totalisent toujours le montant d\u00fb. Une r\u00e8gle d'arrondi choisit l'\u00e9ch\u00e9ance qui re\u00e7oit les centimes restants. Les \u00e9ch\u00e9ances du 29 au 31 passent au dernier jour des mois plus courts, et les dates tombant un week-end peuvent \u00eatre avanc\u00e9es au vendredi ou report\u00e9es au lundi.\n\nVous obtenez un \u00e9ch\u00e9ancier PDF imprimable (Letter ou A4) avec payeur, b\u00e9n\u00e9ficiaire, r\u00e9f\u00e9rence, tableau et lignes de signature, un classeur Excel, un CSV et un fichier calendrier avec un rappel avant chaque paiement.\n\nLimites : il n'encaisse pas de paiements, ne v\u00e9rifie pas la solvabilit\u00e9, ne calcule ni pr\u00eat amortissable ni TAEG, ignore les jours f\u00e9ri\u00e9s et g\u00e8re jusqu'\u00e0 360 \u00e9ch\u00e9ances. L'\u00e9ch\u00e9ancier n'est ni un contrat ni un conseil juridique ou financier."
          },
          "ja-JP": {
            "subtitle": "\u5206\u5272\u6255\u3044\u306e\u8a08\u753b\u3068\u30ea\u30de\u30a4\u30f3\u30c0\u30fc",
            "description": "\u91d1\u984d\u3092\u5206\u5272\u6255\u3044\u306e\u30b9\u30b1\u30b8\u30e5\u30fc\u30eb\u306b\u5206\u3051\u3001\u6b63\u78ba\u306a\u5404\u56de\u306e\u91d1\u984d\u3001\u652f\u6255\u671f\u65e5\u3001\u5370\u5237\u7528\u306e\u30b9\u30b1\u30b8\u30e5\u30fc\u30eb\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002Zovo Installment Planner \u306f\u3001\u652f\u6255\u7dcf\u984d\u3001\u56de\u6570\uff08\u307e\u305f\u306f1\u56de\u3042\u305f\u308a\u306e\u91d1\u984d\uff09\u3001\u983b\u5ea6\uff08\u6bce\u9031\u30012\u9031\u9593\u3054\u3068\u3001\u67082\u56de\u3001\u6bce\u6708\u3001\u56db\u534a\u671f\u3054\u3068\uff09\u3001\u521d\u56de\u306e\u671f\u65e5\u304b\u3089\u3001\u5404\u56de\u306e\u91d1\u984d\u3068\u671f\u65e5\u3001\u652f\u6255\u5f8c\u306e\u6b8b\u9ad8\u3092\u8fd4\u3057\u307e\u3059\u3002\n\n\u982d\u91d1\u3092\u91d1\u984d\u307e\u305f\u306f\u5272\u5408\u3067\u3001\u652f\u6255\u65e5\u3068\u3068\u3082\u306b\u8ffd\u52a0\u3067\u304d\u307e\u3059\u3002\u5f53\u4e8b\u8005\u304c\u5229\u606f\u306b\u5408\u610f\u3057\u3066\u3044\u308b\u5834\u5408\u306f\u5e74\u5229\u3092\u6307\u5b9a\u3067\u304d\u307e\u3059\u3002\u5206\u5272\u3067\u652f\u6255\u3046\u91d1\u984d\u306b\u5bfe\u3059\u308b\u5358\u5229\u3067\u8a08\u7b97\u3057\u3001\u8a08\u7b97\u65b9\u6cd5\u3092\u660e\u8a18\u3057\u307e\u3059\uff08\u5b9f\u8cea\u5e74\u7387\u3067\u306f\u3042\u308a\u307e\u305b\u3093\uff09\u3002\u91d1\u984d\u306f1\u5186\u30fb1\u30bb\u30f3\u30c8\u5358\u4f4d\u307e\u3067\u6b63\u78ba\u3067\u3001\u5404\u56de\u306e\u5408\u8a08\u306f\u5fc5\u305a\u7dcf\u984d\u3068\u4e00\u81f4\u3057\u307e\u3059\u3002\u7aef\u6570\u3092\u3069\u306e\u56de\u306b\u56de\u3059\u304b\u306f\u4e38\u3081\u30eb\u30fc\u30eb\u3067\u6c7a\u307e\u308a\u307e\u3059\u300229\u65e5\u304b\u308931\u65e5\u306e\u671f\u65e5\u306f\u77ed\u3044\u6708\u3067\u306f\u6708\u672b\u306b\u79fb\u308a\u3001\u9031\u672b\u306e\u671f\u65e5\u306f\u524d\u306e\u91d1\u66dc\u65e5\u307e\u305f\u306f\u6b21\u306e\u6708\u66dc\u65e5\u306b\u79fb\u305b\u307e\u3059\u3002\n\n\u652f\u6255\u8005\u3001\u53d7\u53d6\u4eba\u3001\u53c2\u7167\u756a\u53f7\u3001\u30b9\u30b1\u30b8\u30e5\u30fc\u30eb\u8868\u3001\u7f72\u540d\u6b04\u3068\u65e5\u4ed8\u6b04\u306e\u5165\u3063\u305f\u5370\u5237\u7528PDF\uff08Letter \u307e\u305f\u306f A4\uff09\u3001Excel \u30d6\u30c3\u30af\u3001CSV\u3001\u5404\u652f\u6255\u306e\u524d\u306b\u30ea\u30de\u30a4\u30f3\u30c0\u30fc\u304c\u5165\u308b\u30ab\u30ec\u30f3\u30c0\u30fc\u30d5\u30a1\u30a4\u30eb\u3092\u53d7\u3051\u53d6\u308c\u307e\u3059\u3002\n\n\u5236\u9650\u4e8b\u9805\uff1a\u652f\u6255\u3044\u306e\u56de\u53ce\u3001\u4e0e\u4fe1\u5be9\u67fb\u3001\u5143\u5229\u5747\u7b49\u8fd4\u6e08\u3084\u5b9f\u8cea\u5e74\u7387\u306e\u8a08\u7b97\u306f\u884c\u3044\u307e\u305b\u3093\u3002\u795d\u65e5\u306f\u8003\u616e\u305b\u305a\u3001\u6700\u5927360\u56de\u307e\u3067\u3067\u3059\u3002\u3053\u306e\u30b9\u30b1\u30b8\u30e5\u30fc\u30eb\u306f\u5951\u7d04\u66f8\u3067\u306f\u306a\u304f\u3001\u6cd5\u5f8b\u3084\u91d1\u878d\u306e\u52a9\u8a00\u3067\u3082\u3042\u308a\u307e\u305b\u3093\u3002"
          },
          "pt-BR": {
            "subtitle": "Parcelamentos com lembretes",
            "description": "Divida um valor em um cronograma de pagamento com parcelas exatas, vencimentos e um cronograma para imprimir. O Zovo Installment Planner recebe o valor devido, o n\u00famero de parcelas (ou o valor de cada uma), a frequ\u00eancia (semanal, a cada 2 semanas, duas vezes por m\u00eas, mensal ou trimestral) e a data da primeira parcela, e devolve cada parcela com o vencimento e o saldo restante depois dela.\n\nAdicione uma entrada como valor ou porcentagem, com a data. Se as partes combinaram juros, informe uma taxa anual: o plano usa juros simples sobre o valor pago em parcelas e descreve o m\u00e9todo (n\u00e3o \u00e9 o CET). Os valores s\u00e3o exatos ao centavo e as parcelas sempre somam o total. Uma regra de arredondamento define qual parcela fica com os centavos restantes. Vencimentos nos dias 29 a 31 passam para o \u00faltimo dia dos meses mais curtos, e datas em fim de semana podem ir para a sexta anterior ou a segunda seguinte.\n\nVoc\u00ea recebe um cronograma em PDF para imprimir (Letter ou A4) com pagador, recebedor, refer\u00eancia, tabela e linhas de assinatura, uma planilha do Excel, um CSV e um arquivo de calend\u00e1rio com um lembrete antes de cada pagamento.\n\nLimita\u00e7\u00f5es: n\u00e3o cobra pagamentos, n\u00e3o analisa cr\u00e9dito, n\u00e3o calcula financiamentos com amortiza\u00e7\u00e3o nem CET, n\u00e3o considera feriados e aceita at\u00e9 360 parcelas. O cronograma n\u00e3o \u00e9 um contrato nem aconselhamento jur\u00eddico ou financeiro."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}