What moves
Some items cannot move as they are:
- Plans billed every week or every quarter. AgentaOS plans are monthly or yearly.
- Prices in a currency other than EUR or USD.
- Free products and pay-what-you-want products.
- Fixed-amount discount codes in a currency other than EUR or USD.
skipped.csv with the reason, so you can create them again by hand.
Before you start
- An AgentaOS account. Sign up at app.agentaos.ai. The dashboard opens in Test mode, so you can run the full move with test money first. See Test mode and testing.
- A test API key. Open Developers → API keys in the sidebar and click Generate Test Key.
- A Lemon Squeezy API key. Create it in your Lemon Squeezy settings.
- Node.js 20 or later.
- A product that AgentaOS can sell. AgentaOS is a merchant of record for software and digital products. See Account review and Supported countries.
Copy your catalog
1
Do a dry run
Set your Lemon Squeezy key in your terminal and run the command. A dry run reads your store and writes a plan. It creates nothing.
2
Read the plan
The command writes its report to the folder
agentaos-migration. Open summary.md to see how many products, discount codes and subscribers it found. Open skipped.csv to see what stays behind, and why.3
Create the products in test mode
Set your AgentaOS test key and add You can run the command again safely. It finds the products and codes it already created and does not create them twice.
--apply.4
Pay for one product yourself
Open a new link from
products.csv and pay with the test card 4242 4242 4242 4242, any future expiry date and any CVC. Type the card only into the card form on the checkout page. The sale appears on Home in the dashboard.The report
subscribers.csv holds your customers’ email addresses. It stays on your computer. The folder gets its own .gitignore, so the file is not committed by accident.
Go live
Test mode and live mode are separate. To take real money, verify your business first. See Go live. Then generate a live API key and run the command again:Swap your links
redirects.csv pairs each Lemon Squeezy buy link with its new AgentaOS link. Replace the old links on your website, in your app and in your emails. From that moment, new buyers pay on AgentaOS.
If your app listens for Lemon Squeezy webhooks, point it at AgentaOS events too. See Webhooks.
Move your subscribers
Saved cards stay with Lemon Squeezy. A card on file belongs to the seller that collected it, and it is not handed to another seller. So each subscriber subscribes one time on the new link.1
Create a switch code
Your subscribers already paid Lemon Squeezy for their current period. A switch code makes their first AgentaOS invoice free, so nobody pays twice.The code is random. It can be used as many times as you have subscribers, and it expires after 60 days.
2
Email each subscriber before their renewal
subscribers.csv lists everyone with their renewal date and new link. Send the email in email-to-subscribers.md from your own address, one or two weeks before each renewal date.3
Cancel the old subscription
When a subscriber pays on AgentaOS, cancel their Lemon Squeezy subscription at the end of the period they paid for.
If a plan has a free trial, a moved subscriber gets that trial too. To prevent that, remove the trial from the plan in the dashboard before you send the email.
License keys
AgentaOS does not issue license keys. Keep the keys your customers already have, and issue new keys from your own app. When a sale completes, AgentaOS sends thecheckout.session.completed event to your webhook. Create and send the key there. See Webhook events.