Askimo

Askimo is a command-line assistant that talks with LLMs - from online providers like OpenAI, X AI, Gemini to local models like Ollama.

Askimo - AI for your workflows, with the freedom to choose any provider.

Why Askimo?

• Switch providers anytime – Talk to OpenAI, Gemini, X AI, or Ollama with the same commands.

• Automation-first – Pipe files, logs, or command output into Askimo and let AI handle the rest.

• Your choice of interface – Use the CLI if you love the terminal, or the web UI if you prefer a browser.

• No lock-in – Designed to stay provider-neutral so you can change models as the AI landscape evolves.

Demo

• Piping commands & switching providers in Askimo

• Interacting with the local file system in Askimo

Quickstart

macOS / Linux (Homebrew)

brew tap haiphucnguyen/askimo
brew install askimo
askimo

Windows (Scoop)

scoop bucket add askimo https://github.com/haiphucnguyen/scoop-askimo
scoop install askimo
askimo

Other ways to install → Installation Guide

👉 Once installed, you can connect Askimo to providers like Ollama, OpenAI, Gemini, or X AI and start chatting.

📖 See Getting started for tutorials on setting up Ollama, adding API keys (OpenAI, Gemini, X AI), switching providers, and running real workflow examples.

Available Commands

Askimo supports two modes for running commands:

🔄 Interactive Mode

Start Askimo without arguments to enter interactive mode:

askimo
askimo> :help

🚀 Non-Interactive Mode

Run commands directly from the command line:

askimo --help
askimo --list-providers
askimo --set-provider openai

📋 Command Reference

All commands work in both modes - just use :command for interactive or --command for non-interactive:

Interactive Mode	Non-Interactive Mode	Description	Example Usage
:help	--help	Show all available commands	:help or askimo --help
:set-param	--set-param	Set a parameter for the current provider	:set-param style creative
:params	--params	View current session parameters	:params or askimo --params
:config	--config	Show the current provider, model, and settings	:config or askimo --config
:providers	--providers	List all supported AI providers	:providers or askimo --providers
:set-provider	--set-provider	Switch to a different AI provider	:set-provider ollama or askimo --set-provider ollama
:models	--models	List available models for the current provider	:models or askimo --models
:copy	--copy	Copy the last response to the clipboard	:copy
:clear	--clear	Clear the chat history for the current session	:clear
:create-project	--create-project	Create a project, auto-start Postgres+pgvector (Testcontainers), and index the folder	:create-project -n myapp -d /path/to/folder
:projects	--projects	List all saved Askimo projects	:projects or askimo --projects
:use-project	--use-project	Activate a saved project (sets scope and enables RAG)	:use-project myapp
:delete-project	--delete-project	Delete a saved project: removes it from ~/.askimo/projects.json and drops its pgvector embedding table. Use --all to delete all projects	:delete-project myapp or :delete-project --all
:create-recipe	--create-recipe	Create a provider-agnostic recipe from a YAML template	:create-recipe myrecipe --template recipe.yml or askimo --create-recipe myrecipe --template recipe.yml
:recipes	--recipes	List all registered recipes in ~/.askimo/recipes	:recipes or askimo --recipes
:delete-recipe	--delete-recipe	Delete a registered recipe from ~/.askimo/recipes. Use --all to delete all recipes	:delete-recipe myrecipe or :delete-recipe --all
:exit	N/A	Exit the Askimo REPL (interactive mode only)	:exit

💡 Quick Examples

Interactive Mode:

$ askimo
askimo> :providers
askimo> :set-provider openai  
askimo> :config
askimo> What is TypeScript?

Non-Interactive Mode:

$ askimo --providers
$ askimo --set-provider openai
$ askimo --config
$ echo "function add(a, b) { return a + b; }" | askimo "Convert this to TypeScript"

➡ View the full command reference »
Includes detailed usage, options, and examples for each command.

💡 Note: Some providers (such as OpenAI, X AI, etc.) require an API key.
Make sure you create and configure the appropriate key from your provider’s account dashboard before using them.

Extending Askimo

Askimo is designed to be pluggable, so you can tailor it to your needs:

• Add a new chat model – Integrate any AI provider by following the guide in docs/creating-new-chat-model.md

• Create a new command – Add custom CLI commands to automate tasks or build integrations. See docs/creating-new-command.md.

Contributing

• Fork & clone the repo

• Create a feature branch

• Open a PR