🛡️ Aegis — Personal AI Assistant

Aegis is a personal AI assistant you run on your own devices. It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat), plus extension channels like BlueBubbles, Matrix, Zalo, and more. The Gateway is the control plane — the product is your personal assistant.

If you want a personal, single-user assistant that feels local, fast, and always-on, this is it.

Why "Aegis"?

In Greek mythology, the Aegis was the shield of Zeus — a symbol of divine protection. Aegis is designed to be your personal AI guardian, protecting your productivity and keeping you connected across all your communication channels.

Installation

Runtime: Node ≥22.

From npm Registry (Stable)

npm install -g aegis@latest
# or: pnpm add -g aegis@latest

From GitHub (Development)

npm install -g github:yourusername/aegis
# or: npm install -g git+https://github.com/yourusername/aegis.git

From Source

git clone https://github.com/yourusername/aegis.git
cd aegis
pnpm install
pnpm build
npm link

Quick Start

aegis onboard --install-daemon

The wizard walks through gateway, workspace, channels, and skills.

Supported Channels

• WhatsApp (personal account via web linking)
• Telegram (bot or user account)
• Discord (bot)
• Slack (bot)
• Google Chat (bot)
• Signal (linked device)
• iMessage (macOS native)
• Microsoft Teams (bot)
• Matrix (bot)
• WebChat (built-in)

Models

Works with any major AI provider:

• Anthropic (Claude Pro/Max recommended)
• OpenAI (GPT-4, etc.)
• Google (Gemini)
• Local models (Ollama, etc.)

Key Features

• 🔄 Multi-channel messaging — One assistant, all your channels
• 🧠 Persistent memory — Remembers context across sessions
• ⏰ Cron jobs — Schedule tasks and reminders
• 🔧 Skills system — Extend with custom capabilities
• 🖥️ Browser automation — Control web pages
• 📱 Node pairing — Connect phones, tablets, other devices
• 🎤 Voice support — Text-to-speech and speech-to-text

Configuration

Config stored in ~/.aegis/aegis.json (or ~/.aegis/aegis.json for legacy compatibility).

Environment variables:

• AEGIS_STATE_DIR — Override state directory
• AEGIS_CONFIG_PATH — Override config path
• AEGIS_NIX_MODE — Nix mode (read-only config)

CLI Commands

aegis status          # Check gateway status
aegis gateway start   # Start the gateway daemon
aegis gateway stop    # Stop the gateway daemon
aegis onboard         # Run setup wizard
aegis doctor          # Diagnose issues
aegis channels        # Manage channels
aegis cron            # Manage scheduled jobs
aegis skills          # Manage skills

License

MIT License - see LICENSE file.

Built with ❤️ for personal AI assistance