Installation

Prerequisites

Before installing Chronist, 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/Chronist-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/Chronist.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 Chronist icon to the Applications folder.

3. Launch Chronist

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

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 Chronist is installed correctly:

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

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

Uninstalling (macOS)

To remove Chronist from your Mac:

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

Note: Your knowledge files and settings are stored in ~/Library/Application Support/Chronist/. 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/Chronist-Setup.exe" -OutFile "Chronist-Setup.exe"

Or download directly from the releases page.

Installation Steps

1. Run the installer

Double-click the downloaded Chronist-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 Chronist

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

Verify Installation

To verify Chronist is installed correctly:

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

Uninstalling (Windows)

To remove Chronist from Windows:

1. Open Settings > Apps > Installed apps
2. Find “Chronist” 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%\Chronist\. Remove this folder if you want to completely clean up.

---

Updating

Chronist 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 Chronist to apply the update

You can also manually check for updates:

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