terminal
Initializing System0%
NEURAL NETWORKSFULL-STACK ARCHITECTURESYSTEM DESIGNQUANTUM COMPUTINGAI SYSTEMS
arrow_backBack to all projects
CLI Tool

VITAL — AI Terminal Coding Assistant

A multi-provider AI-powered terminal coding assistant built for developers. Debug, refactor, generate tests, and build entire projects — all from the command line.

PythonGroqOpenAIGeminiCLIRich

The Challenge

Developers constantly context-switch between their IDE, browser, and documentation while coding. Existing AI tools require leaving the terminal, breaking flow. There's no lightweight, terminal-native AI assistant that understands your project context and works across multiple AI providers.

The Solution

Built VITAL, a terminal-native AI coding assistant. It runs entirely in the CLI with rich formatting, supports 20+ commands (/debug, /refactor, /test, /doc, /commit), and includes an Agent Mode that can autonomously plan and scaffold entire projects. A memory system (VITAL.md) gives the AI persistent context about project preferences.

Key Architecture

CLI Interface (Rich/Prompt Toolkit) → Command Router → Provider Abstraction Layer (Groq/OpenAI/Gemini) → File System Tools → Agent Mode (Plan → Build → Review) → Memory Manager (VITAL.md)

Code Highlight


# VITAL Agent Mode — autonomous project builder
class AgentMode:
    def __init__(self, provider: AIProvider):
        self.provider = provider
        self.planner = ProjectPlanner(provider)
    
    async def build(self, description: str):
        # Step 1: Generate project plan
        plan = await self.planner.create_plan(description)
        display_plan(plan)  # Show file table to user
        
        # Step 2: Get user approval
        choice = prompt("[B] Build it!  [C] Cancel  [E] Edit plan first")
        
        if choice == "B":
            for file in plan.files:
                content = await self.provider.generate_file(
                    file, plan.context
                )
                write_file(file.path, content)
                console.print(f"[green]✓[/] Created {file.path}")
        

Key Outcomes

  • check_circle20+ built-in commands for debugging, refactoring, docs, and testing
  • check_circleAgent Mode autonomously plans and builds entire project scaffolds
  • check_circleMulti-provider architecture supporting Groq, OpenAI, Gemini, and more