Calendar and File Automation
Keep Crona’s boundary simple: it writes useful local files, and the tools you already use can read them. This makes calendar and notes automation predictable without handing your work to a cloud connector.
iCalendar (.ics) Automation
Section titled “iCalendar (.ics) Automation”Crona generates deterministic .ics files representing planned work and recorded sessions:
- Separation: Exposes separate feeds for issues (
issues.ics) and sessions (sessions.ics). - Scoping: Calendar exports target a specific repository.
- Configurable Paths: Specify a dedicated calendar directory in the Config view.
Import the calendar files
Section titled “Import the calendar files”Because the .ics files are updated deterministically, local calendar clients or automation helpers can ingest them:
- macOS/Linux: Sync with native calendars via loopback servers (e.g., using a local HTTP server exposing the ICS directory to Apple Calendar or Thunderbird).
- Directory Watchers: Run background services (e.g.,
entrorfswatch) that trigger synchronization or push tasks whenissues.icsupdates.
Watch report files
Section titled “Watch report files”Narrative reports are written to the configured reports folder. You can configure local documentation wikis or personal knowledge bases (like Obsidian or Logseq) to index these folders directly.
Syncing to Obsidian
Section titled “Syncing to Obsidian”Configure Crona to write Markdown reports directly into your Obsidian Vault:
- Open the TUI Config view.
- Edit the
Reports Directorypath to target your vault directory (e.g.,/Users/username/Vault/Crona-Reports). - Generated reports will instantly appear as notes, utilizing the Obsidian-friendly YAML frontmatter emitted by Crona.
Keep outputs separate
Section titled “Keep outputs separate”Keep report files and calendar files in separate directories:
- Reports Folder: Point this to human-facing document stores or note vaults.
- ICS Folder: Point this to system directories monitored by sync daemons or local calendar services.
Next: Exports and Reports for the report types and formats Crona can generate.