Installation & Setup

Installation & Setup

Download

From GitHub Releases

Go to the Releases page and download the installer for your platform:

Platform	File	Type
Windows	SnCode-x.x.x-win-x64.exe	NSIS installer
macOS (Intel)	SnCode-x.x.x-mac-x64.dmg	Disk image
macOS (Apple Silicon)	SnCode-x.x.x-mac-arm64.dmg	Disk image
Linux	SnCode-x.x.x-linux-x86_64.AppImage	AppImage

Windows Installation

1. Download the .exe installer
2. Run the installer — you can choose your installation directory
3. The installer creates a Start Menu shortcut called SnCode
4. Launch SnCode from the Start Menu

macOS Installation

1. Download the .dmg for your architecture (Intel x64 or Apple Silicon arm64)
2. Open the .dmg file
3. Drag SnCode to your Applications folder
4. On first launch, you may need to right-click and select "Open" to bypass Gatekeeper

Linux Installation

1. Download the .AppImage file
2. Make it executable: chmod +x SnCode-*.AppImage
3. Run it: ./SnCode-*.AppImage

First Launch — Onboarding

When you launch SnCode for the first time, you'll be guided through a multi-step onboarding flow:

Step 1: Welcome

A brief overview of SnCode's capabilities: AI agent, multi-model support, and secure credential storage.

Step 2: Choose Provider

Select your AI provider:

• Anthropic — Claude models (Opus, Sonnet, Haiku)
• OpenAI — Codex models (5.3, 5.2, 5.1 Mini)

Step 3: Choose Authentication Method

• Sign in with subscription — Use your existing Claude Pro/Max or ChatGPT Plus/Pro subscription via OAuth
• API key — Paste your API key directly

Step 4: Authenticate

If you chose subscription (OAuth):

• Anthropic: A browser window opens for authorization. After approving, copy the authorization code and paste it back into SnCode.
• OpenAI: A browser window opens showing a device authorization page. Enter the displayed code in your browser. SnCode polls automatically until authorization completes.

If you chose API key:

• Paste your API key into the input field
• Links are provided to the key management consoles (Anthropic Console, OpenAI Platform)

Step 5: Complete

You're ready to go! You can configure additional providers later in Settings.

Adding a Project

After onboarding:

1. Click the + button in the sidebar
2. Select a folder using the native file picker
3. The project appears in the sidebar with its folder name
4. Click the project to select it, then create a new thread to start chatting

System Requirements

Component	Requirement
OS	Windows 10+, macOS 12+, Linux (glibc 2.31+)
Architecture	x64 (all platforms), arm64 (macOS only)
RAM	4 GB minimum, 8 GB recommended
Disk	~300 MB for installation
Network	Required for API calls to Anthropic/OpenAI
Keychain	Windows Credential Manager, macOS Keychain, or libsecret (Linux)

Linux note: The keytar package requires libsecret for credential storage. Install it with:

# Debian/Ubuntu
sudo apt install libsecret-1-dev
# Fedora
sudo dnf install libsecret-devel