Package Exports

vigthoria-cli
vigthoria-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vigthoria-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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:

Check internet connection:
```
ping registry.npmjs.org
```

If behind a corporate proxy:

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

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

Direct tarball download:

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

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

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

# 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: support@vigthoria.io

License

MIT License - See LICENSE for details.

Built with ❤️ by Vigthoria Technologies

vigthoria-cli

Package Exports

Readme

Vigthoria CLI

Features

Installation

Quick Install (Recommended)

Quick Install (Linux/macOS)

Quick Install (Windows PowerShell)

npm Install (All Platforms)

Manual Install

Troubleshooting Installation

Network Issues (npm ENOTFOUND)

Windows-Specific Issues

Quick Start

1. Login

2. Start Chatting

3. Edit Files

Commands

Chat Mode

Edit File

Generate Code

Explain Code

Fix Code

Code Review

Configuration

Initialize Project

Vigthoria Repository (Cloud Storage)

Push a Project

Pull a Project

List Projects

Check Sync Status

Share a Project

Delete a Project

Clone a Public Project

Available Models

Vigthoria Native Models

External Models (Ollama Fallback)

Using Specific Models

Configuration File

Global Config

Project Config

Shortcuts

Shell Completion

Bash

Zsh

Environment Variables

Examples

Working with Drupal Sites

Setting Up a New Drupal Site

Scanning an Existing Drupal Site

Common Drupal Tasks

Drupal Agent Mode Commands

Interactive Coding Session

Git Pre-commit Hook

Troubleshooting

"Not authenticated" Error

"Subscription expired" Warning

Connection Issues

Reset Configuration

Support

License