aidevops 2.52.1

package/.agent/tools/context/augment-context-engine.md

@@ -0,0 +1,468 @@
+---
+description: Augment Context Engine for codebase semantic search
+mode: subagent
+tools:
+  read: true
+  write: false
+  edit: false
+  bash: false
+  glob: true
+  grep: true
+  webfetch: false
+  task: true
+---
+
+# Augment Context Engine MCP Setup
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Purpose**: Semantic codebase retrieval via Augment's context engine
+- **Install**: `npm install -g @augmentcode/auggie@prerelease`
+- **Auth**: `auggie login` (credentials in `~/.augment/session.json`)
+- **MCP Tool**: `codebase-retrieval`
+- **Docs**: <https://docs.augmentcode.com/context-services/mcp/overview>
+
+**OpenCode Config**:
+
+```json
+"augment-context-engine": {
+  "type": "local",
+  "command": ["auggie", "--mcp"],
+  "enabled": true
+}
+```
+
+**Verification Prompt**:
+
+```text
+What is this project? Please use codebase retrieval tool to get the answer.
+```
+
+**Supported AI Tools**: OpenCode, Claude Code, Cursor, Zed, GitHub Copilot,
+Kilo Code, Kiro, AntiGravity, Gemini CLI, Droid (Factory.AI)
+
+**Enabled for Agents**: All 14 primary agents (as fallback to osgrep)
+
+**Usage Strategy**: Augment Context Engine is the **fallback** semantic search
+tool. Try osgrep first (local, no auth). Use Augment when:
+- osgrep returns insufficient results
+- You need cloud sync or team features
+- osgrep is unavailable or failing
+
+<!-- AI-CONTEXT-END -->
+
+## What It Does
+
+The Augment Context Engine provides **semantic codebase retrieval** - understanding
+your code at a deeper level than simple text search:
+
+| Feature | grep/glob | Augment Context Engine |
+|---------|-----------|------------------------|
+| Text matching | Exact patterns | Semantic understanding |
+| Cross-file context | Manual | Automatic |
+| Code relationships | None | Understands dependencies |
+| Natural language | No | Yes |
+
+Use it to:
+
+- Find related code across your entire codebase
+- Understand project architecture quickly
+- Discover patterns and implementations
+- Get context-aware code suggestions
+
+## Prerequisites
+
+- **Node.js 22+** required
+- **Augment account** (free tier available at <https://augmentcode.com>)
+
+Check Node.js version:
+
+```bash
+node --version  # Must be v22.x or higher
+```
+
+## Installation
+
+### 1. Install Auggie CLI
+
+```bash
+npm install -g @augmentcode/auggie@prerelease
+```
+
+### 2. Authenticate
+
+```bash
+auggie login
+```
+
+This opens a browser for authentication. Credentials are stored in
+`~/.augment/session.json`.
+
+### 3. Verify Installation
+
+```bash
+auggie token print
+```
+
+Should output your access token (confirms authentication is working).
+
+## AI Tool Configurations
+
+### OpenCode
+
+Edit `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "mcp": {
+    "augment-context-engine": {
+      "type": "local",
+      "command": ["auggie", "--mcp"],
+      "enabled": true
+    }
+  },
+  "tools": {
+    "augment-context-engine_*": false
+  }
+}
+```
+
+Then enable per-agent in the `agent` section:
+
+```json
+"agent": {
+  "Build+": {
+    "tools": {
+      "augment-context-engine_*": true
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add via CLI command:
+
+```bash
+# User scope (all projects)
+claude mcp add-json auggie-mcp --scope user '{"type":"stdio","command":"auggie","args":["--mcp"]}'
+
+# Project scope (current project only)
+claude mcp add-json auggie-mcp --scope project '{"type":"stdio","command":"auggie","args":["--mcp"]}'
+
+# With specific workspace
+claude mcp add-json auggie-mcp --scope user '{"type":"stdio","command":"auggie","args":["-w","/path/to/project","--mcp"]}'
+```
+
+### Cursor
+
+Go to Settings → Tools & MCP → New MCP Server.
+
+**macOS/Linux**:
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "bash",
+      "args": ["-c", "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""]
+    }
+  }
+}
+```
+
+**Windows**:
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "powershell",
+      "args": ["-Command", "auggie --mcp -m default -w \"($env:WORKSPACE_FOLDER_PATHS -split ',')[0]\""]
+    }
+  }
+}
+```
+
+### Zed
+
+Click ··· → Add Custom Server.
+
+**macOS/Linux**:
+
+```json
+{
+  "Augment-Context-Engine": {
+    "command": "bash",
+    "args": ["-c", "auggie -m default --mcp -w $(pwd)"],
+    "env": {}
+  }
+}
+```
+
+**Windows** (update path):
+
+```json
+{
+  "Augment-Context-Engine": {
+    "command": "auggie",
+    "args": ["--mcp", "-m", "default", "-w", "/path/to/your/project"],
+    "env": {}
+  }
+}
+```
+
+### GitHub Copilot
+
+Create `.vscode/mcp.json` in your project root:
+
+```json
+{
+  "servers": {
+    "augmentcode": {
+      "type": "stdio",
+      "command": "auggie",
+      "args": ["--mcp", "-m", "default"]
+    }
+  },
+  "inputs": []
+}
+```
+
+**Note**: Use in Agent mode for codebase retrieval.
+
+### Kilo Code
+
+Click MCP server icon → Edit Global MCP:
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "auggie",
+      "type": "stdio",
+      "args": ["--mcp"],
+      "disabled": false,
+      "alwaysAllow": ["codebase-retrieval"]
+    }
+  }
+}
+```
+
+### Kiro
+
+Open command palette (Cmd+Shift+P / Ctrl+Shift+P):
+
+- **Kiro: Open workspace MCP config (JSON)** - For workspace level
+- **Kiro: Open user MCP config (JSON)** - For user level
+
+```json
+{
+  "mcpServers": {
+    "Augment-Context-Engine": {
+      "command": "auggie",
+      "args": ["--mcp", "-m", "default", "-w", "./"],
+      "disabled": false,
+      "autoApprove": ["codebase-retrieval"]
+    }
+  }
+}
+```
+
+### AntiGravity
+
+Click MCP server icon → Manage MCP server → View raw config:
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "auggie",
+      "args": ["--mcp", "-m", "default", "-w", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+**Note**: Update `/path/to/your/project` with your actual project path.
+
+### Gemini CLI
+
+Edit `~/.gemini/settings.json` (user level) or `.gemini/settings.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "auggie",
+      "args": ["--mcp"]
+    }
+  }
+}
+```
+
+With specific workspace:
+
+```json
+{
+  "mcpServers": {
+    "augment-context-engine": {
+      "command": "auggie",
+      "args": ["-w", "/path/to/project", "--mcp"]
+    }
+  }
+}
+```
+
+### Droid (Factory.AI)
+
+Add via CLI:
+
+```bash
+droid mcp add augment-code "auggie" --mcp
+
+# With specific workspace
+droid mcp add augment-code "auggie" -w /path/to/project --mcp
+```
+
+## Verification
+
+After configuring any tool, test with this prompt:
+
+```text
+What is this project? Please use codebase retrieval tool to get the answer.
+```
+
+The AI should:
+
+1. Confirm access to `codebase-retrieval` tool
+2. Provide a semantic understanding of your project
+3. Describe the main components and architecture
+
+## Non-Interactive Setup (CI/CD)
+
+For automation environments where `auggie login` isn't possible:
+
+### 1. Get Authentication Token
+
+```bash
+auggie token print
+```
+
+Output:
+
+```text
+TOKEN={"accessToken":"your-access-token","tenantURL":"your-tenant-url","scopes":["read","write"]}
+```
+
+### 2. Configure Environment Variables
+
+Add to your CI/CD environment or `~/.config/aidevops/mcp-env.sh`:
+
+```bash
+export AUGMENT_API_TOKEN="your-access-token"
+export AUGMENT_API_URL="your-tenant-url"
+```
+
+### 3. Update MCP Config with Env Vars
+
+**OpenCode** (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "mcp": {
+    "augment-context-engine": {
+      "type": "local",
+      "command": ["auggie", "--mcp"],
+      "enabled": true,
+      "env": {
+        "AUGMENT_API_TOKEN": "your-access-token",
+        "AUGMENT_API_URL": "your-tenant-url"
+      }
+    }
+  }
+}
+```
+
+**Claude Code**:
+
+```bash
+claude mcp add-json auggie-mcp --scope user '{"type":"stdio","command":"auggie","args":["--mcp"],"env":{"AUGMENT_API_TOKEN":"your-access-token","AUGMENT_API_URL":"your-tenant-url"}}'
+```
+
+**Droid**:
+
+```bash
+droid mcp add augment-code "auggie" --mcp --env AUGMENT_API_TOKEN=your-access-token --env AUGMENT_API_URL=your-tenant-url
+```
+
+## Credential Storage
+
+| Method | Location | Use Case |
+|--------|----------|----------|
+| Interactive | `~/.augment/session.json` | Local development |
+| Environment | `AUGMENT_API_TOKEN` + `AUGMENT_API_URL` | CI/CD, automation |
+| aidevops pattern | `~/.config/aidevops/mcp-env.sh` | Consistent with other services |
+
+## Troubleshooting
+
+### "auggie: command not found"
+
+```bash
+# Check installation
+npm list -g @augmentcode/auggie
+
+# Reinstall
+npm install -g @augmentcode/auggie@prerelease
+```
+
+### "Node.js version too old"
+
+```bash
+# Check version
+node --version
+
+# Install Node 22+ via nvm
+nvm install 22
+nvm use 22
+
+# Or via Homebrew (macOS)
+brew install node@22
+```
+
+### "Authentication failed"
+
+```bash
+# Re-authenticate
+auggie login
+
+# Verify token
+auggie token print
+```
+
+### "MCP server not responding"
+
+1. Check if auggie is running: `ps aux | grep auggie`
+2. Restart your AI tool
+3. Verify config JSON syntax
+
+### "codebase-retrieval tool not found"
+
+1. Ensure MCP is enabled in your config
+2. Check that the agent has `augment-context-engine_*: true`
+3. Restart the AI tool after config changes
+
+## Updates
+
+Check for configuration updates at:
+<https://docs.augmentcode.com/context-services/mcp/overview>
+
+The Augment team regularly adds support for new AI tools and updates configurations.
+
+## Related Documentation
+
+- [Context Builder](context-builder.md) - Token-efficient codebase packing
+- [Context7](context7.md) - Library documentation lookup
+- [Auggie CLI Overview](https://docs.augmentcode.com/cli/overview)

package/.agent/tools/context/context-builder-agent.md

@@ -0,0 +1,76 @@
+---
+description: "[UTILITY-1] Context Builder - token-efficient AI context generation. Use BEFORE complex coding tasks. Parallel with any workflow"
+mode: subagent
+temperature: 0.1
+tools:
+  bash: true
+  read: true
+  write: true
+  glob: true
+  repomix_*: true
+  task: true
+---
+
+# Context Builder Agent
+
+Specialized agent for generating token-efficient context for AI coding assistants.
+
+## Purpose
+
+Generate optimized repository context using Repomix with Tree-sitter compression.
+Achieves ~80% token reduction while preserving code structure understanding.
+
+## Reference Documentation
+
+Read `~/Git/aidevops/.agent/context-builder.md` for complete operational guidance.
+
+## Available Commands
+
+```bash
+# Helper script location
+~/Git/aidevops/.agent/scripts/context-builder-helper.sh
+
+# Compress mode (recommended) - ~80% token reduction
+context-builder-helper.sh compress [path] [style]
+
+# Full pack with smart defaults
+context-builder-helper.sh pack [path] [xml|markdown|json]
+
+# Quick mode - auto-copies to clipboard
+context-builder-helper.sh quick [path] [pattern]
+
+# Analyze token usage per file
+context-builder-helper.sh analyze [path] [threshold]
+
+# Pack remote GitHub repo
+context-builder-helper.sh remote user/repo [branch]
+
+# Compare full vs compressed
+context-builder-helper.sh compare [path]
+```
+
+## Available MCP Tools (repomix_*)
+
+When Repomix MCP is enabled:
+- `repomix_pack_repository` - Pack local or remote repository
+- `repomix_read_repomix_output` - Read generated context file
+- `repomix_file_system_tree` - Get directory structure
+
+## When to Use
+
+| Scenario | Command | Token Impact |
+|----------|---------|--------------|
+| Architecture review | `compress` | ~80% reduction |
+| Full implementation details | `pack` | Full tokens |
+| Quick file subset | `quick . "**/*.ts"` | Minimal |
+| External repo analysis | `remote user/repo` | Compressed |
+
+## Output Location
+
+All context files are saved to: `~/.aidevops/.agent-workspace/work/context/`
+
+## Workflow Integration
+
+1. **Before complex tasks**: Generate compressed context first
+2. **For debugging**: Use full pack mode for specific directories
+3. **For external repos**: Use remote mode with compression