Local CLI agents

Ruru connects to the command-line agents you already have installed on your Mac, executing them through your login shell so they inherit your full terminal environment.

Login shell execution

Unlike traditional GUI apps that run in an isolated sandbox with a stripped-down system environment, Ruru invokes CLI agents directly through your interactive login shell.

Inherited Paths: Ruru inherits tool paths configured in your ~/.zshrc or ~/.bash_profile, including Homebrew (/opt/homebrew/bin), Node, Pyenv, and Cargo.
Active Project Root: Commands execute in the working directory of the application or folder you are currently working in.

Supported CLI agents

Ruru includes ready-to-use presets for popular CLI agents:

Claude Code: Anthropic's terminal agent (claude).
Antigravity: Google's agentic CLI tool (agy).
Ollama: Local, air-gapped inference on Apple Silicon (Llama 3, DeepSeek, Qwen).
Other Tools: Codex, Grok, Cursor Agent, Pi, Hermes, OpenCode, or custom command scripts.

Adding a custom CLI agent

Open Settings (⌘ + ,) > Agents > Add Agent > CLI:

yaml

# CLI Agent Configuration
Preset: Custom Command
Binary: claude          # or /opt/homebrew/bin/claude
Arguments: --print --non-interactive
Working Directory: inherit

Terminal handoff (⌘ Return)

When a task requires interactive input, multi-file inspection, or a longer debugging conversation, you can hand the turn over to your terminal:

Press ⌘ Command + Return in the composer. Ruru hands off the prompt and context directly to your configured terminal emulator (Terminal.app, iTerm2, Ghostty, Warp, or WezTerm).