Andur 🗡️ Scout & Bridge

The Intelligent Bridge between Production Logs and Agentic Fixing.

Andur is a developer tool designed to automate the triage and handover of production errors to autonomous agents. It acts as a Scout, extracting rich context and impact analysis from your logs, and a Bridge, initiating fix sessions directly on agentic platforms like Jules.

🌟 The "Scout & Bridge" Workflow

1. Scout: Andur fetches errors from New Relic, groups them by signature, and performs an AI-driven impact and cause analysis.
2. Bridge: If a Jules API token is configured, Andur automatically prompts you to select a target repository and branch, then creates a new fix session with a comprehensive "Handover Report".

🚀 Key Features

• Log Ingestion: Deep integration with New Relic (NRQL) to fetch and group transaction errors.
• AI Diagnosis: Automatic analysis of stack traces using Gemini or OpenAI to identify root causes.
• Automated Handover: Direct integration with the Jules Service API (v1alpha) to start fixing sessions.
• Impact Tracking: Calculates how much each error group contributes to your total error volume.
• Fix Status: Persistently tracks which errors have already been sent to Jules to avoid duplicate work.
• Usage & Cost Tracking: Built-in monitoring of AI token consumption and estimated costs.

📦 Installation

npm install -g andur

🛠️ Configuration

Initialize your project configuration interactively:

andur init

Environment Variables

Andur requires API keys to function. Set these in your .env or environment:

# Log Provider (New Relic)
ANDUR_LOGS_ACCOUNT_ID="your-id"
ANDUR_LOGS_API_KEY="your-key"

# AI Provider (Gemini/OpenAI)
ANDUR_AI_API_KEY="your-key"

# Jules Service Handover
ANDUR_JULES_API_TOKEN="your-token"

andur.config.js

module.exports = {
  logs: {
    provider: 'new-relic',
    since: '1 day ago',
    limit: 100
  },
  ai: {
    provider: 'gemini',
    model: 'gemini-2.0-flash-exp'
  },
  repo: {
    branch: 'develop' // Default target branch for fixes
  }
};

⌨️ Command Reference

| Command | Description | | :--- | :--- | | andur init | Set up configuration interactively | | andur analyze | Scout recent logs and generate AI insights | | andur fix | Select an error and bridge it to Jules Service | | andur fix --all | Send all unhandled error groups to Jules in batch | | andur usage-details | View token usage and cost estimation |

🛡️ License

MIT © Rivendev