OMGA

The agent that grows with you
A self-improving AI coding agent for the terminal — memory, skills, and tools that compound across sessions.

Why OMGA

   ___  __  __  ____    _
  / _ \|  \/  |/ ___|  / \
 | | | | |\/| | |  _  / _ \
 | |_| | |  | | |_| |/ ___ \
  \___/|_|  |_|\____/_/   \_\

Install

One-liner (Linux / macOS / WSL)

curl -fsSL https://raw.githubusercontent.com/isPoori/omga/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/isPoori/omga/main/install.ps1 | iex

npm

Package name on the registry is omgacli (the CLI binary is still omga):

npm i -g omgacli

If you hit EACCES / permission denied under /usr/lib/node_modules, install into your user prefix instead of using sudo:

mkdir -p "$HOME/.local"
npm i -g omgacli --prefix "$HOME/.local"
export PATH="$HOME/.local/bin:$PATH"

To make that permanent:

npm config set prefix "$HOME/.local"
# add to ~/.bashrc or ~/.zshrc:
# export PATH="$HOME/.local/bin:$PATH"

pip / source

pip install omga-cli
# or
git clone https://github.com/isPoori/omga.git && cd omga && pip install -e .

Then:

omga
omga doctor
omga doctor --fix

Quick start

omga                 Start a session
omga init            Setup wizard
omga config          Show config
omga doctor          Diagnostics
omga version

In-session

/ask /plan /agent /think /debug /review
/key       Set API key
/proxy     7890 · off · test
/model     Pick model
/provider  Switch provider
/memory    Browse long-term memory
/skills    Browse playbooks
/help      Shortcuts

Proxy tips (OpenRouter / Cloudflare / Clash):

/proxy 7890                          # HTTP proxy on localhost
/proxy socks5://127.0.0.1:1080       # SOCKS5 (DNS via proxy)
/proxy off                           # Force direct — ignore env proxy
/proxy clear                         # Fall back to HTTPS_PROXY env
/proxy test                          # Probe OpenRouter via curl + Python

Layout

agent/      conversation loop, prompt tiers, compression
tools/      file, edit, shell, git, memory, skills, delegate
providers/  openrouter, openai, anthropic, groq, ollama, …
ui/         keyboard-first Unicode TUI
cli/        entrypoint, slash commands, doctor
memory/     SQLite + FTS5 + USER.md / MEMORY.md
skills/     agentskills.io playbooks
context/    AGENTS.md / .omga rules
config/     YAML config + secrets.json
core/       models, paths, errors, version, wizard
website/    GitHub Pages docs

Config: ~/.config/omga/config.yaml · Keys: secrets.json · State: state.sqlite

See config.example.yaml · DEPLOY.md · docs site

Community

• Contributing · Code of Conduct · Security · Accessibility

_{Built by Pouria Hosseini · MIT}