linaix 0.1.4

Cross-platform command generator from natural language (Linux/macOS/Windows)

LinAIx

Simple, safe, cross-platform command generation from natural language

Describe what you want in plain English — LinAIx generates the appropriate shell command for your OS and runs it after confirmation.

---

🚀 Installation

pip install linaix

⚙️ Setup

Choose a provider and configure your API key:

# Google Gemini
linaix --set-google-key YOUR_API_KEY

# OpenAI ChatGPT
linaix --set-openai-key YOUR_API_KEY

Or use environment variables:

export GOOGLE_API_KEY=your_key
export OPENAI_API_KEY=your_key

📖 Usage

Basic usage (requires confirmation):

linaix --provider google --model gemini-1.5-flash "list all python files"

Quick examples:

# Preview without running
linaix --provider google --model gemini-1.5-flash --dry-run "create backup directory"

# Skip confirmation prompt
linaix --provider openai --model gpt-4o-mini --yes "show disk usage"

# Set timeout
linaix --provider google --model gemini-1.5-flash --timeout 60 "find large files"

# Specify shell (auto-detects by default)
linaix --provider google --model gemini-1.5-flash --shell powershell "list processes"

Available options:

• --provider — google or openai (default: google)
• --model — Model name (required, e.g., gemini-1.5-flash, gpt-4o-mini)
• --shell — auto, bash, zsh, powershell, cmd (default: auto)
• --dry-run — Show command without executing
• --yes — Skip confirmation prompt
• --timeout — Command timeout in seconds (default: 30)

🔒 Safety Features

• ✅ Single command only (no pipes, redirects, or chaining)
• ✅ Confirmation required before execution (unless --yes)
• ✅ Blocks dangerous commands (rm, dd, shutdown, etc.)
• ✅ Detects suspicious patterns (rm -rf /, fork bombs, etc.)
• ✅ Input validation and sanitization

🛠️ Configuration

Config file: ~/.linaix/config.json

{
  "provider": "google",
  "google_api_key": "your_key_here",
  "openai_api_key": ""
}

🐛 Troubleshooting

Issue	Solution
"No API key" error	Run linaix --set-google-key YOUR_KEY or set environment variable
"Permission denied"	Check PATH or reinstall: pip install --force-reinstall linaix
Command not found	Add Python Scripts to PATH (Windows) or restart terminal

📝 License

MIT

This project is licensed under the MIT License - see the LICENSE file for details.