gem install askcii

# Simple prompt
askcii 'Explain recursive functions in one sentence'

# Pipe input from other commands
git diff | askcii 'Review this code change'

# Chain with other tools
curl -s https://api.github.com/repos/ruby/ruby | askcii 'Summarize this repo' | tee summary.txt

# Private session (no history)
askcii -p 'What is my IP address showing?'

# Direct prompt
askcii 'Your prompt here'

# Standard input from pipe
echo 'Context text' | askcii 'Analyze this'

# Read from file
askcii 'Summarize this document' < document.txt

# Redirect output to file
askcii 'Write a bash script to backup /home' > backup.sh

# Chain multiple commands
cat error.log | grep ERROR | askcii 'What are the common patterns?' | less

# Code review with detailed feedback
git diff main..feature-branch | askcii 'Review these changes. Focus on security and performance.'

# Explain unfamiliar code
cat legacy_module.rb | askcii 'Explain what this code does and identify potential issues'

# Generate unit tests
askcii 'Write RSpec tests for a User model with email validation' > spec/user_spec.rb

# Debug assistance
tail -50 production.log | grep ERROR | askcii 'What are the root causes of these errors?'

# Refactoring suggestions
cat messy_controller.rb | askcii 'Suggest refactoring to improve this code'

# Documentation generation
ls -R lib/ | askcii 'Create a project structure overview' > STRUCTURE.md

# CSV to JSON conversion
cat users.csv | askcii 'Convert this CSV to JSON array format' > users.json

# Log analysis and summarization
tail -1000 /var/log/nginx/access.log | askcii 'Summarize traffic patterns and anomalies'

# Data extraction from unstructured text
curl -s https://example.com/article | askcii 'Extract all email addresses and URLs as a list'

# SQL query generation
askcii 'Write a PostgreSQL query to find duplicate users by email' >> queries.sql

# API response analysis
curl -s https://api.service.com/status | jq . | askcii 'Is this API healthy? Explain the metrics.'

# Server health check summary
df -h && free -h && uptime | askcii 'Assess system health and recommend actions'

# Parse and explain complex configs
cat /etc/nginx/nginx.conf | askcii 'Explain this configuration and suggest optimizations'

# Security audit
find . -name "*.sh" -exec cat {} \; | askcii 'Review these shell scripts for security issues'

# Quick command help
askcii 'Show me tar command examples for incremental backups'

# Incident analysis
journalctl --since "1 hour ago" | askcii 'Identify any critical system events'

# Generate README sections
askcii 'Write installation instructions for a Ruby gem' >> README.md

# Meeting notes to action items
cat meeting_transcript.txt | askcii 'Extract action items with owners as markdown checklist'

# Explain technical concepts
askcii 'Explain OAuth2 flow in simple terms' > oauth_explainer.md

# Create Git commit messages
git diff --staged | askcii 'Write a conventional commit message' | pbcopy

# Named session for ongoing work
export ASKCII_SESSION="database-migration"
askcii 'I need to migrate from MySQL to PostgreSQL'
askcii 'What about handling JSON columns?' # Remembers context
askcii 'Show migration script for users table' > migrate_users.sql

# Project-specific session
ASKCII_SESSION="feature-auth" askcii 'How should I implement 2FA?'
ASKCII_SESSION="feature-auth" askcii 'Show me the code for TOTP generation'

# Retrieve last response (useful when output scrolled away)
askcii -r | less

# Use Claude for creative content
askcii -m 1 'Write a technical blog post intro about WebAssembly' > blog_draft.md

# Use GPT-4 for code generation
askcii -m 2 'Create a Python class for rate limiting' > rate_limiter.py

# Use local Ollama for private/sensitive data
cat proprietary_data.txt | askcii -m 3 -p 'Analyze this confidential report'

# Use DeepSeek for cost-effective tasks
find . -name "*.rb" | xargs wc -l | askcii -m 4 'Summarize codebase statistics'

# Multi-stage pipeline
cat research_papers.txt | \
  askcii 'Extract key findings' | \
  askcii 'Group by topic' | \
  askcii 'Create a bibliography' > bibliography.md

# Watch and analyze in real-time
tail -f app.log | grep --line-buffered ERROR | while read line; do
  echo "$line" | askcii -p 'Explain this error briefly'
done

# Batch processing with parallel
find . -name "*.java" | parallel -j4 "cat {} | askcii 'Rate code quality 1-10' | echo {}: "

# Interactive script integration
#!/bin/bash
context=$(cat context.txt)
while true; do
  read -p "Question: " question
  echo "$context" | askcii "$question"
done

askcii -c

# Use default configuration
askcii 'Hello world'

# Use specific configuration by ID
askcii -m 2 'Use Claude for this'

# Switch default in config manager
askcii -c  # Then select "Set default configuration"

# Quick override
ASKCII_API_KEY="sk-xxx" ASKCII_MODEL_ID="gpt-4" askcii 'Quick question'

# In scripts
export ASKCII_API_KEY="your_key"
export ASKCII_API_ENDPOINT="https://api.openai.com/v1"
export ASKCII_MODEL_ID="gpt-3.5-turbo"
askcii 'Automated query'

# Random session per terminal session (recommended)
export ASKCII_SESSION=$(openssl rand -hex 16)

# Named session for a specific project
export ASKCII_SESSION="refactoring-auth-module"
askcii 'What patterns should I use for the auth module?'
askcii 'Show code for the JWT validator'  # Remembers previous context

# One-off session (no context retention)
askcii 'Standalone question'  # Creates random session ID

# Private mode (no database storage at all)
askcii -p 'What is 2+2?'  # No session, no history

# Get last response from current session
askcii -r

# Useful in scripts
last_response=$(askcii -r)
echo "$last_response" | process_further.sh

# Copy to clipboard
askcii -r | pbcopy  # macOS
askcii -r | xclip -selection clipboard  # Linux

# Private mode: no storage, no history
askcii -p 'Analyze this sensitive data' < confidential.txt

# Use local Ollama for complete privacy
askcii -m 6 'Process private information' < private.txt

# Session isolation
ASKCII_SESSION="temp-$(date +%s)" askcii 'Temporary context'

# .git/hooks/pre-commit
#!/bin/bash
git diff --cached | askcii -p 'Any obvious issues with this commit?' | tee /dev/tty
read -p "Proceed with commit? [y/N] " -n 1 -r
echo
[[ $REPLY =~ ^[Yy]$ ]] || exit 1

# ~/.bashrc or ~/.zshrc
alias explain='askcii "Explain this command:"'
alias review='git diff | askcii "Review this code:"'
alias commit-msg='git diff --staged | askcii -p "Write a commit message:" | head -1'
alias tldr='askcii "Summarize in 3 bullets:"'

# Setup
git clone https://github.com/yourusername/askcii.git
cd askcii
bin/setup

# Run locally
bin/askcii 'Test prompt'

# Run tests
rake test

# Interactive console
bin/console

# Build and install locally
bundle exec rake build
bundle exec rake install