Titan CLI

An AI Agent CLI with AI Chat, Web Search, Tool Calling & Dedicated Agent Mode

📋 Table of Contents

1. 🤖 Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start

🤖 Introduction

Introducing TitanCLI, the ultimate AI agent CLI designed to supercharge your productivity with unmatched intelligence and versatility. Whether you're engaging in seamless chat conversations, leveraging powerful integrated tools, or activating autonomous agent mode for complex tasks, TitanCLI is your command-center companion built for the future. Built for developers and tech enthusiasts alike, it combines cutting-edge AI capabilities with a sleek, intuitive interface to bring your ideas to life faster and smarter than ever before. Step into the future of AI-driven command line power with TitanCLI.

⚙️ Tech Stack

• Next.js
• Commander.js
• Prisma
• Node.js
• PostgreSQL (Neon DB)
• Google Gemini

🔋 Features

👉 Natural Language Chat: Engage in intuitive conversation with the AI agent for quick commands, explanations, and assistance.

👉 Multi-Modal Input: Accept not only text but also images, sketches, and web content for enhanced context and code generation.

👉 Code Understanding & Generation: Query, generate, refactor, and debug code across large codebases with natural language prompts.

👉 Autonomous Agent Mode: Activate multi-step, autonomous workflows for complex tasks with dynamic planning and error recovery.

👉 Tool Integration: Built-in support for a variety of specialized tools and protocols to extend capabilities seamlessly.

👉 Real-Time Context Awareness: Ground prompts with real-time web search or project-specific context files to stay updated.

👉 Custom Commands: Create reusable custom commands for your specific workflows and preferences.

👉 Multi-Agent Orchestration: Coordinate multiple specialized agents for large projects with task delegation and parallel execution.

👉 Advanced Search: Use fuzzy, neural code, and full-text search to find relevant code snippets or documentation.

🤸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

git clone https://github.com/itzzSVR-tech/TitanCLI.git
cd TitanCLI

Installation

Install the project dependencies using npm in both the client and server folders:

npm install

Set Up Environment Variables

Create a new file named

.env

in the server folder of your project and add the following content:

PORT=<your port number>
DATABASE_URL=<your database URL>

# Better Auth
BETTER_AUTH_SECRET=<your secret>
BETTER_AUTH_URL=http://localhost:3005

# Github OAuth
GITHUB_CLIENT_ID=<your client ID>
GITHUB_CLIENT_SECRET=<your client secret>

# Google Gemini
GOOGLE_GENERATIVE_AI_API_KEY=<your API key>
TITANAI_MODEL=<your prefered model>

Replace the placeholder values with your actual credentials.

Running the Project

Run the Following command in the server folder (

Side Note

: Run this command in the Git Bash):

chmod +x ./src/cli/main.js

Then in the client folder:

npm run dev

Open

http://localhost:{PORT}

in your browser to view the project.

Also in the server folder:

npm run dev

Then run

<your_command> login

This will open a browser window to authenticate you with GitHub.