don

README

Don

Don is an AI agent that connects Large Language Models (LLMs) directly to command-line tools, enabling autonomous task execution without requiring a separate MCP client.

Features

• Direct LLM connectivity: Connect to OpenAI, Anthropic, Ollama, and other LLM providers
• Multi-agent architecture: Uses orchestrator and tool-runner agents for complex task execution
• RAG support: Retrieval-Augmented Generation for document-based Q&A
• Flexible configuration: YAML-based configuration with environment variable substitution
• Multiple retrieval strategies: Chunked embeddings, BM25, and hybrid search

Quick Start

1. Create an agent configuration file at ~/.don/agent.yaml:

   agent:
     models:
       - model: "gpt-4o"
         class: "openai"
         name: "gpt-4o"
         default: true
         api-key: "${OPENAI_API_KEY}"
         api-url: "https://api.openai.com/v1"
   

2. Set your API key:

   export OPENAI_API_KEY="sk-..."
   

3. Run the agent with a tools configuration:

   don --tools=examples/tools.yaml "Help me debug this issue"
   

Installation

go install github.com/inercia/don@latest

Or build from source:

git clone https://github.com/inercia/don
cd don
make build

Usage

Basic Usage

# Run with a specific model
don --tools=tools.yaml --model gpt-4o "Your question here"

# One-shot mode (exit after response)
don --tools=tools.yaml --once "What's the disk usage?"

# Interactive mode
don --tools=tools.yaml

With RAG

# Enable RAG sources from config
don --tools=tools.yaml --rag=docs "What does the documentation say about X?"

Subcommands

# Show agent configuration
don info

# Create default configuration
don config create

# Show current configuration
don config show

Configuration

See the Configuration Guide for detailed configuration options.

Documentation

• Usage Guide - Getting started and basic usage
• Configuration - Agent and model configuration
• RAG Guide - Using Retrieval-Augmented Generation
• Architecture - Technical architecture and design

License

This project is licensed under the MIT License - see the LICENSE file for details.

Documentation

Overview

Package main is the entry point for the don CLI application.

don is an AI agent that connects Large Language Models to command-line tools. It provides direct LLM connectivity without requiring a separate MCP client.