AI Shell

Converts plain English descriptions into executable shell commands by sending user prompts to OpenAI's language models and parsing structured responses. The system uses streaming response processing via the stream-to-string helper to handle real-time API output, then formats the LLM-generated command with syntax validation before presenting to the user. This eliminates memorization of complex CLI flags and syntax across different tools.

Presents generated shell commands to users with a confirmation workflow before execution, allowing review, editing, or rejection. The CLI interface processes user input through interactive prompts that capture approval/denial/modification decisions, preventing accidental execution of potentially destructive commands. This safety layer is built into the standard prompt mode and chat mode workflows.

Provides an update command (ai update) that checks for and installs newer versions of AI Shell, keeping the tool current with bug fixes and feature improvements. The update mechanism is integrated into the CLI core as a dedicated command, allowing users to upgrade without manual package manager intervention. Version information is managed via package.json.

Generates human-readable explanations of what generated shell commands do, breaking down flags, arguments, and side effects in plain language. The system requests explanations from OpenAI alongside command generation, then formats and displays them to help users understand command behavior. This is integrated into the standard prompt mode and can be skipped with the silent mode flag (-s).

Provides a multi-turn conversational interface where users can discuss shell commands, ask follow-up questions, and refine requests through dialogue. The chat mode maintains conversation context across multiple prompts, allowing the LLM to understand references to previous commands and build on prior discussions. This is implemented as a distinct command mode (ai chat) that routes through the CLI core with streaming response processing.

Provides CLI interface text, prompts, and explanations in 14+ languages (English, Simplified/Traditional Chinese, Spanish, Japanese, Korean, French, German, Russian, Ukrainian, Vietnamese, Arabic, Portuguese, Turkish, Indonesian) through a configuration-driven internationalization system. Language selection is persisted via the configuration system and applied to all user-facing text throughout the CLI workflow, including prompts, confirmations, and explanations.

Manages user preferences and API credentials through a configuration system that persists settings across CLI sessions. The configuration system stores API keys, language preferences, model selection, and other settings in a local configuration file, eliminating the need to re-enter credentials or preferences on every invocation. Configuration is accessed via the ai config command and integrated throughout the CLI core.

Executes command generation and execution without interactive confirmation or explanations via the -s flag, enabling scripted and automated workflows. Silent mode skips the confirmation prompt and explanation generation, directly outputting the generated command for piping or scripting. This is implemented as a CLI flag that modifies the standard prompt mode behavior.

Processes OpenAI API responses in real-time using streaming, displaying command output and explanations progressively as they arrive rather than waiting for full completion. The stream-to-string helper converts streaming chunks into displayable text, enabling immediate feedback to users. This is integrated into both standard prompt mode and chat mode, reducing perceived latency and improving UX for long-running API calls.

Integrates with OpenAI's language models (configurable model selection) to perform natural language understanding and command generation. The system sends formatted prompts to OpenAI's API, handles authentication via API key configuration, and processes responses. Model selection is configurable via the configuration system, allowing users to choose between different OpenAI models (e.g., gpt-3.5-turbo, gpt-4) based on accuracy/cost tradeoffs.

Parses CLI arguments and routes user input to appropriate command handlers using the cleye library, supporting multiple command modes (standard prompt, chat, config, update). The CLI core module defines command structure, argument validation, and routing logic, enabling a unified entry point for all AI Shell functionality. This modular command architecture allows easy addition of new commands without modifying core logic.