AskIT CLI

🔧 Claude-Code for SysAdmins, SecOps, and DevOps. Ask questions in natural language and get instant shell commands with explanations. Like having Claude in your terminal.

AskIT CLI is an intelligent command-line assistant that understands your system context, analyzes your shell history, and provides tailored command suggestions through natural language queries. Use it to automate routine tasks, explain complex commands, and accelerate your workflow -- all through your native language.

✨ Features

• 🤖 AI-Powered Suggestions: Leverages Claude AI for intelligent command generation
• 💰 Cost-Effective: Unlike Claude Code, AskIT is extremely economical (0.5¢ to 3¢ per prompt)
• 📚 Context Awareness: Analyzes shell history and detects project types
• ⚡ Multiple Execution Modes: Normal, Strike (auto-execute), and Safe modes
• 🛡️ Security First: Built-in safe mode and command validation with automatic credential protection
• 🔒 Data Protection: Automatically detects and prevents sending credentials and sensitive data to Claude
• 🔄 Interactive Workflows: Ask follow-up questions for complex tasks
• 🎯 Smart Configuration: Auto-detects shell and installs tab completion
• 📦 Cross-Platform: Available as native binaries for Windows, macOS, and Linux

🚀 Quick Start

🎯 Usage Examples

System Administration

askit-cli -p show me all processes using more than 100MB RAM
askit-cli -p check if port 443 is open and what's using it
askit-cli -p create a backup of /etc/nginx/nginx.conf

Security Operations

askit-cli -p show failed login attempts from the last hour
askit-cli -p check for unusual network connections
askit-cli -p scan for files with SUID bit set

DevOps Tasks

askit-cli -p deploy the latest version to staging
askit-cli -p check the health of all kubernetes pods
askit-cli -p rotate the application logs

⚙️ Configuration

AskIT CLI supports multiple configuration options:

Execution Modes

• Normal: Shows command and explanation (default)
• Strike: Auto-executes high-confidence commands
• Safe: Never executes, only shows suggestions

Project Detection and Initialization

AskIT can operate in global mode or project mode for better contextualization:

Global Mode

AskIT works directly from any directory without special configuration.

Project Mode (Recommended)

For better contextualization, initialize your project:

# In your project root directory
askit-cli init

This command creates a .askit directory that allows AskIT to:

• Remember your project-specific context
• Store logs locally
• Improve suggestion accuracy

When to use init:

• At the beginning of a new project
• For complex projects with specific configurations
• When you want more precise and contextual suggestions
• For team collaboration with shared configurations

Once initialized, AskIT automatically detects project types and infrastructure:

• Terraform projects - Understands your infrastructure as code
• Ansible playbooks - Provides context-aware automation suggestions
• Git repositories
• Docker projects
• Node.js applications
• Python projects
• And more...

🔒 Privacy and Security

API Key Security

• Your Anthropic API key is stored securely using your system's keyring (for macOS click "always accept")
• Keys are never transmitted except to Anthropic's official API endpoints

Safe Mode

Use --safe flag to preview commands without execution:

askit-cli --safe -p your potentially dangerous command

🐛 Reporting Issues

Found a bug or have a suggestion?

1. GitHub Issues: File an issue
2. Security Issues: Email git.lpl at protonmail dot com (I will report any unsolicited marketing stuff)
3. General Questions: Start a Discussion

📄 License

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

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

---

⚠️ Important: AskIT CLI is a powerful tool that can execute system commands. Always review suggestions before execution, especially in production environments. Use --safe mode when in doubt.