Askimo

A CLI tool for communicating with AI providers.

Supported providers: Perplexity · OpenAI · Anthropic · xAI (Grok) · Google Gemini

---

📦 Installation

npm install -g askimo

⚙️ Configuration

Create a config file at ~/.askimo/config:

# API Keys (at least one required)
PERPLEXITY_API_KEY=your-perplexity-key
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
XAI_API_KEY=your-xai-key
GOOGLE_GENERATIVE_AI_API_KEY=your-google-key

# Optional settings
DEFAULT_PROVIDER=perplexity
PERPLEXITY_MODEL=sonar
OPENAI_MODEL=gpt-4o
ANTHROPIC_MODEL=claude-sonnet-4-20250514
XAI_MODEL=grok-4
GEMINI_MODEL=gemini-3-pro-preview
IMAGE_MODEL=gemini-3-pro-image-preview

---

🚀 Usage

Quick question

askimo "What is the capital of France?"

Choose a provider

Flag	Provider
-p	Perplexity (default)
-o	OpenAI
-a	Anthropic
-x	xAI (Grok)
-g	Google Gemini

askimo "explain quantum computing" -o    # Use OpenAI
askimo "write a haiku" -a                # Use Anthropic
askimo "what's happening today?" -x      # Use xAI Grok
askimo "summarize this topic" -g         # Use Google Gemini

Generate an image

askimo --image "a cat wearing a top hat"          # Save to current directory
askimo --image -d ./images "a sunset over ocean"  # Save to ./images/
askimo --image --json "a dog on a skateboard"     # JSON output with image paths

Uses Google Gemini's image generation model. Requires GOOGLE_GENERATIVE_AI_API_KEY in your config.

Continue a conversation

askimo "tell me more" -c 1     # Continue last conversation
askimo "go deeper" -c 2        # Continue second-to-last
askimo "explain more" --cid abc123  # Continue by conversation ID

JSON output

askimo "question" --json

Pipe content

cat code.js | askimo "explain this code"
echo "hello world" | askimo "translate to French"

Read from file

askimo -f code.js "what does this do"
askimo -f error.log "find the bug"
askimo -f photo.jpg "what's in this image?"         # Image files auto-detected
askimo --image "add watercolor effect" -f photo.png  # Image editing with Gemini

Interactive chat

askimo chat                # Start new chat
askimo chat -o             # Chat with OpenAI
askimo chat -g             # Chat with Gemini
askimo chat -c 1           # Continue last conversation
askimo chat --cid abc123   # Continue by conversation ID

Type exit or Ctrl+C to quit.

List models

askimo models              # All providers
askimo models -p           # Perplexity only
askimo models -g           # Gemini only

View conversation history

askimo conversations       # Opens browser with all conversations

---

✨ Features

Feature	Description
Streaming	Real-time response output
Image generation	Generate images with -i (uses Gemini)
Piping	Pipe content via stdin
File input	Read content from files with -f
Citations	Source links with Perplexity
History	Conversations saved to ~/.askimo/conversations/
Multi-provider	Switch between AI providers easily

---

🛠️ Development

npm install
npm test
npm run lint

---

📄 License

Apache-2.0