█████╗ ██╗ ██╗██████╗ ███████╗███╗ ██╗ ██████╗ ███████╗
██╔══██╗██║ ██║██╔══██╗██╔════╝████╗ ██║ ██╔═══██╗██╔════╝
███████║██║ ██║██████╔╝█████╗ ██╔██╗ ██║ ██║ ██║███████╗
██╔══██║██║ ██║██╔══██╗██╔══╝ ██║╚██╗██║ ██║ ██║╚════██║
██║ ██║╚██████╔╝██║ ██║███████╗██║ ╚████║██╗╚██████╔╝███████║
╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═══╝╚═╝ ╚═════╝ ╚══════╝
| App | Path | Description |
|---|---|---|
| 🚀 AuRen Workspace | /workspace/ |
AI agent development IDE with chat, tools, extensions |
| 🧩 AuRenHub | /aurenhub/ |
Community marketplace for skills & plugins |
| 📊 AI Platform Dashboard | / |
Analytics dashboard for AI dev platforms 2024–2026 |
| 🎨 AI Platforms Slides | /ai-platforms-slides/ |
Professional slide deck on AI landscape |
| 🔧 Debug Loop Simulator | /simulator/ |
Self-healing debug loop visualizer |
| ⚡ API Server | /api/ |
Express 5 REST API with OpenAPI contract |
| 🌐 Portal | /aurenhub/portal |
Unified portal linking all apps |
|
|
auren-os/ # pnpm monorepo
├── artifacts/
│ ├── auren-workspace/ # 🚀 Main AI workspace (React + Vite)
│ │ ├── src/pages/ # landing, workspace, tools, library, etc.
│ │ ├── src/components/ # Sidebar, MobileNav, AuRenMascot
│ │ └── src/hooks/useAuth.ts # localStorage auth system
│ │
│ ├── aurenhub/ # 🧩 Skills & plugins marketplace (React + Vite)
│ │ ├── src/pages/ # home, skills, plugins, publishers, portal
│ │ ├── src/components/ # Navbar, Drawer
│ │ ├── src/data/catalog.ts # Skills & plugins data
│ │ └── src/hooks/useAuth.ts # GitHub OAuth auth system
│ │
│ ├── ai-platform-dashboard/ # 📊 Analytics dashboard (React + Vite + Recharts)
│ ├── ai-platforms-slides/ # 🎨 Slide deck artifact
│ ├── debug-simulator/ # 🔧 Self-healing loop visualizer
│ ├── api-server/ # ⚡ Express 5 REST API
│ └── mockup-sandbox/ # 🎭 Component preview server (dev-only)
│
├── lib/
│ ├── api-spec/ # OpenAPI 3.1 contract (SSOT)
│ ├── api-client-react/ # Generated React Query hooks
│ ├── api-zod/ # Generated Zod schemas
│ └── db/ # Drizzle ORM + PostgreSQL schema
│
├── scripts/ # Utility scripts
├── tsconfig.base.json # Shared TypeScript config
└── pnpm-workspace.yaml # Workspace catalog & settings
Color Palette:
Background: #080809 / #0d0e14 Dark near-black
Cards: #0f0f12 / #16171e Elevated surfaces
Accent: #00cfab AuRen teal (primary)
Text: #e8eaf2 Primary text
Muted: #8892a4 Secondary text
Typography: Inter (system-ui fallback)
Mascot: Custom kawaii SVG crab — rounded, big eyes, rosy cheeks
- Node.js 24+
- pnpm 9+
- PostgreSQL (auto-provisioned on Replit)
Note for Replit users:
.replitis excluded from version control (it is Replit-specific platform config). When opening this repo on Replit, the platform recreates.replitautomatically fromartifact.tomlservice definitions — no manual setup needed.
# Clone the repository
git clone https://github.com/dotcom-03/auren-os.git
cd auren-os
# Install dependencies
pnpm install
# Set up environment variables
cp .env.example .env
# Edit .env with your DATABASE_URL and SESSION_SECRET
# Push database schema
pnpm --filter @workspace/db run push
# Start all services
pnpm --filter @workspace/api-server run dev
pnpm --filter @workspace/auren-workspace run dev
pnpm --filter @workspace/aurenhub run dev# After modifying lib/api-spec/openapi.yaml:
pnpm --filter @workspace/api-spec run codegen| Layer | Technology |
|---|---|
| Runtime | Node.js 24, TypeScript 5.9 |
| Package Manager | pnpm workspaces (monorepo) |
| Frontend | React 19, Vite 6, Wouter, Framer Motion |
| Styling | Tailwind CSS v4 + inline styles |
| API | Express 5, OpenAPI 3.1 (contract-first) |
| Database | PostgreSQL + Drizzle ORM |
| Validation | Zod v4 + drizzle-zod |
| Code Generation | Orval (React Query hooks + Zod schemas) |
| Build | esbuild (API), Vite (frontends) |
| Logging | Pino + pino-http |
# Development
pnpm --filter @workspace/auren-workspace run dev # Workspace (port 20860)
pnpm --filter @workspace/aurenhub run dev # AuRenHub (port 19113)
pnpm --filter @workspace/api-server run dev # API (port 5000)
# Quality
pnpm run typecheck # Full typecheck
pnpm run build # Build all packages
# Database
pnpm --filter @workspace/db run push # Push schema changes
# API
pnpm --filter @workspace/api-spec run codegen # Regenerate API typesWe welcome contributions from the community! Here's how to get started:
- Fork the repository
- Create a feature branch:
git checkout -b feat/your-skill-name - Build your skill or plugin following the AuRenHub spec
- Submit a pull request with a clear description
Skills are self-contained modules that extend AuRen's capabilities:
// Example skill structure
export const mySkill = {
name: "My Awesome Skill",
version: "1.0.0",
description: "What this skill does",
tags: ["automation", "productivity"],
run: async (input: string) => {
// Your skill logic here
return { result: "Done!" };
}
};Languages: TypeScript 94% · CSS 4% · Other 2%
Artifacts: 7 (5 web apps + 1 API + 1 sandbox)
Total Pages: 25+
Components: 50+
API Endpoints: 15+
MIT License — see LICENSE for details.
Built with 🦞 by the AuRen OS community
AuRen OS is not affiliated with Anthropic.