Installation

Prerequisites

Before installing chro, ensure you have the following set up:

• Node.js 18+ - Required for AI coding tools
• Git & GitHub - Required for version control
• Claude Code or OpenAI Codex - AI coding assistant

---

System Requirements

macOS

Requirement	Minimum	Recommended
macOS	12.0 (Monterey)	14.0 (Sonoma)
Memory	4GB available	8GB+ available
Storage	500MB	1GB+
Processor	Intel Core i5 / M1	M2/M3

Windows

Requirement	Minimum	Recommended
Windows	10 (21H2)	11 (23H2)
Memory	4GB available	8GB+ available
Storage	500MB	1GB+
Processor	Intel Core i5 / AMD Ryzen 5	Intel Core i7 / AMD Ryzen 7

---

macOS Installation

Download

Apple Silicon

For Mac with Apple Silicon (M1, M2, M3, or later):

curl -LO https://github.com/n-asuy/chronist-ai/releases/latest/download/chro-arm64.dmg

Or download directly from the releases page.

Intel Mac

For Mac with Intel processor:

curl -LO https://github.com/n-asuy/chronist-ai/releases/latest/download/chro.dmg

Or download directly from the releases page.

Installation Steps

1. Open the DMG file

Double-click the downloaded .dmg file to mount it.

2. Install the application

Drag the chro icon to the Applications folder.

3. Launch chro

Open chro from your Applications folder or use Spotlight (Cmd + Space, type “chro”).

4. Allow security permissions

On first launch, macOS may show a security warning. Go to System Preferences > Security & Privacy and click “Open Anyway”.

Verify Installation

To verify chro is installed correctly:

1. Open chro from Applications
2. The welcome screen should appear
3. Check the menu bar for the chro icon

Tip: If you encounter any issues during installation, check our troubleshooting guide or open an issue on GitHub.

Uninstalling (macOS)

To remove chro from your Mac:

1. Quit chro if it’s running
2. Open Finder and go to Applications
3. Drag chro to the Trash
4. Empty the Trash to complete removal

Note: Your knowledge files and settings are stored in ~/Library/Application Support/chro/. Remove this folder if you want to completely clean up.

---

Windows Installation

Download

Download the Windows installer from the releases page:

# Using PowerShell
Invoke-WebRequest -Uri "https://github.com/n-asuy/chronist-ai/releases/latest/download/chro-Setup.exe" -OutFile "chro-Setup.exe"

Or download directly from the releases page.

Installation Steps

1. Run the installer

Double-click the downloaded chro-Setup.exe file.

2. Allow Windows SmartScreen

If Windows SmartScreen appears, click “More info” then “Run anyway”.

3. Follow the installation wizard

• Accept the license agreement
• Choose installation location (default recommended)
• Click “Install”

4. Launch chro

After installation, chro will be available in your Start Menu.

Verify Installation

To verify chro is installed correctly:

1. Open chro from the Start Menu
2. The welcome screen should appear
3. Check the system tray for the chro icon

Uninstalling (Windows)

To remove chro from Windows:

1. Open Settings > Apps > Installed apps
2. Find “chro” in the list
3. Click the three dots menu and select Uninstall
4. Follow the uninstaller prompts

Note: Your knowledge files and settings are stored in %APPDATA%\chro\. Remove this folder if you want to completely clean up.

---

Updating

chro includes auto-update functionality. When a new version is available:

1. A notification will appear in the app
2. Click “Update” to download and install
3. Restart chro to apply the update

You can also manually check for updates:

• macOS: chro > Check for Updates in the menu bar
• Windows: Help > Check for Updates in the application menu