Go Back

J-SOON

Golang
Service
CLI tool
Unix Philosophy
Calendar and Events
Notifications
Astro
Svelte
Work With AI

2026 - 02 - 08

The big return

Screenshot of Web Demo for JSOON binary

JSOON. Upcoming events from iCal.

This tool is my small personal helper for self organization and a project to return to coding from the depths of the void()

Online Demo  Source Code  

Disclaimers

  • 1: While seeing the web demo use some public *.ics files to play around with online demo. You have to trust me that the exact code from gihub is running in prod and my little toy is not stealing you personal calendar data 😉 Jokes aside there is zero CRUD. Web demo is a front that calls the go binary on the backend in a docker container and instantly presents the json output on a page. Some sample public calendars to play around are provided.

  • 2: AI has been used. Heavily controlled to learn to tame the clankers, but in a manner of precise control. Not just opening IDE and happily tabbing away. No Cursor nor any other VSCode family offshoots. No one-shotting the app. Small steps, lots of instructions running via opencode hooked up to openrouter. Lots of chat usage for inspiration or as a tutor/helper with pointing to current docs for accuracy. Almost all of the go code that started as a refactor of a small tool I found and cloned from GH written by hand. Front end base build with AI, then had to be heavily rewritten and tidied up by me as well because of course Gemini produced a small static 3-pages website using nothing but React components (Yeah… still waiting for this AGI to arrive). Refactored to plain Astro and the dynamic toast notifications system changed to Svelte because it’s quicker, lighter and is easier workign with component state without bringing in entire package of virtual DOM or writing custom state machine in Vanilla JS. Tests all written by AI but designed and guided one by one by me.

Why?

This is build to stretch those atrophied coding muscles. JSOON is a GO cli tool (No TUI. Flags and Pipes for scripting only) that extracts ucoming events from iCal (*.ics) files.
Developed for myself to power simple system notification system for upcoming events and reminders, simply because gnome-calendar on Linux is like most of Gnome. All fluff and opinions and no substance or helpful workflow. Meaning it does not work with remote calendars too well if at all. In TUI Calcure does it but it does not live sync or provide reminders/notifications.

JSOON is minimal. Pipe in data, or configure calendars with config file. Tell it with flag or config file how far ahead to look for events in those calendars and it will return a json string with things that are lined up soon. By default to stdout, but can be set to write to a file. Feed output to json. Use on a web page, for a discord bot… Hell, use it even for your agentic flows, but I will not take responsibility for broken relationships if your clanker hallucinates a date with Sarah your wife has no idea about!

What principles?

  • Simple. Unix philosophy, script and pipe data. Just a tool for my needs that does one thing. Satya and his SlopOS not welcome. If you know your way around go you should be also able to build for mac and use it as it’s just dead simple with no os libs and integrations.
  • Meant to return to coding and go beyond plain webdev box I boxed myself up in.
  • Write at least most basic tests this time. Browser forgives everything. Things run on OS and meant for integration not necessarily.

Features

  • It’s dead simple has just a few features and hopefully does the job.

In action on my system: