Skip to content

ojasshelke/agent-shadow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Agent Shadow πŸ€–

The AI-Powered Freelancer Operations Platform

Automate your operations. Focus on your craft.

Agent Shadow is a comprehensive platform that monitors your emails, calendar, and meetings to automatically extract tasks, deadlines, and insights - keeping you organized without manual effort.

License: MIT TypeScript React Supabase


✨ Key Features

πŸ” Modern Authentication

  • One-click Google Sign-In with Firebase
  • No passwords or magic links needed
  • Enterprise-grade security
  • 2-second login experience

πŸ€– AI Agent Intelligence

  • Real-time insights about your workload
  • Risk detection for projects
  • Smart task prioritization
  • Proactive deadline alerts

πŸ“§ Email Integration

  • Auto-sync Gmail inbox
  • AI-powered email summaries
  • Deadline extraction
  • Importance scoring
  • Draft email generation

πŸ“… Calendar Management

  • Google Calendar sync
  • Meeting conflict detection
  • Automatic task scheduling
  • Preparation reminders

πŸŽ₯ Meeting Intelligence

  • Auto-record meetings
  • Real-time transcription
  • Extract action items automatically
  • Generate meeting summaries
  • Create tasks from discussions

⚑ Make.com Automation

  • Custom workflow triggers
  • Multi-platform integration
  • Advanced automation scenarios
  • Webhook-based events

πŸ“Š Unified Dashboard

  • All tasks in one place
  • Project progress tracking
  • AI-powered insights
  • Real-time updates

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • Firebase account (free)
  • Supabase account
  • Google Cloud account (for Calendar/Gmail OAuth)
  • Make.com account (optional)

Installation

# Clone repository
git clone <your-repo-url>
cd agent-shadow

# Install dependencies
npm install

# Setup environment
cp .env.example .env
# Add your Supabase credentials to .env

# Run development server
npm run dev

Complete Setup Guide

πŸ“– Follow the detailed Quick Start Guide β†’


πŸ“š Documentation

Document Description
Quick Start Guide Get up and running in 30 minutes
Platform Overview Complete feature documentation
Make.com Setup Automation scenario templates
API Documentation Webhook API reference
Architecture System design and data flows

πŸ—οΈ Tech Stack

Frontend

  • React 18 + TypeScript
  • Vite (build tool)
  • TanStack Query (state management)
  • shadcn/ui + Tailwind CSS
  • React Router v6

Backend

  • Supabase (PostgreSQL + Auth + Realtime)
  • Edge Functions (Deno)
  • Row Level Security (RLS)

Integrations

  • Gmail API
  • Google Calendar API
  • Google Meet API
  • Make.com webhooks

AI/ML

  • OpenAI GPT-4 (via Make.com)
  • AssemblyAI (transcription)
  • Custom NLP for extraction

🎯 Use Cases

For Freelancers

  • Manage multiple client projects
  • Never miss a deadline
  • Auto-document all meetings
  • Generate client reports

For Consultants

  • Track billable hours from meetings
  • Organize client communications
  • Automate follow-ups
  • Maintain project history

For Small Teams

  • Centralized task management
  • Meeting notes distribution
  • Action item tracking
  • Progress reporting

πŸ“Έ Screenshots

Dashboard

Dashboard Unified view of tasks, projects, and AI insights

Calendar View

Calendar All meetings with transcripts and action items

Email Inbox

Email Inbox AI-analyzed emails with deadline extraction

Meeting Details

Meeting Details Full transcripts with extracted tasks


πŸ” Security

  • Encryption: OAuth tokens encrypted at rest
  • RLS: Row Level Security on all database tables
  • Authentication: Magic link authentication (no passwords)
  • Privacy: Your data never leaves your Supabase instance
  • Compliance: GDPR-ready data handling

πŸ›£οΈ Roadmap

Phase 1 (Current) βœ…

  • Core dashboard
  • Gmail integration
  • Calendar sync
  • Meeting transcription
  • Make.com webhooks
  • Real-time updates

Phase 2 (Next)

  • Slack integration
  • Invoice generation
  • Time tracking
  • Client portal
  • Mobile app (React Native)

Phase 3 (Future)

  • Voice commands
  • Browser extension
  • Notion integration
  • Team collaboration
  • Analytics dashboard

🀝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow TypeScript strict mode
  • Use Prettier for formatting
  • Write meaningful commit messages
  • Add tests for new features
  • Update documentation

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ†˜ Support

Documentation

Community

  • GitHub Issues: Bug reports and feature requests
  • Discussions: Questions and ideas

Professional Support


πŸ™ Acknowledgments

Built with these amazing tools:


πŸ’‘ Inspiration

Agent Shadow was built for freelancers who want to focus on their craft, not administrative tasks. Every feature is designed to save time and reduce mental overhead.

Philosophy: Your AI agent should work for you, not the other way around.


πŸ“Š Stats

  • Lines of Code: ~15,000+
  • Components: 50+
  • Database Tables: 12
  • API Endpoints: 8
  • Integration Points: 6+

🌟 Star History

Star History Chart


Built with ❀️ for freelancers everywhere
Start automating your operations today!

Quick Start β€’ Documentation β€’ Automation Guide β€’ Support

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published