⚡ Clipad.ai

Clipad.ai is an interactive, AI-powered terminal assistant built with Node.js, React, and Ink. It transforms your natural language intentions into executable shell commands, allowing you to manage your system, search the web, and analyze content without leaving the command line.

🚀 Installation

Install Clipad globally via npm:

npm install -g clipad-ai

[!NOTE] Ensure you have Node.js 18+ installed. Clipad uses tsx to run naturally on your system.

🛠️ How It Works

1. Describe Your Intent: Type what you want to do in plain English (e.g., "Find all log files larger than 10MB and compress them").
2. AI Reasoning: Clipad uses your chosen LLM (OpenAI, Claude, Gemini, etc.) to understand the request and suggest the safest, most effective shell commands.
3. Review & Execute: Suggested commands appear in a visual card. You can:
   • Press [A] or Enter to Accept and run the command.
   • Press [R] to Reject the suggestion.
4. Tool Integration: If the AI needs more context, it can autonomously:
   • Search the Web: Using SearXNG.
   • Fetch Web Pages: Using Jina AI Reader.
   • Check Command Status: To verify if a previous step succeeded.

⚙️ Configuration & Setup

On the first run, Clipad launches an interactive Setup Wizard to configure your environment:

1. AI Providers

Clipad supports multiple providers out of the box:

• OpenAI (GPT)
• Anthropic (Claude Sonnet, Opus)
• Google Gemini (Pro, Flash)
• Mistral AI
• xAI Grok
• DeepSeek / Ollama (Local LLMs)
• Alibaba Qwen

2. Environment Variables

Instead of storing raw API keys in plain text, Clipad asks for the name of the environment variable (e.g., OPENAI_API_KEY). This keeps your keys secure in your .bashrc or .zshrc.

3. Advanced Tools (Optional)

• Jina AI: Provide a Jina API key env var to enable high-quality web page fetching.
• SearXNG: Provide your instance URL and an optional secret key to enable web searching.

⌨️ In-App Commands

While using the interactive shell, you can use these slash commands to update things on the fly:

| Command | Description | | :--- | :--- | | /model | Open a searchable dropdown to switch models for the current provider. | | /provider| Switch AI providers and update the API key environment variable. | | /searxng | Update your SearXNG host instance and secret key. | | /jina | Update your Jina AI Reader API key. | | exit | Cleanly exit the application. | | Ctrl+C | Force quit the application. |

🚩 CLI Flags

Run Clipad with flags to manage your configuration:

• clipad --reset: Wipes the local configuration (~/.config/clipad/config.json) and restarts the Setup Wizard.
• clipad --help: Shows help for all available flags.

📜 License

MIT © Daniel Mucamba