@dubeyvishal/orbital-cli 1.0.1

package/README.md

@@ -0,0 +1,95 @@
+#  Orbital CLI
+
+**Orbital CLI** is an AI-powered developer CLI that lets you **chat with AI**, run **smart tool-assisted searches**, and even enter **Agent Mode** where it can generate **mini-projects directly inside your directory** — in minutes — from just a single text prompt.
+
+Built with **Next.js**, **Node.js**, **Express**, and **Commander.js**, with secure auth powered by **Better Auth (OAuth + Device Authorization)**.
+
+---
+
+## ✨ Features
+
+###  AI Chat Mode
+- Chat with AI directly in your terminal
+- Streaming responses (real-time)
+- Supports markdown rendering in terminal output
+
+### 🧠 Autonomous Tool Selection
+Orbital intelligently selects tools when needed:
+- 🔍 Web Search
+- 🔗 URL Search / Page Summarization
+- 🧰 Context-based tool routing (AI decides when to use tools)
+
+### 🤖 Agent Mode (Autonomous App Generator)
+The most powerful mode:
+- Generates **mini-projects** from a single prompt
+- Creates **folders + files automatically**
+- Writes production-ready code
+- Generates setup commands
+- Output saved neatly into your working directory
+- Designed to build a runnable project in **a few minutes**
+
+### 🔐 Secure Authentication
+- OAuth using **Better Auth**
+- **Device Authorization flow**
+- Session + token handling
+
+---
+
+## 🧱 Tech Stack
+- **Next.js** (Dashboard / Web UI)
+- **Node.js**
+- **Express.js**
+- **Commander.js** (CLI framework)
+- **Better Auth** (OAuth + Device Flow)
+- **Prisma** (Database ORM)
+- **Neon PostgreSQL** (recommended)
+- **AI SDK (Google Gemini)**
+
+---
+
+## 📦 Installation
+
+## Deployed URLs
+
+- Frontend (Vercel): https://smart-cli-based-agent-t7x4.vercel.app/sign-in
+- Backend (Render): https://smart-cli-based-agent.onrender.com
+
+Clone the repo:
+
+```bash
+git clone https://github.com/<your-username>/orbital-cli.git
+cd orbital-cli
+
+```
+
+Environment Setup
+
+DATABASE_URL="postgresql://USER:PASSWORD@HOST:5432/DATABASE?sslmode=require"
+GOOGLE_GEMINI_API_KEY="your_api_key"
+ORBITAL_MODEL="gemini-2.5-flash"
+
+# Deployed URLs
+BETTER_AUTH_BASE_URL="https://smart-cli-based-agent.onrender.com"
+FRONTEND_URL="https://smart-cli-based-agent-t7x4.vercel.app"
+
+Then generate Prisma client + sync schema:
+
+cd server
+npx prisma generate
+npx prisma db push
+
+Run Orbital CLI:
+orbital
+
+Orbital uses secure OAuth + Device Authorization:
+orbital login
+
+Chat with AI
+orbital wakeup
+Output
+When agent generation succeeds, Orbital shows:
+
+App folder name
+Total files created
+Location on disk
+Setup commands (install, run)

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@dubeyvishal/orbital-cli",
+  "version": "1.0.1",
+  "description": "A fullstack CLI-based AI platform with chat mode, multi-tool agents, and agentic AI workflows. Includes GitHub login with device authorization, secure authentication, and modular client–server architecture for building intelligent automation tools.",
+  "author": "Vishal Dubey",
+  "license": "MIT",
+
+  "private": false,
+
+  "type": "module",
+  "bin": {
+    "orbital": "server/src/cli/main.js"
+  },
+  "files": [
+    "server/src/cli/",
+    "server/src/config/",
+    "server/src/lib/",
+    "server/src/service/",
+    "server/prisma/schema.prisma",
+    "README.md"
+  ],
+
+  "publishConfig": {
+    "access": "public"
+  },
+
+  "engines": {
+    "node": ">=18"
+  },
+
+  "dependencies": {
+    "@ai-sdk/google": "^3.0.6",
+    "@clack/prompts": "^0.11.0",
+    "@prisma/client": "^5.22.0",
+    "ai": "^6.0.29",
+    "better-auth": "^1.4.10",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "figlet": "^1.9.4",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "open": "^11.0.0",
+    "prisma": "^5.22.0",
+    "yocto-spinner": "^1.0.0",
+    "zod": "^4.3.5"
+  },
+
+  "scripts": {
+    "install-all": "npm install --prefix client && npm install --prefix server",
+    "start-client": "npm start --prefix client",
+    "start-server": "npm start --prefix server",
+    "dev": "npm run start-server && npm run start-client"
+  },
+
+  "keywords": [
+    "orbital",
+    "cli",
+    "nodejs",
+    "fullstack",
+    "client-server",
+    "javascript"
+  ]
+}

package/server/prisma/schema.prisma

@@ -0,0 +1,117 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+  directUrl = env("DIRECT_DATABASE_URL")
+}
+
+model Test {
+  id   String @id @default(cuid())
+  name String
+}
+
+model User {
+  id            String         @id @default(cuid())
+  name          String
+  email         String         @unique
+  emailVerified Boolean        @default(false)
+  image         String?
+  createdAt     DateTime       @default(now())
+  updatedAt     DateTime       @updatedAt
+  accounts      Account[]
+  conversations Conversation[]
+  sessions      Session[]
+
+  @@map("user")
+}
+
+model Session {
+  id        String   @id @default(cuid())
+  expiresAt DateTime
+  token     String   @unique
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  ipAddress String?
+  userAgent String?
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("session")
+}
+
+model Account {
+  id                    String    @id @default(cuid())
+  accountId             String
+  providerId            String
+  userId                String
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("account")
+}
+
+model Verification {
+  id         String   @id @default(cuid())
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  @@index([identifier])
+  @@map("verification")
+}
+
+model DeviceCode {
+  id              String    @id @default(cuid())
+  deviceCode      String
+  userCode        String
+  userId          String?
+  expiresAt       DateTime
+  status          String
+  lastPolledAt    DateTime?
+  pollingInterval Int?
+  clientId        String?
+  scope           String?
+
+  @@map("deviceCode")
+}
+
+model Conversation {
+  id        String    @id @default(cuid())
+  userId    String
+  title     String
+  mode      String    @default("chat")
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  messages  Message[]
+
+  @@index([userId])
+  @@map("conversation")
+}
+
+model Message {
+  id             String       @id @default(cuid())
+  conversationId String
+  role           String
+  content        String
+  createdAt      DateTime     @default(now())
+  conversation   Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+
+  @@index([conversationId])
+  @@map("message")
+}

package/server/src/cli/ai/googleService.js

@@ -0,0 +1,107 @@
+import { google } from "@ai-sdk/google";
+import { streamText, generateObject } from "ai";
+import { config } from "../../config/googleConfig.js";
+import chalk from "chalk";
+
+export class AIService {
+  constructor() {
+    if (!config.googleApiKey) {
+      throw new Error("GOOGLE_GENERATIVE_AI_API_KEY is not set in env");
+    }
+
+    this.model = google(config.model, {
+      apiKey: config.googleApiKey,
+    });
+  }
+
+  async sendMessage(messages, onChunk, tools = undefined, onToolCall = null) {
+    try {
+      const streamConfig = {
+        model: this.model,
+        messages,
+        temperature: config.temperature,
+      };
+
+      if (tools && Object.keys(tools).length > 0) {
+        streamConfig.tools = tools;
+        streamConfig.maxSteps = 5;
+        console.log(
+          chalk.gray(`[DEBUG] Tools enabled: ${Object.keys(tools).join(", ")}`)
+        );
+      }
+
+      const result = await streamText(streamConfig);
+
+      let fullResponse = "";
+
+      for await (const chunk of result.textStream) {
+        fullResponse += chunk;
+        if (onChunk) onChunk(chunk);
+      }
+
+      const toolCalls = [];
+      const toolResults = [];
+
+      const steps = await Promise.resolve(result.steps);
+
+      if (Array.isArray(steps)) {
+        for (const step of steps) {
+          if (
+            step?.toolCalls &&
+            Array.isArray(step.toolCalls) &&
+            step.toolCalls.length > 0
+          ) {
+            for (const toolCall of step.toolCalls) {
+              toolCalls.push(toolCall);
+              if (onToolCall) onToolCall(toolCall);
+            }
+          }
+
+          if (
+            step?.toolResults &&
+            Array.isArray(step.toolResults) &&
+            step.toolResults.length > 0
+          ) {
+            toolResults.push(...step.toolResults);
+          }
+        }
+      }
+
+      return {
+        content: fullResponse,
+        finishReason: result.finishReason,
+        usage: result.usage,
+        toolCalls,
+        toolResults,
+        steps,
+      };
+    } catch (error) {
+      console.error(chalk.red("AI Service Error:"), error?.message || error);
+      throw error;
+    }
+  }
+
+  async getMessage(messages, tools = undefined) {
+    const result = await this.sendMessage(messages, null, tools);
+    return result.content;
+  }
+
+  async generateStructured(schema, prompt) {
+    try {
+      const result = await generateObject({
+        model: this.model,
+        schema,
+        prompt,
+      });
+
+      return result.object;
+    } catch (error) {
+      console.log(
+        chalk.red("AI Structured Generation Error:"),
+        error?.message || error
+      );
+      throw error;
+    }
+  }
+}
+

package/server/src/cli/chat/chat-with-ai-agent.js

@@ -0,0 +1,263 @@
+import chalk from "chalk";
+import boxen from "boxen";
+import { text, isCancel, cancel, intro, outro, confirm } from "@clack/prompts";
+import yoctoSpinner from "yocto-spinner";
+import { marked } from "marked";
+import { markedTerminal } from "marked-terminal";
+import { AIService } from "../ai/googleService.js";
+import { ChatService } from "../../service/chatService.js";
+import { getStoredToken } from "../../lib/token.js";
+import prisma from "../../lib/db.js";
+import { ensureDbConnection } from "../../lib/dbHealth.js";
+import { generateApplication } from "../../config/agentConfig.js";
+
+marked.use(markedTerminal());
+
+let aiService;
+const chatService = new ChatService();
+
+const getEnabledToolNames = () => {
+  return [];
+};
+
+const getUserFromToken = async () => {
+  const token = await getStoredToken();
+
+  if (!token?.access_token) {
+    throw new Error("Not authenticated. Please run 'orbital login' first.");
+  }
+
+  const dbOk = await ensureDbConnection();
+  if (!dbOk) {
+    throw new Error(
+      "Database unavailable. Fix DATABASE_URL/connectivity and try again."
+    );
+  }
+
+  const spinner = yoctoSpinner({ text: "Authenticating..." }).start();
+
+  const user = await prisma.user.findFirst({
+    where: {
+      sessions: {
+        some: { token: token.access_token },
+      },
+    },
+  });
+
+  if (!user) {
+    spinner.error("User not found");
+    throw new Error("User not found. Please login again");
+  }
+
+  spinner.success(`Welcome back, ${user.name}!`);
+  return user;
+};
+
+const initConversation = async (userId, conversationId = null, mode = "tool") => {
+  const spinner = yoctoSpinner({ text: "Loading conversation..." }).start();
+
+  const conversation = await chatService.getOrCreateConversation(
+    userId,
+    conversationId,
+    mode
+  );
+
+  spinner.success("Conversation Loaded");
+
+  const enabledToolNames = getEnabledToolNames();
+  const toolsDisplay =
+    enabledToolNames.length > 0
+      ? `\n${chalk.gray("Active Tools:")} ${enabledToolNames.join(", ")}`
+      : `\n${chalk.gray("No tools enabled")}`;
+
+  const conversationInfo = boxen(
+    `${chalk.bold("Conversation")}: ${conversation.title}\n${chalk.gray(
+      "ID: " + conversation.id
+    )}\n${chalk.gray("Mode: " + conversation.mode)}${toolsDisplay}\n${chalk.cyan(
+      "Working Directory: "
+    )}${process.cwd()}`,
+    {
+      padding: 1,
+      margin: { top: 1, bottom: 1 },
+      borderStyle: "round",
+      borderColor: "magenta",
+      title: "Agent Mode",
+      titleAlignment: "center",
+    }
+  );
+
+  console.log(conversationInfo);
+  return conversation;
+};
+
+const saveMessage = async (conversationId, role, content) => {
+  return await chatService.addMessage(conversationId, role, content);
+};
+
+const agentLoop = async (conversation) => {
+  const helpBox = boxen(
+    `${chalk.cyan.bold("What can the agent do?")}\n\n` +
+      `${chalk.gray("• Generate complete applications from descriptions")}\n` +
+      `${chalk.gray("• Create all necessary files and folders")}\n` +
+      `${chalk.gray("• Include setup instructions and commands")}\n` +
+      `${chalk.gray("• Generate production-ready code")}\n\n` +
+      `${chalk.yellow.bold("Examples:")}\n` +
+      `${chalk.white('• "Build a todo app with React and Tailwind"')}\n` +
+      `${chalk.white('• "Create a REST API with Express and MongoDB"')}\n` +
+      `${chalk.white('• "Make a weather app using OpenWeatherMap API"')}\n\n` +
+      `${chalk.gray("Type 'exit' to end the session")}`,
+    {
+      padding: 1,
+      margin: { bottom: 1 },
+      borderStyle: "round",
+      borderColor: "cyan",
+      title: "Agent Instructions",
+    }
+  );
+
+  console.log(helpBox);
+
+  while (true) {
+    const userInput = await text({
+      message: chalk.magenta("What would you like to build?"),
+      placeholder: "Describe your application...",
+      validate(value) {
+        if (!value || value.trim().length === 0) {
+          return "Description cannot be empty";
+        }
+        if (value.trim().length < 10) {
+          return "Please provide more details (at least 10 characters)";
+        }
+      },
+    });
+
+    if (isCancel(userInput)) {
+      console.log(chalk.yellow("\nAgent session cancelled\n"));
+      process.exit(0);
+    }
+
+    if (userInput.toLowerCase() === "exit") {
+      console.log(chalk.yellow("\nAgent session ended\n"));
+      break;
+    }
+
+    console.log(
+      boxen(chalk.white(userInput), {
+        padding: 1,
+        margin: { left: 2, top: 1, bottom: 1 },
+        borderStyle: "round",
+        borderColor: "blue",
+        title: "Your Request",
+        titleAlignment: "left",
+      })
+    );
+
+    await saveMessage(conversation.id, "user", userInput);
+
+    try {
+      const result = await generateApplication(
+        userInput,
+        aiService,
+        process.cwd()
+      );
+
+      if (!result || !result.success) {
+        throw new Error("Generation returned no result.");
+      }
+
+      const responseMessage =
+        `Generated application: ${result.folderName}\n` +
+        `Files created: ${result.files.length}\n` +
+        `Location: ${result.appDir}\n\n` +
+        `Setup commands:\n${result.commands.join("\n")}`;
+
+      console.log(
+        boxen(chalk.green(responseMessage), {
+          padding: 1,
+          margin: { top: 1, bottom: 1 },
+          borderStyle: "round",
+          borderColor: "green",
+          title: "Generation Complete",
+        })
+      );
+
+      await saveMessage(conversation.id, "assistant", responseMessage);
+
+      const continuePrompt = await confirm({
+        message: chalk.cyan("Would you like to generate another?"),
+        initialValue: false,
+      });
+
+      if (isCancel(continuePrompt) || !continuePrompt) {
+        console.log(chalk.yellow("\nGreat! Check your new application.\n"));
+        break;
+      }
+    } catch (error) {
+      console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+
+      await saveMessage(conversation.id, "assistant", `Error: ${error.message}`);
+
+      const retry = await confirm({
+        message: chalk.cyan("Would you like to try again?"),
+        initialValue: true,
+      });
+
+      if (isCancel(retry) || !retry) {
+        break;
+      }
+    }
+  }
+};
+
+export const startAgentChat = async (conversationId = null) => {
+  try {
+    if (!process.env.GOOGLE_GENERATIVE_AI_API_KEY) {
+      throw new Error(
+        "Gemini API key is not set. Run: orbital setkey <your-gemini-api-key>"
+      );
+    }
+
+    aiService = new AIService();
+
+    intro(
+      boxen(
+        chalk.bold.magenta("Orbital AI - Agent Mode\n\n") +
+          chalk.gray("Autonomous Application Generator"),
+        {
+          padding: 1,
+          borderStyle: "double",
+          borderColor: "magenta",
+        }
+      )
+    );
+
+    const user = await getUserFromToken();
+
+    const shouldContinue = await confirm({
+      message: chalk.yellow(
+        "The agent will create files and folders in the current directory. Continue?"
+      ),
+      initialValue: true,
+    });
+
+    if (isCancel(shouldContinue) || !shouldContinue) {
+      cancel(chalk.yellow("Agent mode cancelled"));
+      process.exit(0);
+    }
+
+    const conversation = await initConversation(user.id, conversationId);
+    await agentLoop(conversation);
+
+    outro(chalk.green.bold("\nThanks for using Agent Mode!"));
+  } catch (error) {
+    console.log(
+      boxen(chalk.red(`Error: ${error.message}`), {
+        padding: 1,
+        margin: 1,
+        borderStyle: "round",
+        borderColor: "red",
+      })
+    );
+    process.exit(1);
+  }
+};