@noeffortsai/nai 1.18.0-rc.8

package/README.md

@@ -0,0 +1,553 @@
+<div align="center">
+
+# 🚀 NoEffortsAI
+
+### The AI-Powered Software Development Platform
+
+<img src="https://img.shields.io/badge/React-18-61DAFB?style=for-the-badge&logo=react&logoColor=white" /> <img src="https://img.shields.io/badge/TypeScript-5-3178C6?style=for-the-badge&logo=typescript&logoColor=white" /> <img src="https://img.shields.io/badge/Vite-5-646CFF?style=for-the-badge&logo=vite&logoColor=white" /> <img src="https://img.shields.io/badge/Tailwind-3-06B6D4?style=for-the-badge&logo=tailwindcss&logoColor=white" /> <img src="https://img.shields.io/badge/Supabase-Backend-3FCF8E?style=for-the-badge&logo=supabase&logoColor=white" />
+
+**Ship production-grade applications with an autonomous AI coding agent that reasons, plans, writes, tests, and deploys.**
+
+🇮🇳 *AI for All, from India* — Built by **Rohit Vishal**
+
+[Website](https://noeffortsai.ai) · [Blog](/blog) · [Learning Hub](/learn) · [Showcase](/showcase)
+
+</div>
+
+---
+
+## 📋 Table of Contents
+
+- [Overview](#-overview)
+- [Key Features](#-key-features)
+- [Tech Stack](#-tech-stack)
+- [Architecture](#-architecture)
+- [Agent Intelligence](#-agent-intelligence)
+- [Protocol System](#-protocol-system)
+- [Neuron Memory Engine](#-neuron-memory-engine)
+- [Builder IDE](#-builder-ide)
+- [Integrations](#-integrations)
+- [Edge Functions](#-edge-functions)
+- [Database Schema](#-database-schema)
+- [Pages & Routes](#-pages--routes)
+- [Security](#-security)
+- [Getting Started](#-getting-started)
+- [Documentation](#-documentation)
+- [Contributing](#-contributing)
+
+---
+
+## 🌟 Overview
+
+NoEffortsAI is a full-stack AI development platform that combines a professional browser-based IDE with an autonomous coding agent. The agent uses a **ReAct (Reasoning + Acting)** loop to understand your codebase, plan tasks, write code, run tests, and deploy — all from a single chat interface.
+
+**What makes it different:**
+
+- 🧠 **Autonomous Agent** — ReAct reasoning loop with 145+ tools
+- 🔀 **25+ AI Models** — Multi-provider gateway (OpenAI, Google, Anthropic, and more)
+- 🌐 **11 Agent Protocols** — MCP, A2A, FCP, LangChain, and 7 more
+- 🧬 **10-Neuron Memory** — Persistent contextual intelligence
+- 🚀 **One-Click Deploy** — Vercel, Netlify, Railway, VPS
+- 🤝 **Real-Time Collaboration** — Live cursors, presence, co-editing
+- 🛡️ **Enterprise Security** — RLS, PII filtering, encrypted keys, RBAC
+
+---
+
+## ✨ Key Features
+
+### AI Agent Engine
+- **ReAct Reasoning Loop** — Thought → Action → Observation cycle for systematic problem-solving
+- **Multi-Agent Roles** — Planner, Implementer, and Verifier operate in sequence
+- **145+ Tools** — File ops, code search, parsing, linting, testing, deployment, and more
+- **Auto-Test Runner** — Every code block is tested in a cloud sandbox before delivery
+- **Plan Engine** — Structured task decomposition with human-in-the-loop approval
+- **Safety Layer** — PII filtering, shell command guardrails, trust signal scoring
+
+### Multi-Model AI Gateway
+- **25+ Models** — GPT-5, GPT-5-mini, Gemini 2.5 Pro/Flash, Claude, and more
+- **Database-Driven Config** — Models and routes managed via `platform_models` and `platform_provider_config` tables
+- **Smart Routing** — Automatic model selection based on task complexity
+- **Stream Normalization** — Unified streaming across OpenAI, Anthropic, Gemini, Ollama, Cohere formats
+- **Auto-Failover** — Cascading fallback across multiple backend routes with priority ordering
+- **BYOK Support** — Bring Your Own Key for any OpenAI-compatible provider
+
+### Professional IDE (Builder)
+- **Split Editor** — Side-by-side file editing with CodeMirror 6
+- **File Tree** — Full project navigation with icons, search, and create/rename/delete
+- **Terminal Panel** — macOS-style integrated terminal with xterm.js
+- **Live Preview** — Hot-reloading preview panel with device profiles
+- **Git Panel** — Branch management, commit history, diff review
+- **Activity Panel** — Real-time action log of agent operations
+- **Inline Diagnostics** — Error and warning overlays in the editor
+- **Autocomplete** — Context-aware code suggestions
+
+### Real-Time Collaboration
+- **Live Cursors** — See teammates' cursor positions with color-coded labels
+- **Presence Tracking** — Online status and avatar stacks across the workspace
+- **Follow Mode** — Track another collaborator's active view
+- **Conflict Detection** — Alerts when multiple users edit the same file
+- **Discussion Threads** — File-specific or general project feedback
+
+### Deployment & DevOps
+- **GitHub Integration** — Two-way sync, branch management, PRs, issues, actions
+- **Vercel Deploy** — One-click production deployments with environment variables
+- **Netlify Deploy** — Site creation, build hooks, deployment history
+- **Railway Deploy** — Service lifecycle management and log streaming
+- **VPS Bridge** — Direct server control with one-click Ubuntu setup script
+- **CI/CD Pipeline** — Chain up to 20 steps with dependency resolution across all platforms
+
+### Skill Marketplace
+- **Install Skills** — Extend the agent with community-built capabilities
+- **GitHub Import** — Load skills directly from repositories
+- **Publish & Share** — Create and distribute your own agent skills
+- **Auto-Injection** — Active skills are injected into the agent's system prompt at runtime
+
+### Learning Hub
+- **Zero-to-Builder Track** — Structured curriculum from basics to advanced
+- **AI Agent Fundamentals** — ReAct loops, memory, prompt engineering
+- **Architecture Guides** — Systems design, frontend/backend patterns
+- **Real-World Projects** — Hands-on building exercises
+
+### Content & Community
+- **Blog CMS** — Full editor with publishing, tagging, and cover images
+- **Explore Gallery** — Browse public community projects
+- **Showcase** — Featured projects and success stories
+- **Team Chat** — Real-time workspace messaging with file sharing and threads
+
+---
+
+## 🛠️ Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| **Frontend** | React 18, TypeScript 5, Vite 5, Tailwind CSS 3 |
+| **UI Components** | shadcn/ui, Radix UI, Framer Motion, Lucide Icons |
+| **Editor** | CodeMirror 6 (JS, JSON, Markdown, SQL) |
+| **Terminal** | xterm.js with fit and web-links addons |
+| **Charts** | Recharts |
+| **State** | TanStack React Query, React Hook Form, Zod |
+| **Backend** | Supabase (Postgres, Auth, Realtime, Edge Functions, Storage) |
+| **Vector Search** | Voyage AI embeddings + Qdrant |
+| **Web Scraping** | Firecrawl (scrape, crawl, map, search) |
+| **Code Execution** | Cloud sandbox via onlinecompiler.io |
+| **Deployment** | Vercel, Netlify, Railway, VPS (Ubuntu) |
+| **Auth** | Email/password, Google OAuth, Apple Sign-In, Google One Tap |
+
+---
+
+## 🏗️ Architecture
+
+```
+┌──────────────────────────────────────────────────┐
+│                    Frontend                       │
+│  React 18 + Vite 5 + Tailwind CSS + TypeScript   │
+├──────────────────────────────────────────────────┤
+│                  Agent Core                       │
+│  ReAct Loop → Plan Engine → Tool Registry (145+) │
+│  Model Router → Safety Layer → Neuron Memory     │
+│  11 Protocols → Skill Injector → Code Parser     │
+├──────────────────────────────────────────────────┤
+│             Backend (Edge Functions)              │
+│  chat · code-runner · embed-text · web-intel      │
+│  github-proxy · vercel-proxy · netlify-proxy      │
+│  railway-proxy · turso-proxy · vps-proxy          │
+│  pipeline-orchestrator · skill-manager            │
+│  vision-to-code · stitch-generate · qdrant-proxy  │
+├──────────────────────────────────────────────────┤
+│              Data & Storage                       │
+│  Postgres (27+ tables) · Realtime · Auth · RLS    │
+│  Voyage AI Embeddings · Qdrant Vector DB          │
+│  Transactional Email Queue (PGMQ)                 │
+└──────────────────────────────────────────────────┘
+```
+
+---
+
+## 🧠 Agent Intelligence
+
+### ReAct Reasoning Loop
+
+The agent operates in a continuous Thought → Action → Observation cycle:
+
+1. **Context Assembly** — Gathers chat history, vector search results, repo map, file relevance scores (TF-IDF)
+2. **Reasoning** — Thinks about what needs to be done next
+3. **Action** — Executes one of 145+ tools
+4. **Observation** — Checks the result, decides if more steps are needed
+5. **Verification** — Auto-tests generated code, fixes failures, and re-tests
+
+### Tool Categories
+
+| Category | Examples | Count |
+|----------|----------|-------|
+| **File Ops** | read, write, delete, list, patch, search | 15+ |
+| **Code Intelligence** | parse AST, search symbols, lint, format | 20+ |
+| **AI & Analysis** | chat, analyze, suggest, summarize | 10+ |
+| **GitHub** | create repo, push file, create PR, list issues | 20+ |
+| **Deploy** | vercel deploy, netlify create, railway restart | 25+ |
+| **VPS** | exec command, docker manage, nginx configure | 38+ |
+| **Data** | db query, embed text, vector search, crawl web | 15+ |
+| **System** | checkpoint, ask user, verify, plan | 10+ |
+
+### Advanced Capabilities
+
+- **Competitive Toolset** — Surgical file patching, project-wide refactoring, component extraction, security auditing, accessibility scanning, bundle analysis
+- **Language Engine** — Specialized rules for 13+ languages (Python, Go, Rust, Java, TypeScript, etc.)
+- **Framework Profiles** — 10+ framework templates (Django, FastAPI, NestJS, Next.js, etc.)
+- **Iteration Intelligence** — Autonomous self-correction chains for syntax/type/runtime errors
+- **Minimal Edit Enforcer** — Edit-in-place logic for smallest possible diffs
+- **Context Budget** — Smart token allocation across history, files, and search results
+
+---
+
+## 🔌 Protocol System
+
+NoEffortsAI supports **11 interoperability protocols** for universal agent communication:
+
+| Protocol | Standard | Purpose |
+|----------|----------|---------|
+| **MCP** | Anthropic | Model Context Protocol for external tool servers |
+| **FCP** | OpenAI | Function Calling Protocol for structured tool use |
+| **A2A** | Google | Agent-to-Agent communication |
+| **ACP** | IBM | Agent Communication Protocol |
+| **LangChain** | LangChain | Agent framework integration |
+| **TAP** | — | Tool Augmented Protocol |
+| **TDF** | Stanford | Task Description Framework |
+| **AgentOS** | — | Agent runtime environment |
+| **AGP** | — | Agent Gateway Protocol |
+| **OAP** | — | Open Agent Protocol |
+| **RDF** | W3C | Resource Description Framework |
+
+All protocols share a unified type system (`ProtocolAdapter`, `ProtocolMessage`, `ProtocolTool`, `TaskEnvelope`) and are managed by a central `ProtocolRegistry`.
+
+---
+
+## 🧬 Neuron Memory Engine
+
+A 10-neuron cognitive system provides persistent, contextual intelligence:
+
+| Neuron | File | Purpose |
+|--------|------|---------|
+| **Entity** | `entityNeuron.ts` | Tracks entities (people, projects, APIs) across conversations |
+| **Fact** | `factNeuron.ts` | Stores verified facts about the codebase |
+| **History** | `historyNeuron.ts` | Compressed conversation memory |
+| **Knowledge** | `knowledgeNeuron.ts` | Domain-specific knowledge base |
+| **Skill** | `skillNeuron.ts` | Learned capabilities and patterns |
+| **System** | `systemNeuron.ts` | Platform configuration awareness |
+| **Task** | `taskNeuron.ts` | Active task tracking and decomposition |
+| **Todo** | `todoNeuron.ts` | Persistent to-do management |
+| **Workspace** | `workspaceNeuron.ts` | Project structure and file awareness |
+
+Coordinated by the `neuronEngine.ts` orchestrator for holistic context assembly.
+
+---
+
+## 🖥️ Builder IDE
+
+The Builder (`/builder/:projectId`) is a professional IDE with:
+
+| Panel | Component | Description |
+|-------|-----------|-------------|
+| **Chat** | `ChatPanel.tsx` | AI conversation with markdown, code blocks, tool results |
+| **Code Editor** | `CodeEditor.tsx` | CodeMirror 6 with syntax highlighting, autocomplete, themes |
+| **Split Editor** | `SplitEditor.tsx` | Side-by-side file comparison and editing |
+| **File Tree** | `FileTree.tsx` | Project navigation with icons and search |
+| **Terminal** | `TerminalPanel.tsx` | xterm.js integrated terminal |
+| **Preview** | `PreviewPanel.tsx` | Live hot-reloading app preview |
+| **Git** | `GitPanel.tsx` | Branch management, commits, diff review |
+| **Activity** | `ActivityPanel.tsx` | Real-time agent action log |
+| **Deploy** | `DeployPanel.tsx` | One-click deployment controls |
+| **CI/CD** | `CicdDashboard.tsx` | Pipeline monitoring and management |
+| **Plan** | `PlanProgressPanel.tsx` | Task plan visualization with approval |
+| **Skills** | `SkillMarketplace.tsx` | Install and manage agent skills |
+| **Stitch** | `StitchPanel.tsx` | AI code generation from templates |
+| **Vision** | `VisionToCodeDialog.tsx` | Screenshot to code conversion |
+| **Restructure** | `RestructurePanel.tsx` | Automated code refactoring |
+| **MCP** | `McpConnectionDialog.tsx` | External tool server connections |
+
+---
+
+## 🔗 Integrations
+
+### Cloud Services
+
+| Service | Proxy Edge Function | Manager Page | Capabilities |
+|---------|-------------------|--------------|--------------|
+| **GitHub** | `github-proxy` | `/github` | Repos, branches, PRs, issues, actions, file push |
+| **Vercel** | `vercel-proxy` | `/vercel` | Projects, deployments, env vars, domains |
+| **Netlify** | `netlify-proxy` | `/netlify` | Sites, deploys, build hooks, DNS |
+| **Railway** | `railway-proxy` | `/railway` | Services, deployments, logs, env vars |
+| **Turso** | `turso-proxy` | `/turso` | Databases, organizations, usage |
+
+### AI & Data Services
+
+| Service | Edge Function | Purpose |
+|---------|--------------|---------|
+| **Multi-Model AI** | `chat` | GPT-5, Gemini, Claude via gateway |
+| **Voyage AI** | `embed-text` | Code and text embeddings |
+| **Qdrant** | `qdrant-proxy` | Vector similarity search |
+| **Firecrawl** | `firecrawl-*` | Web scraping, crawling, mapping, search |
+| **Vision AI** | `vision-to-code` | Image to code generation |
+| **Audio AI** | `generate-audio`, `check-audio` | Text-to-speech and audio processing |
+| **Code Runner** | `code-runner` | 20+ language cloud execution |
+
+### Infrastructure
+
+| Service | Edge Function | Purpose |
+|---------|--------------|---------|
+| **VPS** | `vps-proxy` | Remote server management |
+| **Pipeline** | `pipeline-orchestrator` | Multi-step CI/CD chains |
+| **Webhooks** | `webhook-trigger` | Event-driven automation |
+| **Email** | `send-transactional-email`, `process-email-queue` | Transactional emails via PGMQ |
+| **Figma** | `figma-proxy` | Design file import |
+
+---
+
+## ⚡ Edge Functions
+
+35+ Supabase Edge Functions power the backend:
+
+| Function | Purpose |
+|----------|---------|
+| `chat` | Multi-model AI gateway with stream normalization and failover |
+| `code-runner` | Cloud code execution sandbox (20+ languages) |
+| `code-scaffold` | Project template generation |
+| `ai-code-tools` | AI-powered code analysis tools |
+| `data-tools` | Database query and data manipulation |
+| `devops-tools` | Infrastructure management utilities |
+| `embed-text` | Text/code embedding via Voyage AI |
+| `qdrant-proxy` | Vector database operations |
+| `web-intel` | Web scraping and intelligence |
+| `vision-to-code` | Screenshot to code generation |
+| `stitch-generate` | Template-based code generation |
+| `skill-manager` | Skill marketplace CRUD operations |
+| `pipeline-orchestrator` | CI/CD pipeline execution engine |
+| `integration-health` | Service connectivity monitoring |
+| `secure-proxy` | Encrypted API key relay |
+| `auth-email-hook` | Custom auth email templates |
+| `send-transactional-email` | PGMQ-backed email delivery |
+| `webhook-trigger` | Integration event dispatch |
+| `firecrawl-*` | Web scraping suite (scrape, crawl, map, search) |
+| `*-proxy` | GitHub, Vercel, Netlify, Railway, Turso, VPS, Figma |
+
+---
+
+## 💾 Database Schema
+
+27+ tables across multiple domains:
+
+### Core
+| Table | Purpose |
+|-------|---------|
+| `projects` | User projects with visibility and status |
+| `files` | Project files with content |
+| `file_versions` | File version history |
+| `chats` | AI conversation threads |
+| `messages` | Chat messages |
+| `activity_logs` | Project activity timeline |
+| `usage_logs` | AI model usage and cost tracking |
+
+### Users & Auth
+| Table | Purpose |
+|-------|---------|
+| `profiles` | User display names, avatars, emails |
+| `user_roles` | RBAC roles (admin, moderator, user) |
+| `user_preferences` | Theme, font size, accent color, animations |
+| `provider_keys` | User API keys (BYOK) |
+| `custom_providers` | User-configured AI providers |
+| `project_collaborators` | Project sharing and permissions |
+
+### Platform
+| Table | Purpose |
+|-------|---------|
+| `platform_models` | Global AI model catalog |
+| `platform_provider_config` | Backend API routes with priority |
+| `integrations` | Connected service tokens |
+| `webhook_events` | Integration event logs |
+| `mcp_connections` | MCP server connections |
+
+### Agent
+| Table | Purpose |
+|-------|---------|
+| `agent_sessions` | Agent conversation sessions |
+| `agent_turns` | Individual agent turns with token counts |
+| `agent_memory` | Persistent agent memory store |
+| `jobs` | Background job execution |
+| `job_steps` | Individual job step tracking |
+| `artifacts` | Job output artifacts |
+
+### Skills
+| Table | Purpose |
+|-------|---------|
+| `skills` | Marketplace skill definitions |
+| `skill_installs` | Project skill installations |
+
+### Content
+| Table | Purpose |
+|-------|---------|
+| `blog_posts` | Blog CMS content |
+| `team_messages` | Real-time team chat (Realtime enabled) |
+| `notes` | User notes with tags and pinning |
+| `todos` | User task management |
+| `reminders` | Scheduled reminders |
+
+### Email
+| Table | Purpose |
+|-------|---------|
+| `email_send_log` | Email delivery tracking |
+| `email_send_state` | Send rate configuration |
+| `email_unsubscribe_tokens` | Unsubscribe link tokens |
+| `suppressed_emails` | Suppressed email addresses |
+
+---
+
+## 🗺️ Pages & Routes
+
+### Public Pages
+| Route | Page | Description |
+|-------|------|-------------|
+| `/` | Landing | Hero, features, pricing, integrations, showcase |
+| `/blog` | Blog | Published articles with tags |
+| `/blog/:slug` | Blog Post | Individual article view |
+| `/learn` | Learning Hub | Educational content and courses |
+| `/explore` | Explore | Public project gallery |
+| `/showcase` | Showcase | Featured projects |
+| `/about` | About | Company information |
+| `/contact` | Contact | Contact form |
+
+### Protected Pages
+| Route | Page | Description |
+|-------|------|-------------|
+| `/dashboard` | Dashboard | Projects, stats, activity, AI insights, usage charts |
+| `/builder/:projectId` | Builder IDE | Full development workspace |
+| `/project/:projectId` | Project Hub | 10-tab project management console |
+| `/settings` | Settings | Account, billing, editor, team, providers, VPS |
+| `/admin` | Admin | Platform model catalog, provider routes, user management |
+| `/team-chat` | Team Chat | Real-time messaging workspace |
+| `/productivity` | Productivity | Task and workflow management |
+| `/blog/new` | Blog Editor | Create and edit blog posts |
+
+### Integration Pages
+| Route | Page |
+|-------|------|
+| `/github` | GitHub repository and PR management |
+| `/vercel` | Vercel project and deployment management |
+| `/netlify` | Netlify site management |
+| `/railway` | Railway service management |
+| `/turso` | Turso database management |
+
+### Legal Pages
+`/privacy` · `/terms` · `/disclaimer` · `/cookie-policy` · `/dmca` · `/data-sharing` · `/opt-out` · `/unsubscribe`
+
+---
+
+## 🔒 Security
+
+| Layer | Implementation |
+|-------|---------------|
+| **Authentication** | JWT sessions, Google/Apple OAuth, Google One Tap, email verification |
+| **Authorization** | Row Level Security (RLS) on all 27+ tables |
+| **RBAC** | `user_roles` table with `has_role()` SECURITY DEFINER function |
+| **API Keys** | Encrypted storage, BYOK model, no hardcoded secrets |
+| **Agent Safety** | PII filtering, shell command guardrails, trust signal scoring |
+| **Edge Security** | CORS headers, Zod input validation, auth token verification |
+| **Collaboration** | `is_project_owner()`, `is_project_editor()`, `is_project_collaborator()` RPC checks |
+| **Email** | Suppression lists, unsubscribe tokens, send rate limiting |
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Node.js ≥ 18
+- npm or Bun
+- Git
+
+### Installation
+
+```bash
+git clone https://github.com/noeffortsai/noeffortsai.git
+cd noeffortsai
+npm install
+npm run dev
+```
+
+### Environment Variables
+
+```env
+VITE_SUPABASE_URL=your_supabase_url
+VITE_SUPABASE_PUBLISHABLE_KEY=your_anon_key
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm run dev` | Start development server |
+| `npm run build` | Production build |
+| `npm run test` | Run Vitest test suite |
+| `npm run lint` | ESLint check |
+| `npm run preview` | Preview production build |
+
+---
+
+## 📚 Documentation
+
+| Document | Description |
+|----------|-------------|
+| [ARCHITECTURE.md](./ARCHITECTURE.md) | System design, ReAct loop, data flow |
+| [ROADMAP.md](./ROADMAP.md) | Product roadmap with progress tracking |
+| [CHANGELOG.md](./CHANGELOG.md) | Version history and release notes |
+| [CONTRIBUTING.md](./CONTRIBUTING.md) | Development workflow and coding standards |
+| [docs/API_REFERENCE.md](./docs/API_REFERENCE.md) | Edge function API documentation |
+| [docs/AGENT_GUIDE.md](./docs/AGENT_GUIDE.md) | Agent system deep dive |
+| [docs/DEPLOYMENT_GUIDE.md](./docs/DEPLOYMENT_GUIDE.md) | Deployment and infrastructure setup |
+| [docs/SECURITY.md](./docs/SECURITY.md) | Security model and best practices |
+| [docs/PROTOCOLS.md](./docs/PROTOCOLS.md) | Protocol system documentation |
+| [docs/SKILLS.md](./docs/SKILLS.md) | Skill marketplace guide |
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for full guidelines.
+
+```bash
+# 1. Fork and clone
+# 2. Create feature branch
+git checkout -b feature/amazing-feature
+# 3. Make changes and test
+npm run test
+# 4. Commit with conventional format
+git commit -m "feat: add amazing feature"
+# 5. Push and open PR
+```
+
+---
+
+## 📊 Project Stats
+
+| Metric | Count |
+|--------|-------|
+| React Components | 150+ |
+| Agent Tools | 145+ |
+| Edge Functions | 35+ |
+| Database Tables | 27+ |
+| AI Models Supported | 25+ |
+| Agent Protocols | 11 |
+| Memory Neurons | 10 |
+| Supported Languages | 20+ |
+| Integration Services | 7 |
+| Pages/Routes | 30+ |
+
+---
+
+<div align="center">
+
+**Built with ❤️ by [Rohit Vishal](https://noeffortsai.ai)**
+
+🇮🇳 AI for All, from India
+
+[Website](https://noeffortsai.ai) · [GitHub](https://github.com/noeffortsai) · [Blog](https://noeffortsai.ai/blog)
+
+</div>

package/bin/nai

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// NoEffortsAi CLI launcher.
+//
+// The TUI depends on @opentui/core which uses bun:ffi — so the bundle MUST
+// run under the Bun runtime. We locate `bun` on PATH (or $BUN_INSTALL/bin)
+// and exec the bundle through it. If Bun is missing we print a one-line
+// install hint instead of crashing with a cryptic FFI error.
+import { spawn, spawnSync } from "node:child_process"
+import { fileURLToPath } from "node:url"
+import { existsSync } from "node:fs"
+import path from "node:path"
+import os from "node:os"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const bundle = path.join(__dirname, "..", "dist", "nai.mjs")
+
+function findBun() {
+  // 1. Explicit override
+  if (process.env.NAI_BUN && existsSync(process.env.NAI_BUN)) return process.env.NAI_BUN
+  // 2. $BUN_INSTALL/bin/bun
+  const bunInstall = process.env.BUN_INSTALL || path.join(os.homedir(), ".bun")
+  const candidate = path.join(bunInstall, "bin", process.platform === "win32" ? "bun.exe" : "bun")
+  if (existsSync(candidate)) return candidate
+  // 3. PATH lookup
+  const which = process.platform === "win32" ? "where" : "which"
+  const res = spawnSync(which, ["bun"], { encoding: "utf8" })
+  if (res.status === 0) {
+    const found = res.stdout.split(/\r?\n/).find((l) => l.trim())
+    if (found && existsSync(found.trim())) return found.trim()
+  }
+  return null
+}
+
+const bun = findBun()
+if (!bun) {
+  console.error("nai: Bun runtime is required but was not found on PATH.")
+  console.error("")
+  console.error("  Install Bun:   curl -fsSL https://bun.sh/install | bash")
+  console.error("  Then re-run:   nai")
+  console.error("")
+  console.error("Or point nai at an existing Bun binary:  export NAI_BUN=/path/to/bun")
+  process.exit(127)
+}
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+const child = spawn(bun, ["run", bundle, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  env: process.env,
+})
+
+const forwarders = {}
+for (const signal of forwardedSignals) {
+  forwarders[signal] = () => { try { child.kill(signal) } catch {} }
+  process.on(signal, forwarders[signal])
+}
+
+child.on("error", (err) => {
+  console.error(err?.message ?? String(err))
+  process.exit(1)
+})
+
+child.on("exit", (code, signal) => {
+  for (const s of forwardedSignals) process.removeListener(s, forwarders[s])
+  if (signal) { process.kill(process.pid, signal); return }
+  process.exit(typeof code === "number" ? code : 0)
+})