Usage
Pipe Mode
Pipe command output to whisp for AI-powered analysis and summarization.
Pipe Mode
Pipe command output to whisp for AI-powered analysis and summarization.
Basic Usage
Use the pipe operator to send output to whisp:
cat file.txt | , summarize thisWhisp will analyze the content and provide a summary or answer based on your query.
Log Analysis
Error Investigation
# Summarize errors in a log file
cat error.log | , summarize the errors
# Find the root cause of failures
tail -500 /var/log/app.log | , why did the app crash
# Get a timeline of events
grep "ERROR\|WARN" app.log | , what happened in sequenceServer Logs
# Analyze nginx access patterns
tail -1000 /var/log/nginx/access.log | , what are the most common endpoints
# Find suspicious activity
cat access.log | , are there any signs of attack or abuse
# Identify slow requests
grep "request_time" nginx.log | , which requests are slowestSystem Logs
# Check for system issues
journalctl -u nginx --since "1 hour ago" | , are there any problems
# Analyze boot issues
journalctl -b | , did anything fail during boot
# Check security events
journalctl -t sshd | , any suspicious login attemptsCode Analysis
Understanding Code
# Explain a script
cat deploy.sh | , explain what this deployment script does step by step
# Understand a function
sed -n '100,150p' main.py | , what does this function do
# Document code
cat utils.rs | , write doc comments for these functionsFinding Issues
# Find bugs
cat handler.js | , are there any bugs or edge cases I'm missing
# Security review
cat auth.py | , are there any security vulnerabilities
# Performance issues
cat query.sql | , will this query be slow on large tablesCode Suggestions
# Optimize code
cat loop.c | , how can I make this faster
# Refactor suggestions
cat legacy.rb | , how would you modernize this code
# Test suggestions
cat api.ts | , what test cases should I write for thisGit Workflow
Commit and PR Review
# Summarize changes
git diff | , summarize these changes for a commit message
# Review staged changes
git diff --cached | , anything problematic in these changes
# Understand a commit
git show HEAD | , explain what this commit doesHistory Analysis
# Find when something changed
git log -p --follow -- file.txt | , when did the API endpoint change
# Understand refactoring
git diff main..feature | , summarize all the changes in this branch
# Blame investigation
git blame file.py | , who introduced the bug on line 42Data Processing
CSV and JSON
# Analyze CSV data
cat sales.csv | , what's the total revenue by region
# Summarize JSON
curl -s api.example.com/stats | , summarize this response
# Find anomalies
cat metrics.json | , are there any unusual valuesConfiguration Files
# Understand config
cat nginx.conf | , explain this nginx configuration
# Find issues
cat docker-compose.yml | , any problems with this setup
# Extract info
cat .env.example | , what environment variables are requiredOutput Transformation
# Convert formats
cat data.xml | , convert this to JSON
# Extract fields
cat output.txt | , extract all email addresses
# Restructure data
cat messy.log | , parse this into a clean table formatDevOps Tasks
Container and Infrastructure
# Analyze Dockerfile
cat Dockerfile | , suggest improvements for this Dockerfile
# Kubernetes troubleshooting
kubectl describe pod myapp | , why is this pod failing
# Terraform review
cat main.tf | , are there any security issues in this terraformNetwork Debugging
# Analyze connections
netstat -tuln | , what services are listening
# DNS issues
dig example.com | , is there a DNS problem
# HTTP debugging
curl -v api.example.com 2>&1 | , why did this request failMulti-Step Pipelines
Chain commands for complex analysis:
# Find and analyze errors
grep ERROR app.log | tail -100 | , group these errors by type
# Cross-reference data
join file1.csv file2.csv | , what patterns do you see
# Filter then analyze
cat access.log | grep "POST /api" | , which API calls are failingInput Limits
- Whisp truncates input to ~8000 characters to stay within AI context limits
- For large files, filter or sample first:
# Sample a large log
head -500 huge.log | , summarize the errors
# Filter before piping
grep "ERROR" huge.log | head -200 | , what's causing theseTips for Best Results
- Be specific: "summarize errors" is better than "analyze this"
- Provide context: "this is a nginx config" helps the AI understand
- Ask one question at a time: Split complex queries into steps
- Filter first: Use grep/head/tail to focus on relevant content
- Use natural language: Write queries like you're asking a colleague