FAQ

Answers, without the hunt.

The six questions that come up most. Something missing? Open an issue.

Is there a Windows or Linux version?+

Not yet — macOS only for now. Windows and Linux may come later.

How do I use a custom LLM provider?+

Run manda ai, keep Auth Type = API key, and enter your Base URL, API Key, Simple Model, and Deep Model. API Mode: chat_completions for /v1/chat/completions, responses for /v1/responses. If the provider supports hosted search, turn on Native Web Search — no separate search key needed.

How do I customize keybindings?+

Append to config.keys — don’t replace it:

config.keys[#config.keys + 1] = {
  key = "RightArrow",
  mods = "CMD|SHIFT",
  action = wezterm.action.ActivatePaneDirection("Right"),
}

More examples: keybindings.md · configuration.md

How do I disable MANDA Assistant?+

Run manda ai → Assistant settings → Enabled: Off. Or edit ~/.config/manda/assistant.toml:

enabled = false
How do I restore default config?+
manda reset

Removes MANDA-managed shell/tmux integration, git delta defaults, state, and managed theme blocks. Your own Lua is kept. Run manda init to reinstall shell integration.

Homebrew can’t find the binary / updates the wrong package.+

An unrelated older manda package exists on Homebrew. Install MANDA with the one-liner installer instead:

curl -fsSL https://raw.githubusercontent.com/WILFREDY-X/manda/main/install/install.sh | bash
brew install WILFREDY-X/tap/manda
Get started

Download MANDA

macOS 12+ · Apple Silicon & Intel. Ad-hoc signed build — on first launch, right-click → Open, and MANDA sets up your shell environment automatically.

↓  Download latest release

Or install from the terminal

curl -fsSL https://raw.githubusercontent.com/WILFREDY-X/manda/main/install/install.sh | bash