npm package: @menasehk/sera
Description: SERA/ስራ — AI-powered daily work command center: tasks, calendar, contacts, memory, and OS automation
Author: tagcodi
Latest version: 1.6.1

# SERA

```
╔══════════════════ SERA ══════════════════╗
║                                          ║
║  ███████╗███████╗██████╗  █████╗         ║
║  ██╔════╝██╔════╝██╔══██╗██╔══██╗        ║
║  ███████╗█████╗  ██████╔╝███████║        ║
║  ╚════██║██╔══╝  ██╔══██╗██╔══██║        ║
║  ███████║███████╗██║  ██║██║  ██║        ║
║  ╚══════╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝        ║
║                                          ║
║   › ስ ራ ‹  AI-Powered Work Command Center ║
╚══════════════════════════════════════════╝
```

> **ስራ** means *work* in Amharic. Manage tasks, calendar, contacts, notes, and automate your computer through natural conversation — right from your terminal.

---

## Install

```bash
npm install -g @menasehk/sera
```

Then run setup once to connect your AI provider:

```bash
sera setup
```

---

## What you can do

Just open SERA and talk to it naturally:

```bash
sera        # open and start chatting
```

```
"Show my tasks for today"
"Add a meeting tomorrow at 2pm with the design team"
"Remind me to take my meds at 8pm"
"I finished the login bug fix, mark it done"
"Add Sarah Connor to my contacts, phone 555-0123"
"What do I have on Friday?"
"Remember that I prefer short responses"
"Write an MOU between us and Acme Corp"
"ቃለ-ጉባኤ ጻፍ — ዛሬ ጠዋት የነበረው ስብሰባ"
```

---

## Quick commands

```bash
sera                            # Start chatting
sera setup                      # First-time setup
sera today                      # Today's tasks and appointments
sera tasks                      # View all active tasks
sera add "Buy groceries" -p low # Quick-add a task
sera done "Buy groceries"       # Mark a task done
sera cal                        # Upcoming appointments
sera remind 15 "Stand up call"  # Desktop notification in 15 min
sera note "Great idea I had"    # Save a quick note
sera notes                      # View all notes
sera memory                     # See what SERA remembers about you
sera daemon start               # Run in background (notifications when closed)
sera daemon install             # Auto-start at login
sera export                     # Back up all your data
```

---

## Supported AI providers

| Provider | Models |
|---|---|
| **OpenAI** | gpt-4o, gpt-4o-mini, gpt-4-turbo, … |
| **Anthropic** | claude-opus-4, claude-sonnet-4, … |
| **Ollama** | llama3.1, mistral, gemma3 (runs locally, free) |
| **Groq** | llama-3.3-70b, mixtral, … |

Run `sera setup` to choose your provider and paste in your API key. Ollama needs no API key.

---

## Amharic Document Generation

SERA writes professional Word (`.docx`) documents in Amharic or English. Files are saved to your Desktop and opened automatically.

**Supported document types:**

| Type | Amharic Name |
|---|---|
| MOU | የስምምነት ማስታወሻ |
| Meeting Minutes | ቃለ-ጉባኤ |
| Official Letter | ደብዳቤ |
| Report | ሪፖርት |
| Agreement | ስምምነት |
| Contract | ውል |
| Custom | any structure |

**Examples:**

```
"Write an MOU between Tagcodi and the Ministry of Education"
"ቃለ-ጉባኤ ጻፍ — ዛሬ ጠዋት ከቦርዱ ጋር የነበረው ስብሰባ"
"Draft an official letter to the Ministry of Finance"
"Create meeting minutes — attendees were Kassu, Sara, and John"
"Write a 1-year service contract between us and our client"
"ሪፖርት ጻፍ — Q1 የስራ አፈጻጸም"
```

All documents use proper Ethiopic fonts (Nyala on Windows, Kefa on macOS) with correct structure — signature lines, reference numbers, section headings, and standard Amharic phrasing.

---

## Amharic Terminology & Learning

SERA comes with a built-in Amharic glossary of 60+ standard document terms — legal words, titles, phrases, and document sections — and learns new ones as you teach it.

**Pre-loaded categories:**

- Document types — `ቃለ-ጉባኤ`, `ደብዳቤ`, `የስምምነት ማስታወሻ`, `ውል`, `ሪፖርት`
- Legal terms — `ወገን`, `አንቀጽ`, `ፊርማ`, `ግዴታ`, `መብት`, `ቅጣት`
- Titles & roles — `ሰብሳቢ`, `ፀሐፊ`, `ሃላፊ`, `ወኪል`, `ዳይሬክተር`
- Formal phrases — `ለክቡርነትዎ`, `በአክብሮት`, `ተዋዋይ ወገኖች`
- Document sections — `ጉዳዩ`, `ዓላማ`, `ምክረ-ሃሳብ`, `አጀንዳ`, `አባሪ`
- Ethiopic numerals — ፩ ፪ ፫ ፬ ፭ …

**Teaching SERA new words:**

```
"Learn the word ተጠቃሚ — it means beneficiary in legal documents"
"ሰብሳቢ is also written as ሊቀ-ወንበር — remember that variant"
"How do you spell the Amharic word for arbitration?"
"What does ቃለ-ጉባኤ mean?"
```

Every learned term is saved permanently and immediately used in future documents.

---

## AI Memory

SERA remembers things about you across sessions automatically — no prompting needed.

```
"My name is Kassu and I live in Helsinki"
"I prefer bullet points in answers"
"I'm working on a mobile app called Fana"
```

```bash
sera memory                       # See everything SERA remembers
sera memory --forget "timezone"   # Remove one memory
sera memory --forget-all          # Start fresh
```

---

## Calendar & Contacts

On macOS SERA talks directly to Calendar.app and Contacts.app. On other platforms it creates `.ics` / `.vcf` files that open in your default app.

```
"Add dentist appointment Friday 3pm with a 30 minute reminder"
"Add John Smith to my contacts, email john@acme.com"
"Look up Alice in my contacts"
"Put this on my Google Calendar: team lunch, Thursday noon"
```

SERA always asks your permission before touching your calendar or contacts.

---

## Background Daemon

Runs silently in the background and sends desktop notifications even when SERA is closed.

```bash
sera daemon start      # Start background monitoring
sera daemon install    # Auto-start every time you log in
sera daemon status     # Check if it's running
sera daemon stop       # Turn it off
sera daemon logs       # View recent activity
```

Monitors: overdue tasks, appointment reminders (15 min + at start), daily 9 AM briefing.

---

## Permissions

SERA asks before doing anything that touches your system. You choose how strict:

- `ask` — confirm every action
- `auto` — auto-allow safe actions, ask for risky ones  
- `allow` — allow everything

You can always allow or deny permanently per tool so you're never asked twice.

---

## Your data

Everything stays on your machine. No cloud sync, no tracking.

| File | What's in it |
|---|---|
| `~/.ai-daily-cli/config.json` | Your settings and API key |
| `~/.ai-daily-cli/data.json` | Tasks, appointments, notes |
| `~/.ai-daily-cli/memory.json` | Things SERA remembers about you |
| `~/.ai-daily-cli/collections.json` | Custom data collections |
| `~/.ai-daily-cli/amharic-glossary.json` | Amharic terms and learned words |

The only outbound traffic is your conversation sent to your chosen AI provider's API.

---

## In-chat slash commands

| Command | What it does |
|---|---|
| `/help` | Show all slash commands |
| `/memory` | View stored memories |
| `/tools` | List all available AI tools |
| `/history` | Recent messages |
| `/perms` | Saved permission rules |
| `/config` | Current configuration |
| `/db` | Quick view of custom collections |
| `/clear` | Clear conversation and screen |
| `/quit` | Exit |

---

## License

MIT © tagcodi