🚀 Phantom CLI - AI-Powered Monolithic Application

A full-stack Next.js application featuring AI-powered chat, secure authentication, device flow authorization, and a powerful CLI tool - all in one monolithic architecture.

✨ Features

🤖 AI-Powered Chat

Gemini AI Integration: Intelligent conversations powered by Google's Gemini AI
Multi-Model Support: Choose from different AI models for your use case
Conversation History: Persistent chat history with database storage
Tool Calling & Agent Mode: Advanced AI capabilities with autonomous agents

🔐 Authentication & Authorization

Secure Auth: Built with Better Auth for robust authentication
Multiple Auth Methods: Email/password, OAuth providers support
Device Flow: OAuth2 device flow for CLI authentication
Session Management: Secure session handling with token-based auth

🔑 API Key Management

BYOK (Bring Your Own Key): Users can use their own Gemini API keys
Secure Storage: Encrypted API key storage in PostgreSQL
Easy Management: Web UI and CLI for key management

💻 Command Line Interface

Interactive CLI: Beautiful terminal UI with @clack/prompts
Device Authentication: Seamless login flow from the terminal
AI Chat in Terminal: Chat with AI directly from your command line
Tool Management: Manage API keys, auth, and more via CLI

🎨 Modern UI/UX

shadcn/ui Components: Beautiful, accessible UI components
Responsive Design: Works seamlessly on desktop and mobile
Dark Mode: Eye-friendly dark theme
Real-time Updates: Instant feedback with React Query

🛠️ Tech Stack

Frontend

Next.js 15 - React framework with App Router
TypeScript - Type-safe development
Tailwind CSS - Utility-first styling
shadcn/ui - High-quality UI components
React Query - Server state management

Backend

Next.js API Routes - Serverless API endpoints
Prisma ORM - Type-safe database access
PostgreSQL - Robust relational database
Better Auth - Authentication & session management

AI & Tools

Vercel AI SDK - AI/LLM integration framework
Google Gemini - Advanced AI models
Tool Calling - Function calling capabilities

CLI

Commander.js - CLI framework
@clack/prompts - Beautiful CLI prompts
Chalk & Boxen - Terminal styling

📦 Installation

Prerequisites

Node.js 18+
pnpm (recommended) or npm
PostgreSQL database

1. Clone the repository

git clone https://github.com/AJAmit17/Phantom-cli.git
cd Phantom-cli

2. Install dependencies

pnpm install

3. Set up environment variables

Create a .env file in the root directory:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/Phantom"

# Authentication
BETTER_AUTH_SECRET="your-secret-key-here"
BETTER_AUTH_URL="http://localhost:3000"

# AI (Optional - users can provide their own)
GEMINI_API_KEY="your-gemini-api-key"

# App
NEXT_PUBLIC_APP_URL="http://localhost:3000"

4. Set up the database

# Generate Prisma Client
pnpm prisma generate

# Run migrations
pnpm prisma migrate dev

# (Optional) Open Prisma Studio to view data
pnpm prisma studio

5. Run the development server

pnpm dev

Open http://localhost:3000 to see the application.

🖥️ CLI Usage

Installation

The CLI is included in the monorepo. Use it directly:

# Show all commands
pnpm cli --help

# Or install globally (from cli directory)
cd cli
npm link
phantom --help

Authentication

# Login with device flow
pnpm cli login

# Check current user
pnpm cli whoami

# Logout
pnpm cli logout

API Key Management

# Set your Gemini API key
pnpm cli api-key set

# View your API key
pnpm cli api-key get

# Remove your API key
pnpm cli api-key remove

AI Chat

# Start an AI chat session
pnpm cli ai chat

# Chat with tool calling enabled
pnpm cli ai chat --tools

# Use autonomous agent mode
pnpm cli ai agent

For detailed CLI documentation, see CLI_USAGE.md.

📁 Project Structure

├── app/                      # Next.js App Router
│   ├── (auth)/              # Authentication routes
│   │   ├── sign-in/
│   │   └── sign-up/
│   ├── api/                 # API routes
│   │   ├── auth/           # Auth endpoints
│   │   ├── chat/           # AI chat endpoints
│   │   ├── conversations/  # Conversation management
│   │   └── api-keys/       # API key management
│   ├── chat/               # Chat interface
│   ├── dashboard/          # User dashboard
│   └── device/             # Device authorization flow
├── cli/                     # CLI application
│   ├── commands/           # CLI commands
│   ├── chat/              # CLI chat implementations
│   └── utils/             # CLI utilities
├── components/             # React components
│   └── ui/                # shadcn/ui components
├── lib/                   # Shared libraries
│   ├── auth.ts           # Auth configuration
│   ├── prisma.ts         # Prisma client
│   ├── ai-service.ts     # AI service integration
│   └── chat-service.ts   # Chat management
├── prisma/               # Database schema & migrations
└── hooks/                # Custom React hooks

🚀 Available Scripts

# Development
pnpm dev              # Start dev server
pnpm build            # Build for production
pnpm start            # Start production server
pnpm lint             # Run ESLint

# Database
pnpm prisma generate  # Generate Prisma Client
pnpm prisma migrate dev # Run migrations
pnpm prisma studio    # Open Prisma Studio

# CLI
pnpm cli              # Run CLI commands

🔒 Security Features

Encrypted API Keys: User API keys are securely stored with encryption
Session Management: Secure token-based sessions with expiration
CORS Protection: Proper CORS configuration for API routes
Input Validation: Request validation and sanitization
Rate Limiting: Built-in rate limiting for API endpoints

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

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

🙏 Acknowledgments

Next.js - The React Framework
Vercel AI SDK - AI/LLM integration
shadcn/ui - UI components
Better Auth - Authentication
Prisma - Database ORM
Google Gemini - AI models

📧 Support

For support, email your-email@example.com or open an issue on GitHub.

🔗 Links

Documentation: CLI_USAGE.md
Report Bug: GitHub Issues
Request Feature: GitHub Issues

Made with ❤️ by Amit

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
app		app
cli		cli
components		components
hooks		hooks
lib		lib
prisma		prisma
public		public
.gitignore		.gitignore
CLI_USAGE.md		CLI_USAGE.md
README.md		README.md
components.json		components.json
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

AJAmit17/Phantom-cli

Folders and files

Latest commit

History

Repository files navigation