AI Tools

Guide to using AI tools effectively in your development workflow.

Tool Overview

Feature	CodeCompanion	Supermaven	Database AI
Type	Chat + Inline	Completion	SQL-specific
API	Google Gemini	Proprietary	Built-in miudb
Strength	Complex problems	Real-time coding	SQL queries
Best For	Architecture, debugging	Day-to-day coding	Database work
Keybindings	Leader-based	Auto-trigger	Context-aware

Codex CLI

Codex is managed from this dotfiles repo through GNU Stow. See Codex for the repo-owned ~/.codex/config.toml, enabled features, /goal troubleshooting, MCP setup, and plugin checks.

Claude Code via CLI Proxy

ccx sends one Claude Code session through the CLI Proxy gateway. Plain claude keeps the logged-in user. See Claude Code via CLI Proxy for install, effort, context windows, and examples for GPT, Opus, Grok, GLM, and Muse. CLI Proxy model status records which catalog ids answer. Invoke /cli-proxy-models in this repo to refresh it.

Cursor Agent CLI

Cursor Agent CLI is managed the same way. See Cursor Agent CLI for the repo-owned ~/.cursor/cli-config.json, attribution opt-out, and local-state guidance.

Grok CLI

Grok is managed the same way. See Grok for the repo-owned ~/.grok/config.toml, native hooks, Claude/Cursor compatibility, and MCP setup.

pi

pi’s user settings (~/.pi/agent/settings.json) are stowed from this repo, including the extension list. See pi for package restore on a fresh machine and Langfuse tracing via the official pi-langfuse extension.

Quick Start

# CodeCompanion (Chat with Gemini)
<leader>ac  # Open AI chat
<leader>aa  # AI actions menu
<leader>ar  # Code review
<leader>af  # Quick fixes

# Supermaven (Completion - auto-triggers)
# Just start typing, suggestions appear automatically
# Tab to accept, Ctrl+] to dismiss

Documentation

Codex CLI config, features, goals, MCP, and plugin checks for the Codex terminal agent.

Claude Code via CLI Proxy ccx runs Claude Code through CLI Proxy. Plain claude keeps the logged-in user.

CLI Proxy model status Which catalog ids answer through ccx, images, or video, and how to refresh the record.

Cursor Agent CLI cli-config.json, attribution opt-out, and local-state rules for the Cursor agent CLI.

Grok CLI config, native hooks, Claude/Cursor compat, and MCP for the Grok terminal agent.

pi Stowed settings.json, package restore, and Langfuse tracing for the pi agent.

Workflows Daily AI workflows: code development, database AI, and common patterns.

Best Practices Effective prompting, security guidance, and productivity tips.