Activate Pro
From checkout to your first Pro section in a few minutes. One license key unlocks the CLI, your coding agents, the source on the site and the Figma library.
Koala UI has no accounts. Your license key is the whole login: Lemon Squeezy issues it at checkout, and the same key works everywhere below. Activate it once on your machine and every Pro component, section, page and template installs like a free one, for you and for any coding agent working there.
Where your key works#
| Where | How | Seat |
|---|---|---|
| Your terminal | login <key>, once per machine | Takes your seat |
| Coding agents | Nothing extra: Claude Code, Codex and Cursor run the CLI as you | Shares that seat |
| Source on the site | /account, with your purchase email | None |
| Figma library | The link in your receipt email | None |
A license is one seat for one person: one machine activated at a time, plus the site and Figma wherever you like.
From checkout to Pro#
Find your key
Lemon Squeezy emails it with your receipt, next to the Figma library. Not there? Check spam, or open your orders and sign in with the email you paid with. It looks like this:
38b1460a-5104-4067-a91d-77b872934d51Activate it in your terminal
Run it yourself, once, in any folder. It claims your seat and saves the key to
~/.koalaui/config.json, readable by you only. A wrong key fails here, not later. Typing it in your own terminal keeps it out of chat transcripts.npx koalaui-cli@latest whoamiconfirms the license and that this machine is activated.Hand it to your agent
Your agent already has Pro. When Claude Code, Codex or Cursor runs
addon this machine, the CLI reads the seat you just activated. Paste this into your agent, in your project, to set everything up and install the Koala skill so it reaches for the CLI instead of writing look-alikes:Set up Koala UI Pro in this project. My license is already activated on this machine: confirm it with npx koalaui-cli@latest whoami. If there is no koala.json, run npx koalaui-cli@latest init and do every step it prints. Then run npx koalaui-cli@latest skill and follow the skill from now on. Install every Koala piece I ask for with npx koalaui-cli@latest add <name>, Pro ones included, and never rebuild a Koala component by hand.Install your first Pro item
Ask your agent for one, or add it yourself.
npx koalaui-cli@latest listshows everything, with a lock on each Pro item. A whole site starts from a template.Unlock the site, if you want to read first
Enter the key and your purchase email at /account. The Code tab of every Pro component and section then shows its files. It uses no seat.
Working with an agent#
Pro items arrive as source in your repo, so an agent reads and edits them like your own code. The open docs leave Pro examples out, but your license fills the gap: run after activating, npx koalaui-cli@latest skill writes a reference for every Pro component, examples included, so the agent plans with the right parts before it installs anything. They are licensed to you: keep them out of a public repo. More in AI and agents.
One seat, several places#
| Situation | What to do |
|---|---|
| New machine | Run npx koalaui-cli@latest logout on the old one, then login on the new one. |
| CI and deploys | Nothing. The source is committed to your repo, so a build never calls Koala. Only a pipeline that runs add itself needs a seat. |
| Cloud agents | Same as CI: they work from the code you committed. Add Pro items on your machine, push, and the cloud agent builds with them. |
| WSL or a container | It has its own home folder, so it is a separate machine. Run whoami there to check. |
A pipeline that must install on its own takes the seat with npx koalaui-cli@latest login <key> --name ci --no-save; see Installation.