aimcal 0.9.0

AIM - Analyze. Interact. Manage Your Time, with calendar support
Documentation

AIM is your intelligent assistant for managing time and tasks. It analyzes your schedule using AI-driven insights, interacts naturally to understand your needs and preferences, and enables you to manage your time with clarity, control, and confidence.

Built on the iCalendar standard (RFC 5545) and compatible with CalDAV servers like Radicale, AIM ensures interoperability and flexibility across systems. From smart reminders to personalized insights, AIM helps you work smarter, not harder.

Usage

▶️ Run with Cargo

To run the CLI using Cargo:

cargo install aimcal
aim --help

❄️ Run with Nix

nix run . -- --help

Goals

  • Enable command-line calendar management: Perform queries and manage events and todos directly from the CLI.
  • Leverage LLMs for intelligent assistance: Offer smart scheduling and reminder suggestions tailored to user preferences.
  • Integrate with external systems: Support CalDAV providers and expose Webhook/REST APIs for triggers and calendar access.

Roadmap

📅 Calendar Features

  • Listing event and todos
  • Creating and editing event and todo
  • Undo history editing
  • Full text search (grepping)
  • Recurring events
  • TUI: Markdown support

🤖 AI Capabilities

  • AI operation, parse and execute user commands on calendar
  • Intelligent suggestions
  • Personalized

🔌 Integrations

  • CalDAV support
  • Webhook/REST API

Acknowledgements

We'd like to thank the pimutils project, particularly:

  • khal - A CLI calendar application
  • todoman - A simple task manager

Their work has been a significant inspiration for AIM's design and functionality.

LICENSE

This work is licensed under a Apache-2.0.

Copyright (c) 2025-2025, Zexin Yuan