Using Crosshatch in iTerm2

iTerm2 is a popular terminal emulator for macOS that recently introduced several new AI integrations.

Because iTerm's AI features allow you to customize the API base URL, it's simple to set up with Crosshatch.

1. First, create a free Crosshatch account, and visit the API Keys page.

2. Generate a new API Key for "iTerm2" and copy the key to your clipboard

   
3. Open the iTerm2 "Settings" menu and go to the "AI" tab within "General":

   
4. Install the required plugins and check the "Enable Generative AI features" checkbox.

5. In the "OpenAI API Key" field, enter the Crosshatch API Key you generated in step 2

6. Next, find the Model Mix from the Crosshatch Mixes directory that you wish to use.

7. Copy the mix name and the "Base URL" from the Crosshatch site. For this example, we'll use the LMSys Coding Leaderboard mix.

   
8. Paste those values into the "Model" and "Custom URL" fields in the iTerm2 settings.

9. Add /chat/completions to the end of the Custom URL. The result should look like this:

   

Test the integration

To test, you can press Edit -> Engage Artificial Intelligence (or ⌘Y) to bring up an editor where you can ask using human language, or use the "Codecierge" feature in the Toolbelt for a copilot experience.

That's it!

Now you're free to use the great AI features in iTerm2 with the powerful Model Mixes from Crosshatch!

If something didn't quite work, we're ready to help on Discord and X.