First launch and setup
A one-minute setup walks you through location, AI, project folder, permissions and motion skills.
The first time you open EaseKit, a short setup assistant guides you through everything it needs: where the app lives, which AI to use, where files go, two optional permissions and the motion knowledge the AI works from. Every step can be changed later in Settings (⌘,), so nothing you pick here is final.
The setup steps
- Welcome. A short introduction. Click Get started.
- Move to Applications. If EaseKit isn't there yet, click Move and relaunch. It needs to be in Applications to update itself.
- Connect AI. Choose your Claude or ChatGPT subscription, or paste an API key. See Connect an AI provider.
- Project folder. Choose where exports and saved projects go by default (Choose…), or keep the default with Use default.
- Permissions. Both are optional: Screen Recording is only for the UI Recorder, and Terminal control only lets EaseKit type the install or sign-in command for you.
- Motion knowledge. EaseKit ships with a curated knowledge base of motion skills. Add the rest of the motion stack installs community skills in the background (this needs Node.js; you can keep going meanwhile).
- You're all set. Click Start to describe your first animation, or View examples to open a sample session first.
What each choice affects
| Step | Changes later in | If you skip it |
|---|---|---|
| Connect AI | Settings → Providers | You can still open samples, templates and edit by hand. The chat asks you to set up a provider when you send |
| Project folder | Settings → General → Data → Project folder | Saves and exports default to the folder EaseKit picked |
| Screen Recording | System Settings → Privacy & Security | The UI Recorder asks for it when you first start it |
| Terminal control | System Settings → Privacy & Security → Automation | EaseKit copies commands instead, and you paste them with ⌘V |
| Motion knowledge | Settings → Skills → Complete the motion stack | The bundled skills still cover every task |
Explore without an AI
You can look around before connecting anything. Help → Open Sample Session opens annotated example animations on the stage, and Help → Open Look Alive Demo opens a full 10-second launch video made in EaseKit. Both are ordinary sessions: scrub them, select layers, open the inspector and change things.
Run setup again
Open Settings → General → Reset and click Run again next to Setup. The assistant appears the next time you open EaseKit. Your API keys, sessions, skills and styles are kept.
Troubleshooting
| If this happens | Try this |
|---|---|
| Move and relaunch doesn't appear | EaseKit is already in Applications. Nothing to do. |
| The motion stack install stalls | It needs Node.js (npx). Install Node, then use Settings → Skills → Complete the motion stack. |
| You declined a permission by mistake | Turn it on in System Settings → Privacy & Security. macOS may ask you to reopen EaseKit. |