Skip to content

Commit e87afff

Browse files
committed
docs: rewrite Zaati OS post in personal voice
1 parent 8571079 commit e87afff

1 file changed

Lines changed: 88 additions & 88 deletions

File tree

  • app/posts/zaati-os-tiny-control-room
Lines changed: 88 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -1,86 +1,84 @@
11
---
2-
title: 'Zaati OS: A Tiny Control Room for Your Life'
2+
title: 'Why I Built Zaati OS'
33
date: 2026-08-24
44
dateModified: 2026-08-24
5-
description: A friendly, no-jargon guide to turning the AI you already use into a private daily dashboard.
5+
description: Zaati OS turns the AI tools you already use into a private dashboard for your calendar, inbox, work, finances, news, and goals.
66
tags: [artificial intelligence, open source, personal tools]
77
author: Mohsin Hayat
88
---
99

10-
My calendar knows when I am busy. My inbox knows what I am ignoring. My task list knows what is on fire. My finance apps know whether I should order dessert.
10+
I use AI every day, but most of the useful information in my life is still spread across different places.
1111

12-
The problem is that none of them talk to each other.
12+
My calendar knows what I have planned. Gmail knows which emails need a reply. Jira knows what I am working on. My financial apps know where my money is going. Then there are news, reminders, goals, habits, and all the small things I want to keep track of.
1313

14-
So I built [Zaati OS](https://github.com/mohsinht/zaati-os), a small control room for everyday life. “Zaati” means personal. The idea is simple: the AI assistant you already use collects the useful bits, places them in files you control, and Zaati OS turns those files into one calm dashboard.
14+
The information is already there. The problem is that I have to open everything separately, understand what changed, and decide what deserves my attention.
1515

16-
No new company needs to own your life story. No mystery account sits in the middle. You choose what comes in, where it lives, and what appears on screen.
16+
I wanted one place that could answer a few simple questions every morning:
1717

18-
![Zaati OS dashboard showing a daily overview](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/dashboard-light.png)
19-
20-
_The dashboard above uses pretend data. Nobody's real inbox or bank balance was sacrificed for this screenshot._
18+
- What needs my attention today?
19+
- What changed since yesterday?
20+
- Am I moving towards my goals?
21+
- Is there something important I am forgetting?
22+
- Where are my time, money, and attention going?
2123

22-
## Explain it like I am five
24+
That idea became [Zaati OS](https://github.com/mohsinht/zaati-os).
2325

24-
Imagine that every part of your life gives you a sticky note:
26+
“Zaati” means personal in Urdu, which fits the project well. It is an operating system for your own life, built around the AI tools you already use.
2527

26-
- Your calendar says, “Dentist at 4.”
27-
- Your inbox says, “Reply to this person.”
28-
- Your work board says, “This task is blocked.”
29-
- Your money app says, “You spent more on food this week.”
30-
- Your news list says, “These three stories actually matter.”
28+
![Zaati OS dashboard showing a daily overview](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/dashboard-light.png)
3129

32-
Normally, those sticky notes are scattered across ten rooms.
30+
_The screenshots in this post use synthetic data._
3331

34-
Zaati OS asks your AI to collect only the notes you approve, tidy them, and pin them to one board. Tomorrow it does the same thing again. After a week, it can help you notice patterns, such as the task you keep postponing or the afternoons you keep overbooking.
32+
## What Zaati OS does
3533

36-
That is the whole trick. It is a neat board, not a robot overlord. The robot overlord release has been postponed indefinitely.
34+
Zaati OS is an open-source dashboard that gives your AI a useful place to put the information it collects.
3735

38-
## What does Zaati OS actually do?
36+
For example, a scheduled task in ChatGPT could check your calendar and prepare today's agenda. Another could find emails that actually need a reply. It could also collect your work priorities, investment updates, useful news, habits, or goals.
3937

40-
Zaati OS gives your information a home and a useful shape. It can show:
38+
Zaati OS takes those results and displays them together.
4139

42-
- today's meetings and realistic focus time
43-
- emails that need a reply, while ignoring newsletter confetti
44-
- work tasks, blockers, and the next useful action
45-
- money and investment summaries you choose to provide
46-
- a short news briefing instead of an endless feed
47-
- goals, habits, health notes, reminders, and weekly reviews
48-
- when each section was last updated
49-
- warnings when something is missing or old
40+
The default project includes examples for:
5041

51-
You do not need all of that on day one. Start with three things, such as your calendar, inbox, and work tasks. A tiny dashboard that helps is better than a giant dashboard that looks impressive and says nothing.
42+
- calendar and daily agenda
43+
- important emails
44+
- work priorities and blockers
45+
- finances and markets
46+
- personalized news
47+
- habits and goals
48+
- daily overviews
49+
- weekly reviews
5250

53-
![Zaati OS setup screen with three guided steps](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/onboarding-light.png)
51+
You do not have to use all of them. I think the best way to start is with three sources that are already useful to you. Calendar, inbox, and work tasks are a good example.
5452

55-
_The guided start asks only for the basics. The knobs and switches can wait until you actually want them._
53+
The goal is not to create a dashboard full of random graphs. Every section should help you notice something, make a decision, or take an action.
5654

57-
## Why does this make sense now?
55+
## How it works
5856

59-
Many of us already pay for ChatGPT, Claude, Gemini, or another AI assistant. Those assistants can read approved sources and summarize information well, but a chat is not always the best place to see your whole day.
57+
The basic flow is simple:
6058

61-
Zaati OS gives that work a lasting home:
59+
1. A scheduled AI task reads the sources you allow.
60+
2. It saves the useful information in a small dated file.
61+
3. Zaati OS checks that the file has the expected information.
62+
4. The dashboard displays it using lists, calendars, numbers, tables, or charts.
63+
5. Daily and weekly reviews can compare it with older files.
6264

63-
1. Your AI reads only the sources you allow.
64-
2. It writes a small, dated snapshot.
65-
3. Zaati OS checks that the snapshot is safe to display.
66-
4. The dashboard turns it into lists, numbers, calendars, and charts.
67-
5. Weekly reviews can look back at earlier snapshots.
65+
You can think of each dated file as one page in a diary. The dashboard reads the latest pages and gives you a useful view of what is happening.
6866

69-
Think of the AI as the helpful librarian, the files as the shelves, and the dashboard as the reading desk.
67+
The files are ordinary JSON, so you can inspect them, move them, keep their history, or generate them with something other than ChatGPT. Claude, Gemini, a local model, n8n, cron jobs, and custom scripts can all use the same format.
7068

71-
This also means you are not locked into one AI. If you change assistants later, your dashboard and old snapshots can stay with you.
69+
This also means the project is not tied to one AI provider. If you change your AI tool later, you do not have to rebuild the dashboard or throw away its history.
7270

73-
## Try it in about five minutes
71+
## Getting started
7472

75-
You need [Git](https://git-scm.com/), [Node.js 22 or newer](https://nodejs.org/), and a free GitHub account.
73+
You need [Git](https://git-scm.com/), [Node.js 22 or newer](https://nodejs.org/), and a GitHub account.
7674

77-
### 1. Make your own copy
75+
### 1. Fork the repository
7876

79-
Open the [Zaati OS repository](https://github.com/mohsinht/zaati-os) and press **Fork** near the top right. GitHub will create your own copy.
77+
Open [github.com/mohsinht/zaati-os](https://github.com/mohsinht/zaati-os) and click **Fork**. This creates your own copy of the project.
8078

81-
### 2. Open the little text window
79+
### 2. Run the project
8280

83-
On macOS or Linux, open Terminal. On Windows, open PowerShell. Then run:
81+
Open Terminal on macOS or Linux, or PowerShell on Windows, and run:
8482

8583
```bash
8684
git clone https://github.com/YOUR_GITHUB_USERNAME/zaati-os.git
@@ -90,79 +88,81 @@ npm run setup
9088
npm run tutorial
9189
```
9290

93-
Replace `YOUR_GITHUB_USERNAME` with your GitHub name.
91+
Replace `YOUR_GITHUB_USERNAME` with your GitHub username.
92+
93+
The setup asks for a few basic preferences. The tutorial then creates synthetic data and opens the dashboard locally. It also sends one invalid result on purpose, shows how Zaati OS catches it, retries, and saves the corrected result.
9494

95-
The setup asks a few friendly questions. The tutorial then creates pretend information, checks it, and opens your dashboard. It even makes one deliberate mistake and fixes it, like a tiny robot tripping over its shoelaces and recovering professionally.
95+
This lets you test the complete flow without connecting an account or adding a key.
9696

97-
If you prefer Make, the short version is:
97+
![Zaati OS setup screen](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/onboarding-light.png)
98+
99+
If you use Make, you can run:
98100

99101
```bash
100102
make setup
101103
make tutorial
102104
```
103105

104-
### 3. Look around
106+
### 3. Explore the dashboard
105107

106-
Try the light and dark themes. Make the window narrow to see the phone layout. Open different sections and notice that every piece of information tells you where it came from and how fresh it is.
108+
Once it opens, try the different sections, switch between light and dark mode, and make the window smaller to see the mobile layout.
107109

108-
![Zaati OS dashboard on a mobile screen](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/dashboard-mobile.png)
110+
Every section shows when its information was generated. If a source is old, missing, or failed, the dashboard says so instead of quietly showing misleading information.
109111

110-
_It works on smaller screens too, because life rarely waits for us to return to a laptop._
112+
![Zaati OS dashboard on mobile](https://raw.githubusercontent.com/mohsinht/zaati-os/e6266bc90c27e13774f1141907f7b99f6b810ca9/docs/assets/dashboard-mobile.png)
111113

112-
## Now make it yours
114+
## Connecting your own information
113115

114-
Once the pretend demo works, choose one real source. Calendar is a friendly start.
116+
After the tutorial works, connect one real source.
115117

116-
Zaati OS includes ready-made instructions for common jobs, including daily agenda, inbox attention, work focus, money, news, daily overview, and weekly review. Give the matching instruction to your AI assistant, allow only the source it needs, and tell it to save the result in your private data storage.
118+
Zaati OS includes prompts for the common workflows. You can copy a prompt into your AI tool, give it access only to the source it needs, and schedule it to run every day.
117119

118-
You can also use one scheduled AI task to update several sections together. This keeps the routine simple:
120+
One scheduled task can also update several sections together. For example, one morning task could collect:
119121

120-
- morning: collect today's useful information
121-
- during the day: open one dashboard
122-
- end of week: review what changed
122+
- today's agenda
123+
- emails needing attention
124+
- current work priorities
125+
- a short news briefing
126+
- the combined daily overview
123127

124-
The important word is **approved**. Do not connect everything merely because you can. If your weather forecast does not need access to your email, it should not get access to your email. Sensible robots appreciate sensible boundaries.
128+
The output can be saved in a private repository as one commit. Zaati OS validates everything before it writes any of the files. If one part is wrong, it rejects the complete update and asks the AI to try again.
125129

126-
## What about privacy?
130+
For me, this is much more useful than having separate AI chats that disappear into history. The dashboard becomes a consistent place to start the day, while the older files make weekly and monthly reviews possible.
127131

128-
This part matters.
132+
## Keeping it private
129133

130-
The public Zaati OS project contains code and pretend examples, not your real life. Your real snapshots should stay in private storage, such as a separate private repository. Your deployed dashboard should also require a login.
134+
I did not want to build another service where users send all their personal information to a central account.
131135

132-
Zaati OS has no central account, required tracking, or central database. It does not charge a platform fee. Your chosen AI, storage, connectors, or hosting company may still have their own costs and privacy rules.
136+
Zaati OS does not have a central database, hosted account, or required analytics. The upstream repository contains the application and synthetic examples. Your real data should remain in storage you control, preferably a separate private repository.
133137

134-
Optional file encryption is available too, but encryption is not a magic invisibility cloak. You should still protect the dashboard with a proper login and read the [privacy guide](https://github.com/mohsinht/zaati-os/blob/main/docs/privacy.md) before connecting real information.
138+
The deployed dashboard must also be private. An obscure URL is not protection. The recommended setup uses Cloudflare Access so the dashboard requires authentication before it serves any personal information.
135139

136-
## Add another room when you need it
140+
Optional encryption is available for the stored files. It protects them at rest, but it does not replace proper access control because the dashboard still needs to decrypt information before displaying it.
137141

138-
Want a page for your cricket matches, travel plans, garden, reading list, water use, or dog walking schedule? Add it later.
142+
Before connecting real sources, read the [privacy guide](https://github.com/mohsinht/zaati-os/blob/main/docs/privacy.md). Also remember that the AI provider and connected services you choose may process information under their own policies.
139143

140-
Zaati OS is designed like a house with reusable rooms. A new section describes:
144+
Zaati OS itself has no platform fee. Depending on your setup, your AI provider, connectors, storage, or hosting may still have their own charges.
141145

142-
- where its information comes from
143-
- what shape that information should have
144-
- how often it should refresh
145-
- how it should appear
146-
- what to show when information is missing
146+
## Making it personal
147147

148-
You can also change colors, fonts, spacing, and headings without rebuilding the whole house.
148+
The default dashboard is only a starting point.
149149

150-
## The point is not more data
150+
Someone could add pages for travel planning, fitness, reading, cricket, home energy use, job applications, or anything else they regularly want to review.
151151

152-
The point is fewer forgotten things and better decisions.
152+
A new section can define where its information comes from, how often it should update, how it should be displayed, and what should happen when the information is unavailable.
153153

154-
A good personal dashboard should answer:
154+
The design can also be changed without rewriting the application. Colors, fonts, spacing, headings, and other theme settings are configurable.
155155

156-
- What needs my attention today?
157-
- What changed?
158-
- Am I moving toward my goals?
159-
- What am I repeatedly forgetting?
160-
- Where are my time, money, energy, and attention going?
156+
My long-term idea is for people to share useful source packs, prompts, schemas, and dashboard sections using completely synthetic examples. You should be able to add a capability without giving its author access to your information.
157+
158+
## Final thoughts
159+
160+
AI assistants are becoming capable of reading and understanding more parts of our daily lives, but their output is often temporary and scattered across chats.
161161

162-
In my opinion, the best version of AI is not another noisy app demanding attention. It quietly prepares the room before you enter.
162+
Zaati OS gives that work a structure. The AI collects and reasons, the files keep the history, and the dashboard gives you one place to understand it.
163163

164-
That is what I want Zaati OS to become: a useful daily interface that belongs to you, works with the AI you already like, and grows one small piece at a time.
164+
In my opinion, the useful future of personal AI is not another application asking for attention. It should quietly prepare the information you need and let you stay in control of it.
165165

166-
Fork it, run the pretend demo, connect one source, and see whether tomorrow morning feels a little less scattered.
166+
Zaati OS is still early, but the complete loop already works. You can fork it, run the tutorial, connect one source, and gradually turn it into something that is genuinely yours.
167167

168168
**[Explore Zaati OS on GitHub](https://github.com/mohsinht/zaati-os)**

0 commit comments

Comments
 (0)