Cook Sync AgentDesktop

A lightweight background service that keeps your local recipe files in sync with Cook.md. Works on macOS, Windows, and Linux.

What is the Cook Sync Agent?

The Cook Sync Agent is a small application that runs in the background on your computer. It automatically syncs your local Cooklang recipe files with your Cook.md account, so your recipes are always up to date across all your devices.

• Syncs recipes automatically every 12 seconds
• Runs quietly in your system tray
• Works on macOS, Windows, and Linux
• Lightweight and efficient - no browser needed
• Secure OAuth authentication
• Auto-updates to the latest version

Key Features

Automatic Syncing

Once configured, the sync agent runs silently in the background, automatically syncing your recipes every 12 seconds. Any changes you make to local files are uploaded to Cook.md, and any changes from other devices are downloaded automatically.

System Tray Integration

The sync agent lives in your system tray (menu bar on macOS), showing you the current sync status at a glance. Click the icon to see details or access quick actions.

Cross-Platform

The sync agent is built with Rust for excellent performance and runs natively on all major desktop platforms:

• macOS - Intel and Apple Silicon
• Windows - Windows 10 and later
• Linux - Most distributions with system tray support

Auto-Start

Configure the sync agent to start automatically when you log in. Your recipes will be syncing from the moment your computer starts, with no manual action required.

Automatic Updates

The sync agent checks for updates automatically and can install them in the background. You'll always have the latest features and security fixes.

Secure Authentication

Login is handled through your browser using OAuth, so your Cook.md password is never stored locally. Authentication tokens are refreshed daily for security.

How It Works

The sync agent follows a simple workflow:

1. Configure - Point the agent to your recipes folder
2. Login - Authenticate with your Cook.md account
3. Sync - Changes are synced bidirectionally

The agent watches your recipes folder for changes. When you create, edit, or delete a recipe file, the change is detected and uploaded to Cook.md within seconds. Similarly, if you make changes on another device or through the Cook.md web interface, those changes are downloaded to your local folder.

Requirements

macOS

• macOS 10.15 (Catalina) or later
• Intel or Apple Silicon processor

Windows

• Windows 10 or later

Linux

• Most distributions with GTK 3 support
• System tray support (may require extensions on GNOME)