Installation

System requirements

Before downloading, make sure your Mac meets these requirements:

Requirement	Minimum	Recommended
Operating system	macOS 12 (Monterey)	macOS 14 (Sonoma) or later
Processor	Apple Silicon (M1+) or Intel x86_64	Apple Silicon (M1 Pro or later)
Memory	4 GB RAM	8 GB RAM or more
Disk space	500 MB free	1 GB free (for projects and caches)
Internet	Required for AI features	Broadband recommended

Codewick is a native macOS application built on Tauri. It runs locally on your machine, but AI model requests are sent over the internet through OpenRouter. Without an internet connection, you can still edit files and use the terminal, but AI features will be unavailable.

A note on Apple Silicon vs. Intel

Codewick provides separate builds optimized for each architecture. The Apple Silicon build runs natively on M1, M2, M3, and M4 chips. The Intel build runs on older Macs and also works on Apple Silicon through Rosetta 2, but the native Apple Silicon build is strongly recommended for better performance and lower memory usage.

Download Codewick

1. Open your browser and go to codewick.ai/download.
2. The site will detect your Mac’s architecture automatically and highlight the recommended build.
3. Click Download for Apple Silicon or Download for Intel, depending on your machine.

The download is a .dmg disk image, typically around 150 MB.

Not sure which chip you have?

Click the Apple menu () in the top-left corner of your screen and select About This Mac.

• If you see Apple M1, M2, M3, or M4 under “Chip,” download the Apple Silicon build.
• If you see Intel under “Processor,” download the Intel build.

Install the app

Once the download finishes:

1. Open the .dmg file. Double-click the downloaded file (e.g., Codewick-1.0.0-arm64.dmg). A Finder window will appear showing the Codewick icon and your Applications folder.

2. Drag Codewick to Applications. Drag the Codewick icon onto the Applications folder alias. This copies the app to your Mac.

3. Eject the disk image. Right-click the Codewick disk image on your desktop or in the Finder sidebar and select Eject. You can also delete the .dmg file from your Downloads folder — you won’t need it again.

4. Launch Codewick. Open your Applications folder and double-click Codewick, or use Spotlight (Cmd + Space, type “Codewick”, press Enter).

About code signing and Gatekeeper

Codewick is signed and notarized by Apple. This means macOS will not show the “unidentified developer” warning or block the app from launching. If you see a prompt asking whether to open an app downloaded from the internet, click Open — this is a standard macOS confirmation for any newly downloaded application, not a security warning.

If your organization uses a managed macOS environment with additional security policies, your IT administrator may need to allowlist Codewick’s bundle identifier: ai.codewick.app.

First launch

The first time you open Codewick, you’ll go through a short setup process.

1. Create your account

You can sign up with:

• Email and password
• Google account
• GitHub account

If you already have a Codewick account, click Sign in instead.

2. Select a plan

After signing in, you’ll be prompted to choose a subscription plan. Billing is handled securely through Stripe.

Plan	Price	Usage level
Lite	$10/month	Light usage — great for exploring
Daily	$25/month	Moderate usage — side projects and learning
Pro	$100/month	Heavy usage — professional development
Max	$200/month	Maximum usage — full-time and team workflows

You can change your plan at any time from the account settings. Upgrades take effect immediately; downgrades take effect at the next billing cycle.

3. Onboarding overlay

After selecting a plan, Codewick opens the main workspace with a brief onboarding overlay. This walks you through:

• The chat panel — Where you describe what you want to build.
• The editor — Where generated code appears for review and editing.
• The browser — Where your app previews in real time.
• The pipeline selector — Where you can customize which AI models handle each stage.

You can dismiss the overlay at any time and revisit it later from Help > Show Onboarding.

Updating Codewick

Codewick checks for updates automatically on launch. When an update is available:

1. A notification appears in the top bar with the new version number.
2. Click Update now to download and install the update.
3. Codewick will restart with the new version. Your open projects and unsaved work are preserved through the restart.

You can also check for updates manually from Codewick > Check for Updates in the menu bar.

Release channels

Codewick ships on a single stable release channel. Updates are tested before release and rolled out to all users simultaneously. There is no beta channel at this time.

Uninstalling Codewick

If you need to remove Codewick:

1. Quit the app if it’s running (Cmd + Q).
2. Open your Applications folder.
3. Drag Codewick to the Trash.
4. To remove configuration data, also delete:

rm -rf ~/Library/Application\ Support/ai.codewick.app
rm -rf ~/Library/Caches/ai.codewick.app

Your project files are stored wherever you saved them and are not affected by uninstalling the app.

Troubleshooting

Codewick won’t launch

• Make sure you’re running macOS 12 or later.
• Try right-clicking the app and selecting Open instead of double-clicking.
• Check System Settings > Privacy & Security for any blocked app notifications.

”Codewick is damaged and can’t be opened”

This usually means the download was corrupted. Delete the app from Applications, re-download the .dmg from codewick.ai/download, and install again.

Slow performance

• Close other memory-intensive applications.
• Make sure you’re using the correct build for your chip (Apple Silicon vs. Intel).
• If you’re on an Intel Mac with 4 GB of RAM, consider closing the browser panel when you don’t need it.

AI features are unresponsive

• Check your internet connection.
• Verify your subscription is active in Settings > Account.
• Check the Codewick status page for any ongoing service issues.

Platform support

Codewick currently supports macOS only. Windows support is planned for v1.1 and is actively in development. Linux support is under consideration for a future release.

Sign up for the Codewick newsletter to be notified when new platform builds are available.

What’s next?

Now that Codewick is installed, head to Your First Project to build something with AI in under five minutes.