{"id":36543726,"url":"https://github.com/riparuk/qiai","last_synced_at":"2026-01-12T05:53:09.911Z","repository":{"id":245600859,"uuid":"818814288","full_name":"riparuk/qiai","owner":"riparuk","description":"CLI Assistant when you forget commands — powered by GPT \u0026 Gemini","archived":false,"fork":false,"pushed_at":"2025-07-22T11:17:39.000Z","size":1581,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-04T09:32:32.297Z","etag":null,"topics":["assistant","automation","gpt","script"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/riparuk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-23T00:21:04.000Z","updated_at":"2025-07-22T14:25:41.000Z","dependencies_parsed_at":"2025-06-26T14:32:54.667Z","dependency_job_id":null,"html_url":"https://github.com/riparuk/qiai","commit_stats":null,"previous_names":["riparuk/qiai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/riparuk/qiai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riparuk%2Fqiai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riparuk%2Fqiai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riparuk%2Fqiai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riparuk%2Fqiai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/riparuk","download_url":"https://codeload.github.com/riparuk/qiai/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riparuk%2Fqiai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28335544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T00:36:25.062Z","status":"online","status_checked_at":"2026-01-12T02:00:08.677Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant","automation","gpt","script"],"created_at":"2026-01-12T05:53:08.066Z","updated_at":"2026-01-12T05:53:09.902Z","avatar_url":"https://github.com/riparuk.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QIAI - Terminal Command Assistant\n\nQIAI (Quick Assistant) is a CLI tool that helps you get relevant terminal commands quickly using AI (OpenAI GPT \u0026 Google Gemini).\n\n## Installation\n\n```bash\nnpm install -g qiai\n```\n\n## Quick Start\n\n### 1. Set up API Keys\nYou need at least one API key to use QIAI:\n\n```bash\n# Set OpenAI API key (becomes default)\nqiai --set-openai-api-key your-openai-api-key\n\n# Or set Gemini API key (becomes default)\nqiai --set-gemini-api-key your-gemini-api-key\n```\n\n### 2. Ask Questions\n```bash\n# Auto-select available provider\nqiai -q \"how to list files in directory\"\n\n# Force specific provider\nqiai -q \"how to install docker\" --openai\nqiai -q \"how to install docker\" --gemini\n```\n\n## Usage\n\n### Basic Commands\n```bash\n# Ask any command-related question\nqiai -q \"your question\"                    # Auto-select provider\nqiai -q \"your question\" --openai           # Force OpenAI\nqiai -q \"your question\" --gemini           # Force Gemini\n\n# API key management\nqiai --set-openai-api-key your-api-key     # Set OpenAI key\nqiai --set-gemini-api-key your-api-key     # Set Gemini key\n\n# Provider management\nqiai --set-default-provider openai|gemini  # Set default provider\n```\n\n### Provider Management\nThe last API key you set automatically becomes the default provider:\n\n```bash\n# Set OpenAI key - becomes default\nqiai --set-openai-api-key your-key\n\n# Set Gemini key - becomes default  \nqiai --set-gemini-api-key your-key\n\n# Manually override default\nqiai --set-default-provider openai\nqiai --set-default-provider gemini\n```\n\n## Examples\n\n### Docker Commands\n```bash\n$ qiai -q \"how to stop all docker containers\"\nUsing GEMINI provider...\n┌─────────────────────────────────┬─────────────────────┬──────────────┐\n│ COMMAND                         │ DESCRIPTION         │ DANGER_LEVEL │\n├─────────────────────────────────┼─────────────────────┼──────────────┤\n│ docker stop $(docker ps -q)    │ Stop all containers │ Level 2      │\n└─────────────────────────────────┴─────────────────────┴──────────────┘\n```\n\n### Git Commands\n```bash\n$ qiai -q \"clone laravel project\"\nUsing OPENAI provider...\n┌─────────────────────────────────────┬─────────────────────────┬──────────────┐\n│ COMMAND                             │ DESCRIPTION             │ DANGER_LEVEL │\n├─────────────────────────────────────┼─────────────────────────┼──────────────┤\n│ composer create-project laravel/... │ Create Laravel project  │ Level 1      │\n│ cd my-project \u0026\u0026 php artisan serve  │ Start dev server        │ Level 1      │\n└─────────────────────────────────────┴─────────────────────────┴──────────────┘\n```\n\n### System Commands\n```bash\n$ qiai -q \"check disk usage\"\n$ qiai -q \"find large files\"\n$ qiai -q \"kill process by name\"\n$ qiai -q \"compress folder to zip\"\n```\n\n## Response Format\n\nQIAI returns commands in a structured table format:\n- **Command**: The actual terminal command to run\n- **Description**: Brief explanation of what the command does  \n- **Danger Level**: Safety indicator\n  - Level 1: Safe commands (read-only, basic operations)\n  - Level 2: Commands that might change data\n  - Level 3: Potentially destructive commands\n\n## API Keys Setup\n\n### OpenAI API Key\n1. Go to [OpenAI Platform](https://platform.openai.com/api-keys)\n2. Create a new API key\n3. Set it: `qiai --set-openai-api-key your-key`\n\n### Google Gemini API Key  \n1. Go to [Google AI Studio](https://makersuite.google.com/app/apikey)\n2. Create a new API key\n3. Set it: `qiai --set-gemini-api-key your-key`\n\n## Features\n\n- **Multi-AI Support**: Works with both OpenAI GPT and Google Gemini\n- **Auto Provider Selection**: Automatically uses available AI provider\n- **OS-Specific**: Provides commands for your operating system (Windows, macOS, Linux)\n- **Smart Responses**: Returns organized commands with safety levels\n- **Token Optimized**: Efficient prompts to reduce API costs\n\n## Troubleshooting\n\n### Command Not Found\n```bash\n# Reinstall globally\nnpm install -g qiai\n\n# Check installation\nwhich qiai\n```\n\n### API Errors\n- Verify your API keys are valid\n- Check your internet connection\n- Ensure you have API credits/quota available\n\n### No Response\n- Make sure your question is about terminal commands\n- Try rephrasing your question\n- Check if the provider is working: `qiai -q \"list files\" --openai`\n\n## More Examples\n\n```bash\n# Development\nqiai -q \"start a local python web server\"\nqiai -q \"install node modules\"\nqiai -q \"run database migration with express\"\n\n# System Administration  \nqiai -q \"check system memory\"\nqiai -q \"monitor network traffic\"\nqiai -q \"backup directory\"\n\n# File Operations\nqiai -q \"copy files recursively\"\nqiai -q \"find files by extension\"\nqiai -q \"change file permissions\"\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friparuk%2Fqiai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friparuk%2Fqiai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friparuk%2Fqiai/lists"}