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

npm install -g @menasehk/sera

Then run setup once to connect your AI provider:

sera setup

What you can do

Just open SERA and talk to it naturally:

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"
"Where did I write down the Acme numbers?"
"I want to meditate every morning"
"How productive was I this week?"
"ቃለ-ጉባኤ ጻፍ — ዛሬ ጠዋት የነበረው ስብሰባ"

Quick commands

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 find "acme"                # Search everything at once
sera stats                      # Productivity analytics
sera habit add "Read daily"     # Track a habit and its streak
sera habit done "Read daily"    # Check it off
sera focus 25 "Deep work"       # Pomodoro timer, logged automatically
sera memory                     # See what SERA remembers about you
sera brief                      # Show today's morning briefing any time
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.

Read any file

Give SERA a file path and ask anything about it — it reads PDFs, Word docs, code, CSV, logs, configs, and any plain text.

"Read ~/Desktop/contract.pdf and summarize the key terms"
"What does ~/projects/app/config.yaml do?"
"Translate this document to Amharic: ~/Documents/report.docx"
"Check my ~/Downloads/expenses.csv — what's the biggest expense?"
"Read the README in ~/projects/fana and explain the setup steps"

Supported formats: .pdf, .docx, .txt, .md, .csv, .json, .js, .ts, .py, .html, .yaml, .log and any other text-based file. No extra setup needed — works out of the box.

Search everything

One query across every place SERA keeps something — tasks, calendar, notes, custom collections, remembered facts, and habits. No AI call, no API key, instant.

sera find "acme"                     # Everything mentioning Acme
sera find budget --kind note         # Only notes
sera find ጉባኤ                        # Works in Amharic
sera find proposal --limit 5         # Cap the results

Kinds: task, appointment, note, record, memory, habit (plurals and event work too). Results are ranked by relevance and tell you exactly where each match lives.

In chat, just ask:

"Where did I write down the Acme numbers?"
"Find anything about the Q2 budget"
"Did I note the discount we agreed?"

Productivity analytics

sera stats              # Last 30 days
sera stats --days 7     # This week

  📈  Productivity  ·  last 14 days

    12 completed      5 active      1 overdue      70% done

  Completions  ▁▃▂▅█▂▁▃▅▂▁▄▆█  peak 4/day
  Streak       6 days in a row   ·  best 11
  Best day     Wednesday

You get: completion rate and counts, a per-day completion sparkline, current and longest streak, your busiest weekday, open work by priority, meeting hours booked, notes captured, focus minutes, habit check-ins, and your most-used tags.

Ask SERA "how productive was I this month?" and it reads the same numbers and tells you what changed.

Habits & streaks

Habits are for routines you want to be consistent at — separate from tasks, which are things you finish once.

sera habit                              # All habits, streaks, what's still due today
sera habit add "Read 20 pages"          # Daily habit
sera habit add "Gym" -w mon,wed,fri     # Only on certain days
sera habit done "Read"                  # Check it off (partial names work)
sera habit undo "Read"                  # Undo today's check-in
sera habit rm "Gym"                     # Archive (keeps history)
sera habit rm "Gym" --permanent         # Erase it for good

  ✔  Read 20 pages     🔥 12   best 12  ·  93%  ·  daily
     ● ● ● ○ ● ● ● ● ● ● ● ● ● ●  14d

Missing a day you weren't scheduled for never breaks a streak, and today stays open until midnight — so an unfinished habit doesn't reset your run early.

In chat: "I meditated this morning" checks it off and tells you the streak.

Focus timer

A pomodoro timer that logs where your time actually went.

sera focus 25 "Write the report"   # Countdown, then a desktop notification
sera focus log                     # Last 7 days
sera focus log --days 30           # Longer window

Stop early with Ctrl-C and the partial time is still recorded. Focus minutes roll up into sera stats, so you can see deep work next to what you actually completed.

In chat: "log an hour of deep work on the API".

Web research

SERA can search the internet and return real, current information — no browser needed.

"Research the latest interest rates in Ethiopia"
"What is the current price of teff in Addis Ababa?"
"Find information about the new Ethiopian fintech regulations"
"Who won the Ethiopian Premier League last season?"
"ስለ ኢትዮጵያ ዲጂታል ፋይናንስ ምን ተጻፈ?"

No API key required. SERA uses DuckDuckGo to find results, reads the top pages, and gives you a synthesized answer with sources cited.

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"

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 [email protected]"
"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.

Morning Briefing

Every day at 9 AM SERA sends a desktop notification with your day at a glance. On macOS it also reads it aloud.

sera brief    # Show today's briefing any time of day

The briefing includes live weather, tasks due today, overdue items, calendar appointments, and a rotating Amharic motivational quote. Runs automatically when the daemon is active.

Background Daemon

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

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 with weather.

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 | | ~/.ai-daily-cli/habits.json | Habits and check-in history | | ~/.ai-daily-cli/focus.json | Focus sessions |

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 | | /find <query> | Search everything without leaving the chat | | /stats | Productivity analytics for the last 30 days | | /habits | Habit streaks and what's still due today | | /focus | Focus time for the last 7 days | | /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 |

Contributing

git clone https://github.com/Tagcodi/Sera_CLI.git
cd Sera_CLI
npm install
npm run dev          # run from source
npm test             # jest
npx tsc --noEmit     # typecheck

The repo ships with specialist Claude Code subagents in .claude/agents/ — each one carries the conventions for a part of the codebase so contributions land in the right shape:

| Agent | Owns | |---|---| | sera-tool-builder | AI-callable tools in src/tools/ — schemas, risk levels, registry wiring | | sera-cli-designer | sera commands, slash commands, and the terminal design system | | sera-provider-expert | OpenAI / Anthropic / Ollama / Groq integrations, retries, API errors | | sera-data-architect | Storage backends, the data directory, migrations, the daemon | | amharic-specialist | Amharic copy, the glossary, Ethiopic fonts in .docx output | | sera-test-engineer | Jest suites, fixtures, isolation from your real data dir | | sera-release-manager | Versioning, the build/obfuscate pipeline, npm publishing |

Issues and PRs welcome at github.com/Tagcodi/Sera_CLI.

License

MIT © tagcodi