explaingit

seannnnnnnnnnnnnn/ai-xiaoli

Analysis updated 2026-05-18

★ 41JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A desktop mascot app for macOS and Windows that reminds you of tasks, tracks your daily activity, and uses an AI model to summarize your day.

Mindmap

mindmap
  root((AI Xiaoli))
    What it does
      Desktop mascot
      Reminders and snooze
      Activity log
      AI daily summary
    Tech stack
      Electron
      JavaScript
      OpenAI-compatible API
    Use cases
      Task reminders
      Voice notes to text
      Daily review
    Audience
      Vibe coders
      General users
      Productivity fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get an animated desktop reminder for one time, daily, weekly, or monthly tasks.

USE CASE 2

Record a quick voice note on macOS and have it transcribed and summarized automatically.

USE CASE 3

Generate an AI written recap of your day, week, or a custom date range.

USE CASE 4

Track which apps you used and when reminders fired for later review.

What is it built with?

ElectronJavaScriptNode.jsmacOS Speech

How does it compare?

seannnnnnnnnnnnnn/ai-xiaolimrdoob/netexhome-assistant/mobile-apps-fcm-push
Stars414140
LanguageJavaScriptJavaScriptJavaScript
Last pushed——2026-07-05
Maintenance——Active
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Prebuilt releases exist for macOS and Windows, but the macOS build is unsigned so you may need to allow it in privacy settings.

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

In plain English

AI Xiaoli is a desktop AI task assistant built as an Electron app for macOS and Windows. It combines an animated desktop mascot, reminders, activity logging, and AI generated daily summaries into one lightweight tool that stays open on your desktop. The mascot sits on your screen and animates when a reminder fires, showing a speech bubble you can confirm or snooze. Reminders can be one time, daily, weekly, or monthly, and snoozed reminders are tracked so they show up again later along with a record for your daily review. On macOS there is also a "what just happened" feature that records your voice on demand, transcribes it locally using Apple's built in speech recognition, and turns the confirmed text into a summary using an AI model. The app can also generate summaries for today, yesterday, the last seven days, or a custom date range, using a customizable template, and it can optionally keep a log of which apps you used, when reminders fired, and how you interacted with the mascot. For the AI features, the app connects to any service that speaks the OpenAI compatible chat completions format. This includes OpenAI itself, along with compatible services like DeepSeek, Qwen, Moonshot, SiliconFlow, OpenRouter, and locally run models through Ollama. You set the base URL, the chat endpoint path, the model name, and your API key in the settings screen. Services that only offer their own non compatible API, such as Anthropic's native Messages API or Google's native Gemini API, are not directly supported yet. You can install it by downloading a prebuilt release for macOS Apple Silicon or Windows, or run it from source with npm install and npm run dev. The macOS build is not notarized by Apple, so you may need to allow it manually in system privacy settings the first time you open it. All of your data, including settings, reminders, and summary history, is stored locally on your machine rather than inside the install folder, and your API key is encrypted on macOS when possible. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up this Electron app to run locally with npm install and npm run dev.
Prompt 2
Show me how to connect this app to my own OpenAI-compatible API key and model.
Prompt 3
Explain how the voice transcription and AI summary feature works on macOS.
Prompt 4
Help me customize the Markdown template used for the daily AI summary.
Prompt 5
Walk me through packaging this app for macOS with npm run package:mac.

Frequently asked questions

What is ai-xiaoli?

A desktop mascot app for macOS and Windows that reminds you of tasks, tracks your daily activity, and uses an AI model to summarize your day.

What language is ai-xiaoli written in?

Mainly JavaScript. The stack also includes Electron, JavaScript, Node.js.

What license does ai-xiaoli use?

MIT license: free to use, modify, and distribute, including for commercial purposes, as long as the copyright notice is kept.

How hard is ai-xiaoli to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ai-xiaoli for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos