Skip to content

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

GoodMorning secretary

GoodMorning

A self-hosted AI secretary: a morning briefing, an evening review, one schedule,
and a chat that keeps your to-dos and ideas.

English · 简体中文

Scrolling through a morning briefing: weather with hourly charts, news, tasks and reminders

What it does

Your plans are spread across a calendar, a notes app and old chats, and every morning you put them back together by hand. GoodMorning keeps them in one record, and an AI agent turns that record into two briefings a day:

  • Morning: weather with hourly charts, news from the last 24 hours, today's appointments, today's tasks, and anything that needs a decision.
  • Evening: what you finished, what's still open, and tomorrow. Optional sections show stocks, new episodes of your shows, and game sales.
  • Schedule: your calendar and dated to-dos in a week or day view.
  • Letters: on Sunday evenings, a short letter about your week: what you finished, habits you kept going, ideas you saved and next week's plans, kept to look back on.
  • Secretary: a chat that saves to-dos, ideas, habits and errands, and asks when something is unclear.

It shows what you saved. It never marks work done, moves a date or invents a task on its own: unfinished work stays where it was until you say otherwise.

Tell your secretary

Typing a request in the secretary chat; the reply saves a recurring task and an idea

Write the way you would to a person. One message can hold several things; each is saved as the right kind of item:

  • To-dos with a day, a deadline, or both.
  • Habits such as "every Tuesday and Saturday", with exceptions.
  • Ideas that stay ideas until you adopt them.
  • Heads-ups and reference notes that never ask to be ticked off.
  • Errands such as "check this price each morning", reported in your briefing only when the result is what you asked to hear.

A floating Ask button opens the same chat from any page. You can attach files and images.

Morning

Weather cards with hourly temperature, rain and air-quality charts

News cards grouped by category, each with a summary and source links Tasks grouped by day and project, with a deadline and an optional item
News from the last 24 hours, with sources, skipping stories you've already seen. Tasks by day and project, deadlines marked, optional work kept apart.

Sections appear as they are written, so you can start reading before the whole briefing is done. Changes from your synced calendar (a published .ics link) are applied automatically, and Reminders mentions each one once.

Evening

Evening briefing in the Starry scheme, showing partial progress on a task Stocks section with A-share and US holdings, daily gain or loss and totals

After the evening briefing is written, a short check-in goes through today's due tasks one at a time, then asks about anything you finished early. Only your answers change a task, never a guess.

Schedule

Week view with appointments above dated to-dos, including a dentist visit with the time still to be confirmed

The Schedule page reads your saved records directly: no AI call, no generated plan. Appointments with an unknown time are marked as such.

Looks

The same page in First Light, Morning Sky, Grass Block, Starry, City Lights and Picnic

Choose a Soft or Pixel style, a day color scheme and a night color scheme, separately on each device. Pick a secretary avatar and name, and how it should talk to you. About me in the Account menu shows what your secretary knows about you: change simple details there, the rest in chat. The whole site is available in English and Simplified Chinese.

On your phone

Morning briefing on a phone-sized screen Secretary chat on a phone-sized screen

The website works on phones. The Android app (beta, releases) adds:

  • Widgets: today, the week, briefings, news, weather, the secretary chat, and a quick-note sticky that your secretary can sort later.
  • Notifications when a briefing is ready, a reply is finished, your secretary needs an answer, or an event is about to start, plus a morning and evening reminder at your chosen times if that briefing isn't prepared yet. Browsers can get these too.

Getting started

GoodMorning is in beta. It is not a standalone chatbot: it needs

  • Linux with Python 3.14+,
  • an OpenCode agent with model access (English and Chinese requests use DeepSeek V4.1 Flash).
  1. Install the goodmorning skill with the deployment guide. For the browser viewer, see the browser guide; hosting it publicly needs the security setup.
  2. Open Initialize in the browser. Your secretary asks for your preferences, location and integrations; anything optional can wait.
  3. Prepare a briefing from Morning or Evening, or start a chat.

Weather, modelled air quality and news need outbound HTTPS but no API keys.

Privacy

  • Personal records live in your own runtime, outside this source tree.
  • The hosted setup supports HTTPS sign-in, encrypted storage and separate accounts.
  • Self-hosting does not hide requests from your AI provider, and encryption does not hide live data from the server's administrators. See the security boundaries.

More

Item types and timing · Schedule · Weekly letters · Evening tidy-up · Celebrations · Browser chat · Source layout · Issues

Screenshots use fictional data, made by the demo helper without any model calls.

License

MIT. Bundled fonts (text, pixel) keep their own licenses; theme imagery has asset credits.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages