Start here
Install and set up
Install Zokie on macOS or Windows, sign in, connect an agent and pick your handle.
Windows uses Ctrl in place of ⌘.
What you need
| macOS | Windows | |
|---|---|---|
| System | macOS 13 or later, Apple silicon or Intel | Windows 10 (1809) or Windows 11 |
| Terminal install | Node.js 18.17 or later | Node.js 18.17 or later |
| For Claude Code | Nothing extra | Git for Windows |
Install
From Terminal, PowerShell or Command Prompt:
npx @zokie/zokie
It installs the newest Zokie and opens it. Already installed? The same command opens it. You can also install from the Mac App Store or the Microsoft Store through the download button on zokie.dev.
A terminal install updates itself: when a new version is ready, an update button appears in the app. A store copy is updated by its store.
Sign in
Pick Continue with GitHub, Continue with Google or Continue with email.
- GitHub or Google: sign in in the browser tab that opens, then come back. Lost the tab? Click Reopen the tab, or Use another way.
- Email: click Email me a code, enter the 6-digit code and click Sign in.
Have an invite code? Apply it in Settings › Billing.
The welcome
A new account sees five slides: Connect a model, Meet Your Day, Pick your handle, Theme & settings and Start your first task. Got it on the last slide docks them in the sidebar as a Get set up checklist, each step with its own button and Skip. Only connecting an agent matters before your first task.
Connect an agent
- Open Settings (
⌘,) › Models. - In the agent's column, click Connect, or Install if the CLI isn't on your computer.
- Follow the terminal that opens beside the page, then close it. Zokie lists the agent's models.
For free models, click Get a code in the OpenRouter column, approve Zokie in your browser, paste the code and click Connect. See Supported agents.
Your handle and theme
Zokie suggests an @handle. In the checklist, click Keep it, or Change to pick another in Settings › About you. Handles are unique. Theme & settings opens Settings › Look & sound.