feat: add Auggie CLI adapter

[cdhagmann]

Pull Request

FULL DISCLOSURE: I did this development using Auggie CLI. I have review everything manually as well and am using this locally for my development. But I would treat it as AI-generated code, and not human-generated code.

Description

Adds support for Auggie CLI (Augment Code's agentic terminal tool) as a new AI adapter in git gtr. Users can now launch Auggie in worktrees using git gtr ai <branch> --ai auggie or set it as the default AI tool with git gtr config set gtr.ai.default auggie.

Motivation

Auggie CLI is Augment Code's context-aware agentic CLI tool for automation and development workflows. Adding native support for Auggie enables teams using git gtr to seamlessly integrate Auggie into their worktree-based development workflow, allowing parallel AI-assisted development across multiple branches.

This complements the existing AI tool adapters (Aider, Claude Code, Codex, Continue, Copilot, Cursor, Gemini, OpenCode) and provides first-class support for Augment's CLI offering.

Fixes # (issue)

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code refactoring (no functional changes)
• Other (please describe):

Testing

Manual Testing Checklist

Tested on:

• macOS
• Linux (specify distro: **_**)
• Windows (Git Bash)

Core functionality tested:

• git gtr new <branch> - Create worktree
• git gtr go <branch> - Navigate to worktree
• git gtr editor <branch> - Open in editor (if applicable)
• git gtr ai <branch> - Start AI tool (Auggie adapter)
• git gtr rm <branch> - Remove worktree
• git gtr list - List worktrees
• git gtr config - Configuration commands (set gtr.ai.default auggie)
• Other commands affected by this change: git gtr adapter (lists Auggie), git gtr doctor (checks Auggie availability)

Test Steps

1. Install Auggie CLI: npm install -g @augmentcode/auggie
2. Verify installation: which auggie (should show path to auggie binary)
3. Set Auggie as default AI tool: git gtr config set gtr.ai.default auggie
4. Create a test worktree: git gtr new test-auggie
5. Start Auggie in worktree: git gtr ai test-auggie
6. Verify Auggie starts in the correct directory
7. Test with explicit flag: git gtr ai test-auggie --ai auggie
8. Test adapter detection: git gtr adapter (should list auggie as available)
9. Test doctor command: git gtr doctor (should show auggie status)

Expected behavior:

• Auggie CLI launches in the worktree directory
• Configuration commands work correctly
• Adapter is listed in git gtr adapter output
• Help text shows auggie in available AI tools list
• Error message if auggie not installed provides installation instructions

Actual behavior:

• ✅ All expected behaviors confirmed
• ✅ Auggie launches successfully in worktree directory (tested with ./bin/gtr)
• ✅ Configuration persists correctly (./bin/gtr config set gtr.ai.default auggie)
• ✅ Adapter detection works (./bin/gtr adapter shows auggie as [ready])
• ✅ Help text updated with auggie option (./bin/gtr help shows auggie in AI tools list)
• ✅ Doctor command shows auggie status (./bin/gtr doctor shows "AI tool: auggie (found)")
• ✅ Works with explicit flag: ./bin/gtr ai test-branch --ai auggie
• ✅ Works with default config: ./bin/gtr ai test-branch (when auggie is default)

Breaking Changes

• This PR introduces breaking changes
• I have discussed this in an issue first
• Migration guide is included in documentation

No breaking changes. This is a purely additive feature that adds a new AI adapter without modifying existing functionality.

Checklist

Before submitting this PR, please check:

• I have read CONTRIBUTING.md
• My code follows the project's style guidelines (bash shebang, set -e, quoted variables, snake_case, 2-space indentation)
• I have performed manual testing on at least one platform
• I have updated documentation (README.md, docs/configuration.md) if needed
  • Note: Did not update CLAUDE.md as it's an AI development guide and this is a user-facing feature
• My changes work on multiple platforms (or I've noted platform-specific behavior)
  • Note: Only tested on macOS. The adapter follows the same pattern as other AI adapters (uses command -v for detection and standard bash constructs), so it should work cross-platform, but this needs verification on Linux and Windows (Git Bash).
• I have added/updated shell completions (if adding new commands or flags)
  • Note: Updated completions/_git-gtr (zsh). Bash and Fish completions don't have AI tool name completions (they only complete commands and branch names).
• I have tested with both git gtr (production) and ./bin/gtr (development)
• No new external dependencies are introduced (Bash + git only)
  • Note: Users must install Auggie CLI separately (npm install -g @augmentcode/auggie), same pattern as other AI adapters
• All existing functionality still works

Additional Context

Files Changed

New files:

• adapters/ai/auggie.sh - Auggie CLI adapter implementation

Modified files:

• bin/gtr - Updated help text and adapter loading to include auggie
• README.md - Added auggie to AI tools list
• docs/configuration.md - Added auggie to supported AI tools table
• completions/_git-gtr - Added auggie to zsh completions

Adapter Implementation

The Auggie adapter follows the standard AI adapter contract:

• ai_can_start() - Checks if auggie command is available
• ai_start(path, args...) - Launches Auggie in the specified worktree directory

Installation instructions and documentation link are provided in error messages when auggie is not found.

External Dependency

Note: While git gtr itself has no new dependencies, users who want to use the Auggie adapter must install Auggie CLI separately:

npm install -g @augmentcode/auggie

This follows the same pattern as other AI tool adapters (aider, claude, etc.) which require separate installation of the respective tools.

---

License Acknowledgment

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache License 2.0.

Summary by CodeRabbit

• New Features

  • Added Auggie as an available AI tool option, expanding the list of supported AI integrations.

• Documentation

  • Updated configuration documentation to include Auggie CLI setup and installation guidance.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

This PR introduces support for the Auggie AI tool by adding a new Bash adapter script, updating configuration files and documentation to expose auggie as an available AI tool option alongside existing tools like claude, copilot, and cursor.

Changes

Cohort / File(s)	Summary
AI Adapter Implementation adapters/ai/auggie.sh	New Bash adapter implementing Auggie CLI support with two functions: ai_can_start() validates auggie binary presence, ai_start() validates target directory and executes auggie with provided arguments
Configuration & CLI Updates bin/gtr, completions/_git-gtr, README.md	Updated built-in AI adapter lists and user-facing documentation to include auggie as an available AI tool option
Documentation docs/configuration.md	Added Auggie CLI entry to configuration documentation table with installation command and default configuration example

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A new tool hops into the stable,
Auggie joins the AI table,
With validation crisp and clean,
The finest adapter you've ever seen!
Configuration updates with care,
AI options everywhere! 🌟

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: add Auggie CLI adapter' directly and clearly describes the main change: adding a new Auggie CLI adapter to the codebase. It accurately reflects the primary purpose of this pull request.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@completions/_git-gtr`:
- Line 94: The AI tool completion lists are missing the new "auggie" adapter:
update the _arguments line in both completions/gtr.bash and completions/gtr.fish
to include "auggie" in the tool list (the same place as other tools in the
`_arguments '--ai[AI tool to use]:tool:(...)'` entry) so that the completions
match the updated _git-gtr adapter set.