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

$3

$3

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

$3

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

$3

`bash
npm install -g vigthoria-cli
`

$3

`bash


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

$3

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

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

2. If behind a corporate proxy:
`bash
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:
`bash
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:
`bash
# 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):
`bash
git clone https://market.vigthoria.io/vigthoria/vigthoria-cli.git
cd vigthoria-cli && npm install && npm run build && npm link
`

$3

PowerShell Execution Policy:
`powershell
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

$3

`bash
vigthoria login
`

Options:
- Email & Password
- API Token
- Browser OAuth

$3

`bash
vigthoria chat


or


vig c
`

$3

`bash
vigthoria edit src/index.ts


or


vig e src/index.ts
`

Commands

$3

`bash
vigthoria chat [options]

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

In chat mode, you can use these special commands:
- /file - Add file to context
- /edit - Switch to edit mode
- /diff - Show pending changes
- /apply - Apply pending changes
- /model - Switch AI model
- /clear - Clear conversation
- /help - Show commands
- /exit - Exit chat

$3

`bash
vigthoria edit [options]

Options:
-i, --instruction Editing instruction
-m, --model Select AI model
`

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

$3

`bash
vigthoria generate [options]

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

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

$3

`bash
vigthoria explain [options]

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

Example:
`bash
vigthoria explain src/complex.ts -l 50-100 -d detailed
`

$3

`bash
vigthoria fix [options]

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

Example:
`bash
vigthoria fix src/index.ts -t security --apply
`

$3

`bash
vigthoria review [options]

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

Example:
`bash
vigthoria review src/app.ts -f markdown > review.md
`

$3

`bash


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
`

$3

`bash
vigthoria init
`

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

$3

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

#### Push a Project

`bash


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

`bash


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

`bash


List all your projects

vigthoria repo list

or

vigthoria repo ls

Filter by visibility

vigthoria repo list --visibility private
`

#### Check Sync Status

`bash


Check if current project is synced


vigthoria repo status
`

#### Share a Project

`bash


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

`bash


Remove from Vigthoria Repo (local files unaffected)

vigthoria repo delete my-project

or

vigthoria repo rm my-project
`

#### Clone a Public Project

`bash


Clone from preview URL or project ID


vigthoria repo clone https://coder.vigthoria.io/preview/123
vigthoria repo clone 123
`

Available Models

$3

| 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 |

$3

| 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 |

$3

`bash


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

$3

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

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

$3

Create .vigthoria.json in your project root:

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

Shortcuts

For faster access, use the vig command:

`bash
vig c # vigthoria chat
vig e # vigthoria edit
vig g # vigthoria generate
vig x # vigthoria explain
vig f # vigthoria fix
vig r # vigthoria review
`

Shell Completion

$3

`bash
source ~/.bash_completion.d/vigthoria
`

$3

Add to ~/.zshrc:
`bash
fpath=(~/.zsh/completion $fpath)
autoload -Uz compinit && compinit
`

Environment Variables

`bash


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

$3

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

#### Setting Up a New Drupal Site

`bash


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

`bash


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

`bash


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:

`bash
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
`

$3

`bash
$ 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
`

$3

`bash


Review all TypeScript files


for file in src/*/.ts; do
vigthoria review "$file" -f markdown >> review-report.md
done
`

$3

`bash
#!/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

$3

`bash
vigthoria login


or


export VIGTHORIA_TOKEN="your-token"
`

$3

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

$3

`bash


Check API status

vigthoria status

Use different API endpoint

vigthoria config --set apiUrl=https://backup.api.vigthoria.io
`

$3

`bash
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