Vigthoria CLI

AI-powered terminal coding assistant for Vigthoria Coder subscribers.

AI-powered terminal coding assistant integrated with Vigthoria's AI models and subscription system.

╔═══════════════════════════════════════════════════════════╗
║                                                           ║
║   VIGTHORIA CLI - AI-Powered Coding Assistant             ║
║                                                           ║
╚═══════════════════════════════════════════════════════════╝

Features

• 🤖 Interactive Chat - Natural language coding assistance
• ✏️ File Editing - AI-powered code modifications with diff preview
• 🔧 Code Generation - Generate code from descriptions
• 📖 Code Explanation - Understand complex code
• 🐛 Bug Fixing - Automatic issue detection and fixing
• 📊 Code Review - Quality analysis and suggestions
• 🔐 Secure Auth - Integration with Vigthoria accounts
• 📦 Project Context - Understands your codebase
• 🗂️ Vigthoria Repo - Push/Pull projects to your personal cloud repository

Installation

Quick Install (Recommended)

Quick Install (Linux/macOS)

curl -fsSL https://cli.vigthoria.io/install.sh | bash

Quick Install (Windows PowerShell)

irm https://cli.vigthoria.io/install.ps1 | iex

npm Install (All Platforms)

npm install -g vigthoria-cli

Manual Install

# Clone from Vigthoria Market
git clone https://market.vigthoria.io/vigthoria/vigthoria-cli.git
cd vigthoria-cli

# Or from Vigthoria Community
git clone https://community.vigthoria.io/repos/vigthoria-cli.git
cd vigthoria-cli

# Install dependencies
npm install

# Build
npm run build

# Link globally
npm link

Troubleshooting Installation

Network Issues (npm ENOTFOUND)

If you see ENOTFOUND registry.npmjs.org, try these solutions:

1. Check internet connection:

   ping registry.npmjs.org

2. If behind a corporate proxy:

   npm config set proxy http://proxy.company.com:8080
   npm config set https-proxy http://proxy.company.com:8080

3. Try an alternative npm registry:

   npm config set registry https://registry.npmmirror.com
   npm install -g vigthoria-cli
   # Reset to default after:
   npm config delete registry

4. Direct tarball download:

   # Download directly
   npm install -g https://registry.npmjs.org/vigthoria-cli/-/vigthoria-cli-1.4.1.tgz

5. Use Git clone method (no npm registry needed):

   git clone https://market.vigthoria.io/vigthoria/vigthoria-cli.git
   cd vigthoria-cli && npm install && npm run build && npm link

Windows-Specific Issues

PowerShell Execution Policy:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

PATH not updated: Open a new terminal after installation.

Permissions: Run PowerShell as Administrator if you get access denied errors.

Quick Start

1. Login

vigthoria login

Options:

• Email & Password
• API Token
• Browser OAuth

2. Start Chatting

vigthoria chat
# or
vig c

3. Edit Files

vigthoria edit src/index.ts
# or
vig e src/index.ts

Commands

Chat Mode

vigthoria chat [options]

Options:
  -m, --model <model>   Select AI model (fast, mini, code, creative, pro, ultra)
  -p, --project <path>  Set project context path

In chat mode, you can use these special commands:

• /file <path> - Add file to context
• /edit <path> - Switch to edit mode
• /diff - Show pending changes
• /apply - Apply pending changes
• /model <name> - Switch AI model
• /clear - Clear conversation
• /help - Show commands
• /exit - Exit chat

Edit File

vigthoria edit <file> [options]

Options:
  -i, --instruction <text>  Editing instruction
  -m, --model <model>       Select AI model

Example:

vigthoria edit src/api.ts -i "Add error handling to all endpoints"

Generate Code

vigthoria generate <description> [options]

Options:
  -l, --language <lang>  Target language (default: typescript)
  -o, --output <file>    Output file path
  -m, --model <model>    Select AI model

Example:

vigthoria generate "REST API endpoint for user authentication" -l typescript -o src/auth.ts

Explain Code

vigthoria explain <file> [options]

Options:
  -l, --lines <range>     Line range (e.g., 1-50)
  -d, --detail <level>    Detail level (brief, normal, detailed)

Example:

vigthoria explain src/complex.ts -l 50-100 -d detailed

Fix Code

vigthoria fix <file> [options]

Options:
  -t, --type <type>  Fix type (bugs, style, security, performance)
  --apply            Auto-apply fixes

Example:

vigthoria fix src/index.ts -t security --apply

Code Review

vigthoria review <file> [options]

Options:
  -f, --format <format>  Output format (text, json, markdown)

Example:

vigthoria review src/app.ts -f markdown > review.md

Configuration

# Interactive configuration
vigthoria config

# Set value
vigthoria config --set model=vigthoria-code

# Get value
vigthoria config --get model

# List all settings
vigthoria config --list

# Reset to defaults
vigthoria config --reset

Initialize Project

vigthoria init

Creates a .vigthoria.json file with project-specific settings.

Vigthoria Repository (Cloud Storage)

Push and pull your projects to/from your personal Vigthoria Repository - your cloud workspace for projects.

Push a Project

# Push current directory to Vigthoria Repo
vigthoria repo push

# Push specific path
vigthoria repo push /path/to/project

# Push with visibility setting
vigthoria repo push --visibility private
vigthoria repo push --visibility public
vigthoria repo push --visibility restricted

# Force overwrite existing project
vigthoria repo push --force

Pull a Project

# Pull a project from your repo
vigthoria repo pull my-project

# Pull to specific output directory
vigthoria repo pull my-project --output /path/to/destination

# Overwrite existing directory
vigthoria repo pull my-project --force

List Projects

# List all your projects
vigthoria repo list
# or
vigthoria repo ls

# Filter by visibility
vigthoria repo list --visibility private

Check Sync Status

# Check if current project is synced
vigthoria repo status

Share a Project

# Generate shareable link (default 7 days)
vigthoria repo share my-project

# Custom expiration
vigthoria repo share my-project --expires 24h
vigthoria repo share my-project --expires 30d

Delete a Project

# Remove from Vigthoria Repo (local files unaffected)
vigthoria repo delete my-project
# or
vigthoria repo rm my-project

Clone a Public Project

# Clone from preview URL or project ID
vigthoria repo clone https://coder.vigthoria.io/preview/123
vigthoria repo clone 123

Available Models

Vigthoria Native Models

| Short Name | Full Model ID | Size | Best For | |------------|---------------|------|----------| | fast | vigthoria-fast-1.7b | 1.7B | Quick responses, simple tasks | | mini | vigthoria-mini-0.6b | 0.6B | Ultra-lightweight, edge devices | | balanced | vigthoria-balanced-4b | 4B | All-purpose tasks | | code / code-v2 | vigthoria-v2-code-8b | 8B | Code generation & editing | | code-v3-8b | vigthoria-v3-code-8b | 8B | Next-gen coding (future) | | code-v3-32b / code-32b | vigthoria-v3-code-32b | 32B | Large-scale code projects | | creative-v4 | vigthoria-creative-9b-v4 | 9B | Creative writing, storytelling | | creative-v3 | vigthoria-creative-9b-v3 | 9B | Legacy creative model | | music | vigthoria-music-master-4b | 4B | Music AI generation |

External Models (Ollama Fallback)

| Short Name | Model | Best For | |------------|-------|----------| | qwen-coder | qwen2.5-coder:7b | Alternative coding | | qwen-coder-32b | qwen2.5-coder:32b | Large coding tasks | | deepseek | deepseek-coder-v2 | DeepSeek coding | | deepseek-r1 | deepseek-r1:8b | Reasoning tasks | | llama3 | llama3:8b-instruct | General purpose |

Using Specific Models

# Use short name
vigthoria chat -m code-v2

# Use full model ID directly
vigthoria chat -m vigthoria-v3-code-32b

# Force specific version
vigthoria chat -m vigthoria-v2-code-8b

# Use future models when available
vigthoria chat -m code-v4

Configuration File

Global Config

Located at ~/.config/vigthoria-cli/config.json:

{
  "apiUrl": "https://api.vigthoria.io",
  "preferences": {
    "defaultModel": "vigthoria-code",
    "theme": "dark",
    "autoApplyFixes": false,
    "showDiffs": true,
    "maxTokens": 4096
  },
  "project": {
    "ignorePatterns": [
      "node_modules",
      ".git",
      "dist"
    ]
  }
}

Project Config

Create .vigthoria.json in your project root:

{
  "defaultModel": "vigthoria-code",
  "ignorePatterns": ["build", "coverage"],
  "autoApplyFixes": false
}

Shortcuts

For faster access, use the vig command:

vig c          # vigthoria chat
vig e <file>   # vigthoria edit
vig g <desc>   # vigthoria generate
vig x <file>   # vigthoria explain
vig f <file>   # vigthoria fix
vig r <file>   # vigthoria review

Shell Completion

Bash

source ~/.bash_completion.d/vigthoria

Zsh

Add to ~/.zshrc:

fpath=(~/.zsh/completion $fpath)
autoload -Uz compinit && compinit

Environment Variables

# Custom API endpoint
export VIGTHORIA_API_URL="https://custom.api.vigthoria.io"

# Default model
export VIGTHORIA_DEFAULT_MODEL="vigthoria-code"

# API token (alternative to login)
export VIGTHORIA_TOKEN="your-api-token"

Examples

Working with Drupal Sites

The CLI automatically detects Drupal 8/9/10/11 projects and provides contextual assistance.

Setting Up a New Drupal Site

# Navigate to your Drupal project root (where composer.json or web/ folder is)
cd /path/to/drupal-project

# Start agent mode for autonomous assistance
vigthoria agent

# Ask Vigthoria to help with setup
you › Help me configure this Drupal site for local development

you › Create a custom module called "my_custom_feature" with a block plugin

you › Add a custom content type with these fields: title, body, featured_image, category

Scanning an Existing Drupal Site

# Navigate to Drupal root
cd /var/www/my-drupal-site

# Start chat with agent mode enabled
vigthoria chat --agent

# Scan and analyze the site
you › Scan this Drupal site and give me an overview of:
- Drupal version
- Installed modules
- Custom modules
- Active theme
- Any potential issues or outdated code

you › /file web/sites/default/settings.php

you › Check this site's database configuration and suggest security improvements

Common Drupal Tasks

# Generate Drupal code
vigthoria generate "Drupal 10 custom block plugin with configuration form" -l php -o web/modules/custom/my_module/src/Plugin/Block/MyBlock.php

# Review a Drupal module
vigthoria review web/modules/custom/my_module/my_module.module

# Fix Drupal coding standards
vigthoria fix web/modules/custom/my_module/*.php -t style --apply

# Explain complex Drupal code
vigthoria explain web/core/lib/Drupal/Core/Entity/EntityBase.php -d detailed

Drupal Agent Mode Commands

In agent mode, you can ask Vigthoria to:

you › Read my module's .info.yml and check dependencies

you › Search for all hook_form_alter implementations in custom modules

you › Create a migration YAML for importing content from a CSV

you › Update my module for Drupal 10 compatibility

you › Generate a Drush command to clear specific caches

Interactive Coding Session

$ vigthoria chat

╔═══════════════════════════════════════════════════════════╗
║   VIGTHORIA CLI - AI-Powered Coding Assistant             ║
╚═══════════════════════════════════════════════════════════╝

you › /file src/api.ts
✓ Added src/api.ts to context (150 lines)

you › Add rate limiting to the authentication endpoint

vigthoria ›
I'll add rate limiting using express-rate-limit. Here's the implementation:

```typescript
import rateLimit from 'express-rate-limit';

const authLimiter = rateLimit({
  windowMs: 15 * 60 * 1000, // 15 minutes
  max: 5, // 5 attempts
  message: 'Too many login attempts, please try again later'
});

app.post('/auth/login', authLimiter, authController.login);

you › /edit src/api.ts What changes would you like to make?

Add the rate limiting code you showed

[Diff preview shown] Apply changes? (Y/n) y ✓ Changes applied to src/api.ts

### Batch Code Review

```bash
# Review all TypeScript files
for file in src/**/*.ts; do
  vigthoria review "$file" -f markdown >> review-report.md
done

Git Pre-commit Hook

#!/bin/bash
# .git/hooks/pre-commit

changed_files=$(git diff --cached --name-only --diff-filter=ACM | grep '\.ts$')

for file in $changed_files; do
  vigthoria fix "$file" -t style --apply
done

Troubleshooting

"Not authenticated" Error

vigthoria login
# or
export VIGTHORIA_TOKEN="your-token"

"Subscription expired" Warning

Your Vigthoria Coder subscription has expired. Visit https://coder.vigthoria.io to renew.

Connection Issues

# Check API status
vigthoria status

# Use different API endpoint
vigthoria config --set apiUrl=https://backup.api.vigthoria.io

Reset Configuration

vigthoria config --reset

Support

• User Handbook (EN): VIGTHORIA_CLI_USER_HANDBOOK_EN.md
• Benutzerhandbuch (DE): VIGTHORIA_CLI_USER_HANDBOOK_DE.md
• PDF Handbooks: Download EN | Download DE
• Documentation: https://docs.vigthoria.io/cli
• Issues: https://community.vigthoria.io/forums/cli-support
• Discord: https://discord.gg/vigthoria
• Email: [email protected]

License

MIT License - See LICENSE for details.

Built with ❤️ by Vigthoria Technologies