Homelab: Obsidian to Hugo Automated Publishing Guide#

This guide outlines the infrastructure and configuration required to sync an Obsidian vault across multiple devices and automate the publishing process to a Hugo website via Cloudflare Pages.

1. Multi-Device Sync (The Git & Web Layer)#

To sync your notes between computers and view them on mobile devices without the overhead of real-time database sync engines:

1.1. Between Computers (Mac Studio & MacBook Pro/Air)#

We use the Obsidian Git plugin to synchronize vaults directly via GitHub.

Using Codex CLI on macOS (Apple Silicon)#

Codex CLI is the terminal interface for OpenAI Codex.

Codex supports two authentication methods:

1. ChatGPT account

   • Uses ChatGPT plan limits (Free, Plus, Pro)
   • No API key required

2. OpenAI API key

   • Uses OpenAI Platform API billing
   • Requires an API key
   • Usage is charged against API credits

You can switch between both methods.

1. Installation#

Install Codex CLI via Homebrew Cask:

brew install --cask codex

Verify: