askimo 1.1.0 → 1.2.0

package/README.md

@@ -7,7 +7,7 @@
 
 A CLI tool for communicating with AI providers.
 
-**Supported providers:** Perplexity · OpenAI · Anthropic
+**Supported providers:** Perplexity · OpenAI · Anthropic · xAI (Grok)
 
 ---
 
@@ -26,12 +26,14 @@ Create a config file at `~/.askimo/config`:
 PERPLEXITY_API_KEY=your-perplexity-key
 OPENAI_API_KEY=your-openai-key
 ANTHROPIC_API_KEY=your-anthropic-key
+XAI_API_KEY=your-xai-key
 
 # Optional settings
 DEFAULT_PROVIDER=perplexity
 PERPLEXITY_MODEL=sonar
 OPENAI_MODEL=gpt-4o
 ANTHROPIC_MODEL=claude-sonnet-4-20250514
+XAI_MODEL=grok-4
 ```
 
 ---
@@ -46,15 +48,17 @@ askimo "What is the capital of France?"
 
 ### Choose a provider
 
-| Flag | Provider |
-|------|----------|
+| Flag | Provider             |
+|------|----------------------|
 | `-p` | Perplexity (default) |
-| `-o` | OpenAI |
-| `-a` | Anthropic |
+| `-o` | OpenAI               |
+| `-a` | Anthropic            |
+| `-x` | xAI (Grok)           |
 
 ```bash
 askimo "explain quantum computing" -o    # Use OpenAI
 askimo "write a haiku" -a                # Use Anthropic
+askimo "what's happening today?" -x      # Use xAI Grok
 ```
 
 ### Continue a conversation
@@ -89,6 +93,7 @@ askimo -f error.log "find the bug"
 ```bash
 askimo chat                # Start new chat
 askimo chat -o             # Chat with OpenAI
+askimo chat -x             # Chat with xAI Grok
 askimo chat -c 1           # Continue last conversation
 ```
 
@@ -99,20 +104,21 @@ Type `exit` or `Ctrl+C` to quit.
 ```bash
 askimo models              # All providers
 askimo models -p           # Perplexity only
+askimo models -x           # xAI only
 ```
 
 ---
 
 ## ✨ Features
 
-| Feature | Description |
-|---------|-------------|
-| Streaming | Real-time response output |
-| 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 |
+| Feature        | Description                                       |
+|----------------|---------------------------------------------------|
+| Streaming      | Real-time response output                         |
+| 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                |
 
 ---
 

package/index.mjs

@@ -20,6 +20,7 @@ program
   .option('-p, --perplexity', 'Use Perplexity AI (default)')
   .option('-o, --openai', 'Use OpenAI')
   .option('-a, --anthropic', 'Use Anthropic Claude')
+  .option('-x, --xai', 'Use xAI Grok')
   .option('-j, --json', 'Output as JSON instead of streaming')
   .option('-c, --continue <n>', 'Continue conversation N (1=last, 2=second-to-last)', Number.parseInt)
   .option('-f, --file <path>', 'Read content from file')
@@ -70,16 +71,16 @@ program
       let responseText
 
       if (options.json) {
-        const { text, sources } = await generateResponse(model, conversation.messages)
+        const { text, sources, duration } = await generateResponse(model, conversation.messages)
         responseText = text
         conversation.messages.push({
           role: 'assistant',
           content: responseText
         })
         await saveConversation(conversation, existingPath)
-        outputJson(conversation, responseText, sources)
+        outputJson(conversation, responseText, sources, duration)
       } else {
-        responseText = await streamResponse(model, conversation.messages)
+        responseText = await streamResponse(model, conversation.messages, modelName)
         conversation.messages.push({
           role: 'assistant',
           content: responseText
@@ -98,6 +99,7 @@ program
   .option('-p, --perplexity', 'Use Perplexity AI (default)')
   .option('-o, --openai', 'Use OpenAI')
   .option('-a, --anthropic', 'Use Anthropic Claude')
+  .option('-x, --xai', 'Use xAI Grok')
   .option('-c, --continue <n>', 'Continue conversation N (1=last, 2=second-to-last)', Number.parseInt)
   .action(async (options) => {
     try {
@@ -120,6 +122,7 @@ program
   .option('-p, --perplexity', 'Show only Perplexity models')
   .option('-o, --openai', 'Show only OpenAI models')
   .option('-a, --anthropic', 'Show only Anthropic models')
+  .option('-x, --xai', 'Show only xAI models')
   .action(async (options) => {
     try {
       const config = await loadConfig()
@@ -128,8 +131,9 @@ program
       if (options.perplexity) providers.push('perplexity')
       if (options.openai) providers.push('openai')
       if (options.anthropic) providers.push('anthropic')
+      if (options.xai) providers.push('xai')
 
-      const toShow = providers.length === 0 ? ['perplexity', 'openai', 'anthropic'] : providers
+      const toShow = providers.length === 0 ? ['perplexity', 'openai', 'anthropic', 'xai'] : providers
 
       const results = await Promise.all(
         toShow.map(async (provider) => ({

package/lib/chat.mjs

@@ -42,7 +42,7 @@ async function startChat(model, providerName, modelName, continueN = null) {
     })
 
     console.log('')
-    const responseText = await streamResponse(model, conversation.messages)
+    const responseText = await streamResponse(model, conversation.messages, modelName)
 
     conversation.messages.push({
       role: 'assistant',

package/lib/providers.mjs

@@ -1,11 +1,13 @@
 import { createAnthropic } from '@ai-sdk/anthropic'
 import { createOpenAI } from '@ai-sdk/openai'
 import { createPerplexity } from '@ai-sdk/perplexity'
+import { createXai } from '@ai-sdk/xai'
 
 const DEFAULT_MODELS = {
   perplexity: 'sonar',
   openai: 'gpt-4o',
-  anthropic: 'claude-sonnet-4-20250514'
+  anthropic: 'claude-sonnet-4-20250514',
+  xai: 'grok-4'
 }
 
 // Perplexity doesn't have a models list API, so we hardcode these
@@ -17,6 +19,20 @@ const PERPLEXITY_MODELS = [
   { id: 'sonar-deep-research', description: 'Deep research sessions' }
 ]
 
+// xAI doesn't have a public models list API, so we hardcode these
+const XAI_MODELS = [
+  { id: 'grok-4-1-fast-reasoning', description: 'Grok 4.1 fast with reasoning' },
+  { id: 'grok-4-1-fast-non-reasoning', description: 'Grok 4.1 fast without reasoning' },
+  { id: 'grok-code-fast-1', description: 'Grok optimized for code' },
+  { id: 'grok-4-fast-reasoning', description: 'Grok 4 fast with reasoning' },
+  { id: 'grok-4-fast-non-reasoning', description: 'Grok 4 fast without reasoning' },
+  { id: 'grok-4-0709', description: 'Grok 4 flagship model' },
+  { id: 'grok-3-mini', description: 'Lightweight Grok 3 model' },
+  { id: 'grok-3', description: 'Grok 3 base model' },
+  { id: 'grok-2-vision-1212', description: 'Grok 2 with vision capabilities' },
+  { id: 'grok-2-image-1212', description: 'Image generation model' }
+]
+
 async function fetchOpenAiModels(apiKey) {
   const response = await fetch('https://api.openai.com/v1/models', {
     // biome-ignore lint/style/useNamingConvention: headers use standard capitalization
@@ -71,6 +87,9 @@ async function listModels(provider, config) {
       return fetchAnthropicModels(apiKey)
     }
 
+    case 'xai':
+      return XAI_MODELS
+
     default:
       throw new Error(`Unknown provider: ${provider}`)
   }
@@ -117,6 +136,19 @@ function getProvider(providerName, config) {
         modelName
       }
     }
+    case 'xai': {
+      const apiKey = config.XAI_API_KEY
+      if (!apiKey) {
+        throw new Error('XAI_API_KEY not found in config')
+      }
+      const modelName = config.XAI_MODEL || DEFAULT_MODELS.xai
+      const xai = createXai({ apiKey })
+      return {
+        model: xai(modelName),
+        name: 'xai',
+        modelName
+      }
+    }
     default:
       throw new Error(`Unknown provider: ${providerName}`)
   }
@@ -126,9 +158,10 @@ function determineProvider(options, config = {}) {
   if (options.openai) return 'openai'
   if (options.anthropic) return 'anthropic'
   if (options.perplexity) return 'perplexity'
+  if (options.xai) return 'xai'
 
   const defaultProvider = config.DEFAULT_PROVIDER?.toLowerCase()
-  if (defaultProvider && ['perplexity', 'openai', 'anthropic'].includes(defaultProvider)) {
+  if (defaultProvider && ['perplexity', 'openai', 'anthropic', 'xai'].includes(defaultProvider)) {
     return defaultProvider
   }
 

package/lib/stream.mjs

@@ -1,6 +1,13 @@
 import { generateText, streamText } from 'ai'
 
-async function streamResponse(model, messages) {
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`
+  return `${(ms / 1000).toFixed(1)}s`
+}
+
+async function streamResponse(model, messages, modelName) {
+  const startTime = Date.now()
+
   const result = streamText({
     model,
     messages
@@ -29,19 +36,26 @@ async function streamResponse(model, messages) {
     })
   }
 
+  // Display status line
+  const duration = Date.now() - startTime
+  process.stdout.write(`\n\x1b[2m${modelName} · ${formatDuration(duration)}\x1b[0m\n`)
+
   return fullText
 }
 
 async function generateResponse(model, messages) {
+  const startTime = Date.now()
+
   const { text, sources } = await generateText({
     model,
     messages
   })
 
-  return { text, sources }
+  const duration = Date.now() - startTime
+  return { text, sources, duration }
 }
 
-function buildJsonOutput(conversation, response, sources) {
+function buildJsonOutput(conversation, response, sources, duration) {
   const lastUserMessage = conversation.messages.findLast((m) => m.role === 'user')
   const output = {
     provider: conversation.provider,
@@ -49,7 +63,8 @@ function buildJsonOutput(conversation, response, sources) {
     question: lastUserMessage?.content || '',
     response,
     conversationId: conversation.id,
-    messageCount: conversation.messages.length + 1
+    messageCount: conversation.messages.length + 1,
+    durationMs: duration
   }
 
   if (sources?.length > 0) {
@@ -59,8 +74,8 @@ function buildJsonOutput(conversation, response, sources) {
   return output
 }
 
-function outputJson(conversation, response, sources) {
-  const output = buildJsonOutput(conversation, response, sources)
+function outputJson(conversation, response, sources, duration) {
+  const output = buildJsonOutput(conversation, response, sources, duration)
   console.log(JSON.stringify(output, null, 2))
 }
 

package/package.json

@@ -1,9 +1,21 @@
 {
   "name": "askimo",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A CLI tool for communicating with AI providers (Perplexity, OpenAI, Anthropic)",
   "license": "Apache-2.0",
   "author": "Amit Tal",
+  "keywords": [
+    "cli",
+    "ai",
+    "llm",
+    "perplexity",
+    "openai",
+    "anthropic",
+    "claude",
+    "gpt",
+    "chatbot",
+    "terminal"
+  ],
   "type": "module",
   "bin": {
     "askimo": "./index.mjs"
@@ -27,6 +39,7 @@
     "@ai-sdk/anthropic": "^2.0.53",
     "@ai-sdk/openai": "^2.0.76",
     "@ai-sdk/perplexity": "^2.0.21",
+    "@ai-sdk/xai": "^2.0.40",
     "@inquirer/input": "^5.0.2",
     "ai": "^5.0.106",
     "commander": "^14.0.2"