<div align="center"> <img src="public/auren_logo.webp" alt="Auren" height="72" />

Auren

The execution layer between thinking and doing.

Auren is an open-source AI command center for Gmail, Google Calendar, and GitHub. Type one natural-language command — Auren plans every step, shows you the full execution plan, and executes everything simultaneously with a single approval.

<br />

<a href="https://www.youtube.com/watch?v=C-uXkFPFwmc"><code>➜ onboarding guide: Watch Setup Walkthrough</code></a><br> <a href="https://youtu.be/uBdourG9P2w"><code>➜ demo video: Watch Demo Video</code></a><br> <a href="https://tryauren.in"><code>➜ try live: tryauren.in</code></a><br>

<br />

</div>

---

What is Auren?

Most productivity tools make you manage them. Auren executes on your behalf.

Type:

Reply to Rahul confirming Thursday 3 PM and send a calendar invite with a Meet link.

Auren:

1. Plans — parses your intent into a structured JSON execution plan
2. Shows you — displays every action before running anything
3. Executes — fires Gmail reply + Calendar event + Meet link simultaneously
4. Logs — stores the full audit trail to your history

One command. One approval. Four seconds.

---

Features

Feature	Description
Human-in-the-Loop Execution	Every plan is shown before any API call. Review, edit, or cancel — you are always in control.
Parallel Multi-Tool Execution	One command dispatches Gmail, Calendar, and GitHub simultaneously — not sequentially.
Real-Time Inbox Classification	Every incoming email is classified as Urgent / Normal / FYI by Claude Haiku via webhooks. No polling.
Google Meet Auto-Generation	Calendar events created through Auren automatically carry a real, joinable Google Meet link.
Meet-link chaining	When scheduling a meeting and emailing the link in one command, Auren injects the live Meet URL into the email body before sending.
Semantic Email Search	Search your inbox by meaning. Powered by regex + vector-ready architecture.
Agent History & Audit Trail	Every action is logged — command, tool, inputs, outputs, timestamp, result.
Keyboard-First Design	⌘K command palette, R to reply, E to archive, J/K to navigate. Built for power users.
Meeting Prep Cards	35 minutes before any meeting, Auren auto-generates a briefing from your email history with attendees.
Rate Limiting	1,000 commands/hour for free users. Unlimited for Pro.

---

Architecture

┌─────────────────────────────────────────────────────────┐
│                        Browser                          │
│   Natural language command (Terminal Drawer / ⌘K)       │
└────────────────────┬────────────────────────────────────┘
                     │  Next.js Server Action
                     ▼
┌─────────────────────────────────────────────────────────┐
│               Auren Planning Layer                      │
│   analyzeCommand()  →  Groq (Llama 3.3-70B)             │
│   Returns: { actions[], explanation, requiresConfirm }  │
└────────────────────┬────────────────────────────────────┘
                     │  Human-in-the-Loop gate
                     ▼
┌─────────────────────────────────────────────────────────┐
│           Action Confirmation UI (client)               │
│   User reviews plan → edits parameters → Confirms       │
└────────────────────┬────────────────────────────────────┘
                     │  executePlan() Server Action