Documentation

How to install, use and set up Omni AI CLI: chat commands, models, accounts, keys, modes, server and Docker.

• How it worksFrom the typed line to the saved answer. The chat (omniai/chat/) does not call any AI directly: it launches the router (omniai/cli/) as a subprocess and…
• InstallationOne command installs everything and, run again, updates it. Your accounts, keys and models live in ~/.config/smart-ai and are left untouched.
• How to useThe first time, it asks for the language and offers to install the missing tools (Claude Code, Codex, Cursor, Grok Build) with the official installers.…
• Editor extensionOmni AI CLI — the same chat experience inside VS Code and Cursor (sidebar and editor tab), running on top of ai.
• Chat commandsWhile the queue is running, /clear, /new, /resume, /key, /usage and the native commands wait: they take over the terminal or switch the session.…
• ModelsThe priority order is: environment variable, then what was saved with /model (in ~/.config/smart-ai/models.json), then the default. The variables are…
• Claude accountsAccounts are tried in priority order. The one that hits its limit goes on cooldown (60 minutes by default, adjustable in profiles.json) and the next one…
• Browserless loginOn a server, in a container or over SSH, open the link on another device:
• API keysBesides subscriptions, each tool accepts an API key. The subscription comes first; the key only comes in when the subscription fails or hits its limit,…
• ModesThe mode applies to Claude, Codex and Antigravity at once and shows in the prompt (ai [auto · plan] ›). Each session keeps its own.
• Skills and MCPBefore running a project skill, the chat shows its path. A project skill replaces yours of the same name, and links leaving the project are ignored.
• Direct use, no chatDirect use, no chat: documentation for Omni AI CLI, the chat terminal that brings several AI tools together.
• Server modeai serve exposes the router as an OpenAI-compatible API. It uses the same logins, keys, accounts, cooldowns and fallbacks as the CLI.
• DockerAn image with Omni and the CLIs at pinned versions, to run ai serve on your own server. It includes Claude Code, Codex, Cursor and Grok. Antigravity is…
• Where files liveWhere files live: documentation for Omni AI CLI, the chat terminal that brings several AI tools together.
• TroubleshootingTroubleshooting: documentation for Omni AI CLI, the chat terminal that brings several AI tools together.
• Known limitationsIf a tool fails after changing files, the next one receives their list and continues from there. Nothing is undone: it can inherit something incomplete,…
• PrivacyIf a tool fails after changing files, a copy of them stays only on your machine, readable only by your user. Sessions, API keys and logs stay only on…