Frequently asked questions
The questions new users ask most. If something is broken rather than confusing, jump to Troubleshooting instead.
Setup and accounts
Do I need a developer account or any coding experience?+
No. You will create a free account with at least one AI provider (Anthropic, OpenAI, or Google), generate an API key, and paste it into Settings. The whole setup takes about two minutes. After that, you talk to the panel in natural language.
What does Sidekick cost?+
Two separate things. Sidekick itself is a paid panel – you buy a license once from sidekick-ae.com and activate it on up to two machines. Then your AI provider bills you per use for the actual generation. See Licensing & activation for the license side.
How much do the AI API calls cost?+
That part is up to your provider, but generating expressions and scripts is cheap – typically pennies a day for everyday use. Most providers ask you to add a few dollars in credits to get started.
Where are my API keys stored?+
Locally, on your machine, in the panel's localStorage. They are never sent to us. They are lightly obfuscated but not encrypted, so treat the panel like any other app you have signed into.
Can I use Sidekick without an internet connection?+
No. The panel calls the AI providers directly over HTTPS, so you need to be online for it to generate code. Once you have a generated expression or saved script, running and applying happens locally and works offline. (Your license also keeps working offline for 14 days – see Licensing & activation.) A local-model option is on the wishlist.
Licensing and activation
Do I have to buy Sidekick?+
Yes. Sidekick is a paid panel. Buy a license from sidekick-ae.com, and your key arrives by email. On first launch the panel asks for that key, you paste it in, and you are activated. Walkthrough in Licensing & activation.
How many computers can I use one license on?+
Two. One license covers two machines – a tower and a laptop, say. Settings shows how many seats you have used (like 1/2) and a Deactivate this machine button. Hit a third machine and Sidekick asks you to deactivate one of the other two first.
I'm switching computers. How do I move my license?+
Open Settings > Deactivate this machine on the old computer to free the seat, then activate on the new one. Reinstalling on the same machine does not use up a seat.
Does my license work offline?+
Yes, for 14 days after activation. The panel re-checks quietly in the background whenever you are online, which resets the window. Stay offline longer than that and it will ask you to reconnect and re-enter your key. You need to be online to generate code anyway.
Where's my license key vs. my API key?+
They are different. The license key (from your purchase email) activates the panel on the Activate Sidekick screen. The API key (from Anthropic, OpenAI, or Google) goes into Settings and is what talks to the AI. Don't mix them up.
Modes and workflow
What are the three modes for?+
Expression writes an expression onto the property you have selected. Script generates a self-contained .jsx — run once, save to your Toolbar, or save to AE's Scripts folder. Question just answers, no code applied. See Getting started for examples.
Small action or big script — does the mode change?+
No. Everything comes out of Script mode; your prompt decides the size. A small one-shot action ("rename all selected layers") is worth keeping – click Save to Toolbar and it becomes a one-click button (the Toolbar labels these scriptlets). A bigger job – batch rendering, auditing a whole project – you save with Save as Script (.jsx) and run from File > Scripts > Run Script File….
How do I select things for the panel to work on?+
Click a layer, a property, or several properties in the timeline. The panel reads your AE selection automatically and shows it as a selection summary right under the mode selector. The AI uses that selection as context when generating code.
My selection keeps drifting while I tweak my prompt.+
Click + Load selection in the chat header. That pins your current AE selection so you can keep iterating on the prompt without losing focus. Click the ✕ to unpin when you are done.
Can I apply an expression to many layers at once?+
Yes. Cmd or Ctrl-click multiple properties in the timeline and ask something like wiggle all selected properties subtly. The Apply button shows a checklist of everything targeted so you can toggle individual properties off before applying.
Why does undoing a multi-target apply take so many presses?+
Each property currently lands in its own undo group, so undo requires one press per property. A batched-undo fix is on the roadmap.
Script Editor
When should I leave chat mode and open the Script Editor?+
One-prompt-one-answer flows are great in the main tabs. Open the Script Editor when you need to refine the AI's output (multiple iterations, line-by-line tweaks), debug a script that's already broken, or hand-write code with autocomplete and an AI on call. See Script Editor for the full tour.
How do I open it?+
Click the </> button next to the three mode tabs (Question / Expression / Script) at the top of the panel. The Play icon next to it opens the smaller Quick Run pad.
How do I get code from chat into the Script Editor?+
Hit the Copy button on the chat response, switch to the Script Editor with the </> button, and paste. Both views stay mounted in the panel, so the chat is still right there as you work. The editor remembers its buffer across panel reloads.
What is the Ask / Edit / Explain menu?+
Drag-select any chunk of code in the editor and the menu pops above the selection. Ask sends a question about the selection to chat. Edit requests a rewrite as an inline diff with Accept and Revert. Explain drops a plain-English walkthrough into chat. The selected lines stay visible the whole time.
What's the blue dot in the gutter?+
A pending AI Edit on that line. Click the dot to re-open the preview, or use the Revert / Accept buttons on the inline diff. The dot disappears once you accept or revert.
Can I debug a script that wasn't generated by Sidekick?+
Yes. Paste the .jsx into the Script Editor, hit Run to surface the error, then highlight the failing line and use Ask to get the AI's read on what went wrong. Iterate with Edit until it's fixed.
Why does typing `comp.` work without `var comp = …;`?+
The editor synthesizes a handful of common AE scripting conventions — comp, layer, prop, item, layers, project, selectedLayers, key — so autocomplete works on the bare identifier. These are not real ExtendScript globals: if you paste the code into AE's native File > Scripts runner, you still need the canonical var comp = app.project.activeItem; declarations upstream.
What's Quick Run for?+
The Play icon next to the Script Editor button opens a small scratchpad. Paste any .jsx, hit Run, see output. No need to commit it to the Toolbar. If a snippet turns out to be a keeper, the pad has a Save-As that promotes it into a saved Toolbar script.
Expression controls and rigging
How do "+ Add Slider" buttons work?+
When the AI generates an expression that depends on a control (a slider, color picker, angle, checkbox, etc.), it offers an + Add Slider (or similar) button in the chat. Click those first, they create the controls on your layer. Then click Apply to push the expression that references them.
Apply failed with a syntax error. What now?+
Read the AI's instructions printed below the code box. The most common cause is a missing control: the expression expects a Slider you have not added yet, or it references a layer name that does not exist in your comp. Add the missing piece and try again.
Apply does nothing when I click it. What's wrong?+
Make sure you have a property selected (like Position or Scale), not just a layer name. Apply needs a target property to write the expression onto.
Toolbar and saved scripts
Where do saved scripts live?+
On disk, inside your AE Scripts folder. Both Sidekick and the Toolbar read that file, so anything you save in one panel shows up in the other within about two seconds.
How do I edit or delete a saved script?+
Hover the row in the Toolbar panel. Edit and delete buttons appear.
A script on my Toolbar failed. How do I see what went wrong?+
The row flashes red with a brief tooltip. The ⚡ Open Helper button at the bottom of the Toolbar also turns red. Click it to jump back to the chat, where the full error is shown in a banner.
Can I run any old .jsx snippet I have lying around?+
Yes. In the Toolbar's bottom row, click { } Quick run to paste and execute raw .jsx code without saving it.
Performance and behavior
The first prompt of the day feels slow. Is something wrong?+
No, this is normal. AI models cold-start, so the first call may take a few extra seconds. Follow-up prompts are snappy.
Can I switch models without changing my default?+
Yes. There is a model dropdown next to the Send button. Pick a different model for any single prompt without touching your Settings default.
How do I close the panel?+
Use AE's native panel × button at the top of the panel, or right-click the panel tab and choose Close Panel. The Toolbar's "Open Helper" button can open the chat but cannot close it.
Privacy and safety
Does Sidekick send my AE project to the AI?+
The panel sends a structured summary of your current selection and your prompt to the AI provider. It does not upload your .aep file, footage, or renders.
Can my API key be stolen by another extension?+
Keys live in CEP localStorage for the panel. They are lightly obfuscated, not encrypted. Don't share screenshots that show the Settings panel with key fields visible, and don't paste keys into untrusted websites or chat apps.
What happens if I rotate or revoke a key?+
Open Settings, paste the new key over the old one (or clear the field and paste). Revoked keys will start failing on the next call. Sidekick will surface the provider's error message.
Bugs and feedback
I found a bug or AE crashed. What should I report?+
Send us:
- Your prompt (copy and paste it)
- The mode you were in (Question / Expression / Script) or whether you were in the Script Editor / Quick Run
- What you had selected when you submitted
- What you expected vs. what happened
- Which AI provider and model you were using
- A screenshot if possible
If AE crashed entirely, also include the last thing you clicked before the crash. The more concrete the repro, the faster we can fix it. Email it all to hello@sidekick-ae.com.
How actively is Sidekick developed?+
Very. It ships regular updates, and feature requests and bug reports directly shape what lands next. If something breaks or you want a workflow smoothed out, tell us – that feedback is how the roadmap gets set.