> ## Documentation Index
> Fetch the complete documentation index at: https://nikcli.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> NikCLI - Advanced AI-Powered Development Assistant with Cognitive Orchestration

# NikCLI - Advanced AI Development Assistant

**Transform your development workflow with intelligent AI agents that understand your code, execute commands, and build applications autonomously through cognitive orchestration.**

<CardGroup cols={2}>
  <Card title="🤖 Universal Agent" icon="robot">
    **35+ Capabilities** - Single comprehensive agent handling all development tasks through cognitive orchestration
  </Card>

  <Card title="🔒 VM Agent" icon="container">
    **Secure Development** - Isolated virtualized agent with 20 specialized capabilities for safe development
  </Card>

  <Card title="⚡ Cognitive Orchestration" icon="brain">
    **Intelligent Planning** - Advanced NLP-based task understanding and adaptive execution strategies
  </Card>

  <Card title="🛠️ 70+ Commands" icon="terminal">
    **Complete Toolset** - File operations, terminal integration, project management, and more
  </Card>
</CardGroup>

## What is NikCLI?

NikCLI is a **next-generation AI-powered development assistant** that combines the power of artificial intelligence with practical development tools. Unlike traditional CLI tools, NikCLI features **cognitive orchestration** - an advanced system that understands natural language tasks, breaks them down intelligently, and executes them using the most appropriate strategies.

### Core Philosophy

<Steps>
  <Step title="Cognitive Understanding">
    NikCLI uses advanced NLP to understand your intent, extract entities, and assess task complexity
  </Step>

  <Step title="Intelligent Planning">
    Creates orchestration plans with optimal strategies (sequential, parallel, hybrid, adaptive)
  </Step>

  <Step title="Adaptive Execution">
    Executes tasks with real-time supervision and automatic fallback strategies
  </Step>

  <Step title="Continuous Learning">
    Learns from each interaction to improve future task execution and planning
  </Step>
</Steps>

## Key Features

### 🧠 **AI-Powered Development**

NikCLI's Universal Agent provides intelligent development assistance:

* **Natural language understanding** for task interpretation
* **Context-aware responses** based on your project structure
* **Multi-provider AI support** (Claude, GPT, Gemini, Ollama)
* **Intelligent code generation** and analysis

```bash theme={null}
# Example: AI-powered development
/agent universal-agent "Create a React authentication component with TypeScript and Jest tests"

# NikCLI will:
# - Analyze your project structure
# - Generate appropriate code
# - Provide context-aware suggestions
# - Handle file operations safely
```

### 🤖 **Dual Agent Architecture**

<AccordionGroup>
  <Accordion title="Universal Agent - The Cognitive Powerhouse">
    **35 Development Capabilities:**

    * **Core Development** (7): Code generation, analysis, review, optimization, debugging, refactoring, testing
    * **Frontend Technologies** (11): React, Next.js, TypeScript, JavaScript, HTML, CSS, components, hooks, JSX, TSX
    * **Backend Development** (8): Node.js, API development, databases, server architecture, REST, GraphQL, microservices
    * **DevOps & Infrastructure** (8): CI/CD, Docker, Kubernetes, deployment, infrastructure, monitoring, security
    * **Analysis & Documentation** (5): Performance analysis, security analysis, quality assessment, architecture review, documentation generation

    **Key Features:**

    * Handles up to 3 concurrent tasks
    * AI-powered task execution
    * Context-aware development assistance
    * Multi-provider AI support
  </Accordion>

  <Accordion title="VM Agent - Virtualized Development">
    **VM Management Capabilities:**

    * **Container Operations**: Create, manage, and control Docker containers
    * **Repository Management**: Clone, analyze, and work with Git repositories
    * **Development Environment**: Set up isolated development environments
    * **Pull Request Automation**: Create and manage pull requests from VM containers

    **Key Features:**

    * Isolated development environments
    * Docker container management
    * Git repository integration
    * Secure development workflows
  </Accordion>
</AccordionGroup>

### 🎯 **AI-Powered Task Execution**

NikCLI provides intelligent development assistance:

<Tabs>
  <Tab title="Task Understanding">
    ```bash theme={null}
    # NikCLI understands your development needs
    /agent universal-agent "Create a complete e-commerce platform"

    # The agent will:
    # - Analyze your project structure
    # - Generate appropriate code
    # - Provide step-by-step guidance
    # - Handle file operations safely
    ```
  </Tab>

  <Tab title="Code Generation">
    ```bash theme={null}
    # Generate code with context awareness
    /agent universal-agent "Create a React component with TypeScript"

    # NikCLI will:
    # - Follow your project's patterns
    # - Use appropriate dependencies
    # - Generate production-ready code
    # - Include proper error handling
    ```
  </Tab>

  <Tab title="Project Management">
    ```bash theme={null}
    # Manage complex development tasks
    /plan "Build authentication system"

    # Creates structured plan:
    # - Breaks down into manageable tasks
    # - Tracks progress
    # - Provides guidance
    # - Manages dependencies
    ```
  </Tab>
</Tabs>

### 🛠️ **Comprehensive Command System**

**80+ Commands** organized into logical categories:

<CardGroup cols={3}>
  <Card title="File Operations" icon="folder">
    `/read`, `/write`, `/edit`, `/ls`, `/search`, `/grep`
  </Card>

  <Card title="Terminal Commands" icon="terminal">
    `/run`, `/sh`, `/bash`, `/install`, `/npm`, `/yarn`, `/git`, `/docker`, `/ps`, `/kill`
  </Card>

  <Card title="Project Management" icon="hammer">
    `/build`, `/test`, `/lint`, `/create`
  </Card>

  <Card title="AI Model Commands" icon="brain">
    `/models`, `/model`, `/temp`, `/set-key`
  </Card>

  <Card title="Agent Management" icon="users">
    `/agents`, `/agent`, `/factory`, `/create-agent`, `/launch-agent`, `/blueprints`, `/context`, `/stream`
  </Card>

  <Card title="Planning & Todos" icon="clipboard-list">
    `/plan`, `/todo`, `/todos`, `/approval`, `/plan-clean`, `/todo-hide`, `/todo-show`
  </Card>

  <Card title="VM Operations" icon="server">
    `/vm`, `/vm-create`, `/vm-list`, `/vm-connect`, `/vm-stop`, `/vm-remove`, `/vm-create-pr`, `/vm-logs`
  </Card>

  <Card title="AI Features" icon="magic">
    `/analyze-image`, `/vision`, `/generate-image`, `/create-image`, `/images`
  </Card>

  <Card title="Memory & Data" icon="database">
    `/remember`, `/recall`, `/memory`, `/forget`, `/snapshot`, `/snap`, `/restore`, `/snapshots`
  </Card>
</CardGroup>

### 🔄 **Operating Modes**

NikCLI supports different operating modes:

<AccordionGroup>
  <Accordion title="💬 Default Chat Mode">
    **Interactive Conversation Mode**

    * Manual confirmation for operations
    * Step-by-step guidance
    * Best for learning and experimentation
    * Full transparency in operations

    ```bash theme={null}
    # Example: Interactive file creation
    /write src/components/Button.tsx
    # → Shows preview and asks for confirmation
    # → Explains what will be created
    # → Waits for user approval
    ```
  </Accordion>

  <Accordion title="📋 Planning Mode">
    **Strategic Planning Mode**

    * Comprehensive execution plans
    * Todo.md file generation
    * Approval workflows
    * Best for complex projects

    ```bash theme={null}
    # Example: Project planning
    /plan "Build authentication system"
    # → Creates detailed execution plan
    # → Generates todo.md with phases
    # → Sets up approval workflow
    ```
  </Accordion>

  <Accordion title="🤖 Auto Mode">
    **Autonomous Execution Mode**

    * Automatic task execution
    * Minimal user intervention
    * Streamlined workflows
    * Best for rapid development

    ```bash theme={null}
    # Example: Autonomous development
    /auto "Create React component with tests"
    # → Analyzes requirements
    # → Creates component automatically
    # → Adds tests and documentation
    # → Reports completion
    ```
  </Accordion>
</AccordionGroup>

### 🔒 **Security & Safety**

<CardGroup cols={2}>
  <Card title="Approval System" icon="shield">
    Interactive confirmation for sensitive operations with diff previews
  </Card>

  <Card title="Sandbox Mode" icon="lock">
    Restricted execution environment with configurable permissions
  </Card>

  <Card title="VM Isolation" icon="container">
    Secure virtualized development with Docker containerization
  </Card>

  <Card title="API Key Security" icon="key">
    Encrypted storage with AES-256-GCM and zero-exposure proxy
  </Card>
</CardGroup>

### 📊 **Performance & Monitoring**

* **Real-time Progress Tracking**: Live updates during task execution
* **Performance Metrics**: Success rates, execution times, resource usage
* **Learning Database**: Pattern recognition and optimization
* **Memory Management**: Efficient context retention and cleanup
* **Caching System**: Redis integration for optimal performance

## Why Choose NikCLI?

<CardGroup cols={2}>
  <Card title="🚀 Productivity" icon="zap">
    **10x faster development** with intelligent automation and cognitive orchestration
  </Card>

  <Card title="🎯 Accuracy" icon="target">
    **90%+ task understanding** with advanced NLP and entity extraction
  </Card>

  <Card title="🔧 Flexibility" icon="settings">
    **Adaptive execution** that learns and improves from each interaction
  </Card>

  <Card title="🛡️ Security" icon="shield-check">
    **Enterprise-grade security** with approval systems and sandbox isolation
  </Card>
</CardGroup>

## Real-World Examples

### Complete Project Creation

```bash theme={null}
# Create a full-stack application
/agent universal-agent "Build a complete blog platform with React frontend, Node.js API, PostgreSQL database, authentication, and admin panel"

# NikCLI will:
# 1. Analyze requirements and create orchestration plan
# 2. Set up project structure with best practices
# 3. Implement backend API with authentication
# 4. Create React frontend with responsive design
# 5. Set up database with proper relationships
# 6. Add comprehensive testing suite
# 7. Configure deployment and CI/CD
# 8. Generate complete documentation
```

### Code Analysis & Optimization

```bash theme={null}
# Analyze and optimize existing codebase
/agent universal-agent "Analyze this React codebase for performance issues and security vulnerabilities, then optimize and fix any problems found"

# NikCLI will:
# 1. Scan entire codebase for issues
# 2. Identify performance bottlenecks
# 3. Check for security vulnerabilities
# 4. Apply optimizations automatically
# 5. Fix security issues
# 6. Generate detailed report
# 7. Update documentation
```

### DevOps Automation

```bash theme={null}
# Set up complete DevOps pipeline
/agent universal-agent "Create a complete CI/CD pipeline with Docker, Kubernetes, monitoring, and automated testing for this Node.js application"

# NikCLI will:
# 1. Create Docker configuration
# 2. Set up Kubernetes manifests
# 3. Configure GitHub Actions/GitLab CI
# 4. Add monitoring and logging
# 5. Set up automated testing
# 6. Configure deployment strategies
# 7. Add security scanning
```

## Getting Started

Ready to transform your development workflow? Here's how to get started:

<Steps>
  <Step title="Install NikCLI">
    ```bash theme={null}
    # Universal installer (auto-detects package manager)
    curl -fsSL https://raw.githubusercontent.com/nikomatt69/nikcli-main/main/installer/install.sh | bash

    # Or install with your preferred package manager
    npm install -g @nicomatt69/nikcli
    ```
  </Step>

  <Step title="Configure API Keys">
    ```bash theme={null}
    nikcli
    /set-key anthropic sk-ant-api03-...
    /set-key openai sk-...
    ```
  </Step>

  <Step title="Start Your First Task">
    ```bash theme={null}
    /agent universal-agent "Create a simple React component with TypeScript"
    ```
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start Guide" icon="play" href="/quickstart/installation">
    Get up and running in minutes
  </Card>

  <Card title="Command Reference" icon="terminal" href="/cli-reference/commands-overview">
    Master all 70+ commands
  </Card>

  <Card title="Agent System" icon="robot" href="/agent-system/architecture">
    Deep dive into cognitive orchestration
  </Card>

  <Card title="Examples & Tutorials" icon="book" href="/examples/basic-workflows">
    Learn through practical examples
  </Card>
</CardGroup>

<Tip>
  NikCLI is designed to be your **intelligent development partner**. Start with simple tasks and gradually explore more complex workflows as you become familiar with its capabilities.
</Tip>