Agentage Desktop

Lightweight desktop application for managing and running AI agents locally

✨ Features

• 🚀 Run agents locally - Execute AI agents on your machine
• ✏️ Edit configurations - Customize agent settings and behavior
• 📋 Manage agents - List, create, and organize your agents
• 🔒 Secure - Context isolation and validated inputs
• 🌐 Cross-platform - Linux, macOS, and Windows support

🛠️ Tech Stack

• Framework: Electron 33+ • React 18+
• Language: TypeScript 5.3+ (strict mode)
• Build: Vite 6+ • electron-builder
• Validation: Zod
• Testing: Jest 30+ • Playwright
• State: Zustand
• Styling: Tailwind CSS 4+

📋 Prerequisites

• Node.js ≥ 20.0.0
• npm ≥ 10.0.0

🚀 Quick Start

# Install dependencies
npm install

# Start development (Electron)
npm run dev

# Start development (Web)
npm run dev:web

# Build for production
npm run build

# Package for distribution
npm run package -w @agentage/electron

📦 Project Structure

packages/
  core/       # Core business logic
  electron/   # Electron main + preload
  frontend/   # React UI (renderer)
  server/     # Backend server
  shared/     # Shared types & schemas

🔧 Development

# Type checking
npm run type-check

# Linting
npm run lint
npm run lint:fix

# Testing
npm run test
npm run test:coverage
npm run test:e2e

# Full verification
npm run verify

🏗️ Building

# Build all packages
npm run build

# Package for current platform
npm run package -w @agentage/electron

Artifacts are published to GitHub Releases on tag push.

🤝 Contributing

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

📄 License

See LICENSE file for details.

---

Made with ❤️ by Agentage