AIV is a command-line utility that allows you to interact with AI models through Unix pipes. It provides a simple and flexible interface for sending prompts to AI models and receiving responses directly within your terminal.
- Pipe-friendly design for seamless integration with Unix tools
- Context management with support for files and stdin
- Conversation history support for multi-turn interactions
- Customizable system prompts
- Model selection options
-
Clone the repository:
git clone https://github.com/o8vm/aiv.git -
Make the script executable:
chmod +x aiv -
Create a configuration file at
~/.config/aiv/configwith your API key:API_KEY="your_anthropic_api_key" MODEL="claude-3-7-sonnet-latest" MAX_TOKENS=4096 SYS_PROMPT="You are a helpful AI assistant."
aiv [options] [prompt]
-c [file_pattern|-]: Add context from files (glob pattern) or stdin (-)-r: Repeat the input before output-e: Continue previous conversation thread-m MODEL: Use specified model (default: claude-3.7-sonnet-latest)-h: Display help message-s [prompt]: Overwrite system prompt-v: Display version information
Basic usage:
echo "What is Unix?" | aiv
Adding context from a file:
aiv -c mycode.js "Explain this code"
Adding context from stdin and files:
cat mydata.txt | aiv -c - -c file1.txt -c file2.txt "Summarize this data"
Continue a conversation:
aiv -e "Tell me more about that"
In an editor, you can add the selected text to the conversation context:
aiv -c - -c file1.txt -c file2.txt -r -e
The -r option is necessary to retain the selected content in the editor, and the -e option maintains the previous conversation thread.
After adding context, you can generate new content with additional commands:
aiv -e "generate something"
This workflow lets you seamlessly integrate AI assistance while editing, maintaining conversation context between commands for more coherent assistance.
MIT License