Integrations

Terminal Genie

Fix broken shell commands instantly using Engram's local intelligence. No copy-pasting required—just type ??.

Setup

To enable the ?? alias, you need to add a hook to your shell configuration.

01Locate the Script

Ensure you know the path to your Engram installation. The magic script lives at:

bash

path/to/engram-os/cli/genie.py

02Configure your Shell

Add the following function to your ~/.zshrc (macOS) or ~/.bashrc (Linux):

bash

# --- Engram Terminal Genie ---
function terminal_genie() {
    # 1. Grab the last command from history
    LAST_CMD=$(fc -ln -1)
    
    # 2. Send it to Engram
    # REPLACE THIS PATH with your actual project path
    python3 ~/path/to/engram-os/cli/genie.py "$LAST_CMD"
}

# 3. Create the alias
alias '??'='terminal_genie'

03Apply Changes

Restart your terminal or source your configuration file:

bash

source ~/.zshrc

Troubleshooting

Connection Refused?

If the Genie cannot connect, ensure Ollama is running and allowing external connections. You may need to set the host environment variable:

launchctl setenv OLLAMA_HOST "0.0.0.0"