2026 · Solo developer

Brief — A Calendar-Aware Briefing Agent

A Telegram agent that runs my mornings, manages my todo-lists and tells me when to plan stuff. Every conversation quietly receives and disposes content, helping me reduce API costs.

Brief — A Calendar-Aware Briefing Agent cover

Overview

Brief is a personal agent living a simple, honest life nestled in my self hosted stack. It wakes up a few times a day unprompted: an early morning briefing, a Sunday summary and a Todoist inbox fetcher letting me know when new to-dos have been scheduled.

The rest of the time, it allows me to quickly add complex, multi-event items to my calendar (e.g. upload a course schedule), use natural language fuzzy search and get second opinions on planning choices I should have known long ago.

Architecture

  • BriefingManager spawns conversations. Each scheduled briefing opens its own context, runs to completion, and silently restores the main chat.
  • Auto-completion detection. Heuristics in the agent’s response (question marks, “do you want…” patterns) decide whether the briefing interaction is still ongoing. It’s simple, but it removes the need for additional friction (e.g. manual confirm).
  • Agentic tool-use. A Gemini-backed agent with ~10 tools covering Google Calendar (private + family + reminders), Todoist, weather, and iCalendar parsing. The system prompts are specific to the briefings, and each get their own character and context.

Highlights

  • Cost-optimized inference. Gemini 3.5 Flash by default. Most briefings sit at 500–2000 tokens.
  • Multi-turn. Natural language confirmation works as natural conversation rather than buttons or terminal-style commands.