
skill-vector-rag-gui
by dnvriend
Qt6 GUI for searching local vector RAG stores with AI-powered research synthesis
SKILL.md
name: skill-vector-rag-gui description: vector rag gui
When to use
- When you need to use vector-rag-gui CLI tool
- When you need comprehensive guidance on CLI commands
- When you need examples and troubleshooting
vector-rag-gui Skill
Purpose
This skill provides access to the vector-rag-gui CLI tool. vector rag gui.
When to Use This Skill
Use this skill when:
- You need to understand how to use vector-rag-gui
- You need comprehensive examples and patterns
- You need troubleshooting guidance
Do NOT use this skill for:
- Tasks unrelated to vector-rag-gui
- Quick syntax lookups (use slash commands instead)
CLI Tool: vector-rag-gui
The vector-rag-gui is a command-line interface tool that vector rag gui.
Installation
# Clone and install
git clone https://github.com/dnvriend/vector-rag-gui.git
cd vector-rag-gui
uv tool install .
Prerequisites
- Python 3.14+
- uv package manager
Quick Start
# Example 1: Basic usage
vector-rag-gui --help
# Example 2: Show version
vector-rag-gui --version
Progressive Disclosure
help - Show Help Information
Display help information for CLI commands.
Usage:
vector-rag-gui --help
vector-rag-gui COMMAND --help
Examples:
# General help
vector-rag-gui --help
# Command help
vector-rag-gui command --help
# Version info
vector-rag-gui --version
Multi-Level Verbosity Logging
Control logging detail with progressive verbosity levels. All logs output to stderr.
Logging Levels:
| Flag | Level | Output | Use Case |
|---|---|---|---|
| (none) | WARNING | Errors and warnings only | Production, quiet mode |
-v | INFO | + High-level operations | Normal debugging |
-vv | DEBUG | + Detailed info, full tracebacks | Development, troubleshooting |
-vvv | TRACE | + Library internals | Deep debugging |
Examples:
# INFO level - see operations
vector-rag-gui command -v
# DEBUG level - see detailed info
vector-rag-gui command -vv
# TRACE level - see all internals
vector-rag-gui command -vvv
Shell Completion
Native shell completion for bash, zsh, and fish.
Installation:
# Bash (add to ~/.bashrc)
eval "$(vector-rag-gui completion bash)"
# Zsh (add to ~/.zshrc)
eval "$(vector-rag-gui completion zsh)"
# Fish (save to completions)
vector-rag-gui completion fish > ~/.config/fish/completions/vector-rag-gui.fish
Pipeline Composition
Compose commands with Unix pipes for powerful workflows.
Examples:
# Example pipeline workflows will be added when CLI commands are implemented
vector-rag-gui command --json | jq '.'
Common Issues
Issue: Command not found
# Verify installation
vector-rag-gui --version
# Reinstall if needed
cd vector-rag-gui
uv tool install . --reinstall
Issue: General errors
- Try with verbose flag:
-vvto see detailed error information - Check that all prerequisites are installed
- Ensure you're using Python 3.14+
Getting Help
# Show help
vector-rag-gui --help
# Command-specific help
vector-rag-gui COMMAND --help
Exit Codes
0: Success1: Client error (invalid arguments, validation failed)2: Server error (API error, network issue)3: Network error (connection failed, timeout)
Output Formats
Default Output:
- Human-readable formatted output
- Varies by command
JSON Output (--json flag):
- Machine-readable structured data
- Perfect for pipelines and processing
- Available on commands that support structured output
Best Practices
- Use verbosity progressively: Start with
-v, increase to-vv/-vvvonly if needed - Check help first: Use
--helpto understand command options - Leverage shell completion: Install completion for better CLI experience
Resources
- GitHub: https://github.com/dnvriend/vector-rag-gui
- Python Package Index: https://pypi.org/project/vector-rag-gui/
- Documentation:
Score
Total Score
Based on repository quality metrics
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
3ヶ月以内に更新がある
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
Reviews
Reviews coming soon