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

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

➡ 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