gaia AI技能包

Prerequisites

• Go 1.26 or later
• A running instance of a compatible language model API (e.g., Ollama) or an API key for OpenAI or Mistral

Dependencies

• cobra: CLI framework
• viper: Configuration management
• bubbletea: Terminal UI framework (progress bars, interactive prompts)
• bubbles: TUI components (e.g. text input for context/edit prompts)
• lipgloss: Styling and layout (boxes, colors, width-aware wrapping)

Installation

Building from Source

git clone https://github.com/vonglasow/gaia.git
cd gaia
go build

Usage

Example Usage

Basic Question

$ gaia ask "What is the meaning of life?"
The meaning of life is a philosophical question that has been debated for centuries...

Code Analysis with Piped Input

$ cat CVE-2021-4034.py | gaia ask "Analyze and explain this code"
This code is a Python script that exploits the CVE-2021-4034 vulnerability in Python...

Git Commit Message Generation

$ git diff --staged | gaia ask "generate commit message"
feat: add user authentication system

Implement JWT-based authentication with login and registration endpoints.
Add password hashing using bcrypt and session management.

Branch Name Generation

$ git diff | gaia ask "create branch name"
feature/user-authentication

Using Tools

```bash $ gaia tool git commit

Advanced Configuration Examples

Configuration

Gaia stores its configuration in ~/.config/gaia/config.yaml. The configuration file is automatically created on first run with sensible defaults.

Basic Configuration

• model: The language model to use (default: "mistral" for Ollama, "gpt-4o-mini" for OpenAI, "mistral-medium-latest" for Mistral)
• host: API host (default: "localhost" for Ollama, "api.openai.com" for OpenAI, "api.mistral.ai" for Mistral)
• port: API port (default: 11434 for Ollama, 443 for OpenAI and Mistral)

Cache Configuration

• cache.enabled: Enable/disable response caching (default: true)
• cache.dir: Cache directory path (default: ~/.config/gaia/cache)

Tool Configuration

Tools allow you to execute external commands with AI-generated content. Example configuration:

tools:
  git:
    commit:
      context_command: "git diff --staged"
      role: "commit"
      execute_command: "git commit -F {file}"
    branch:
      context_command: "git diff"
      role: "branch"
      execute_command: "git checkout -b {response}"

Tool configuration fields: - context_command: Command to run to gather context (optional) - role: Role to use for AI generation - execute_command: Command to execute with AI response (use {file} for multi-line, {response} for single-line)

Operator (Investigate) Configuration

The operator mode (gaia investigate) uses the following options (all under operator.):

• operator.max_steps: Maximum number of steps per run (default: 10)
• operator.confirm_medium_risk: Ask for confirmation before running medium-risk commands (default: true)
• operator.dry_run: If true, never execute commands; only show what would be run (default: false)
• operator.denylist: List of forbidden command patterns (e.g. ["rm -rf", "sudo", "mkfs"]). Commands containing these are blocked.
• operator.allowlist: Optional. If set, only commands that start with or contain one of these patterns are allowed (prefix or substring, case-insensitive; not regex). Example: ["df", "du", "find"].
• operator.output_max_bytes: Maximum length of command output per step (default: 4096); longer output is truncated.
• operator.command_timeout_seconds: Timeout in seconds for each shell command (default: 30).
• operator.treat_exit_code_1_as_success: When true (default), commands that exit with code 1 are treated as success and their output is returned (e.g. git diff with no changes). When false, exit code 1 is reported as an error. Useful if you want strict failure detection for all commands.

Example in config.yaml:

operator:
  max_steps: 10
  confirm_medium_risk: true
  denylist:
    - "rm -rf"
    - "sudo"
    - "mkfs"
  allowlist: []   # leave empty to allow any command not on denylist
  command_timeout_seconds: 30
  treat_exit_code_1_as_success: true   # default: git diff with no changes (exit 1) is not an error

Configuration Management

```bash

View all configuration settings

gaia config list

Get specific configuration value

gaia config get model gaia config get auto_role.enabled

Set configuration value

gaia config set model llama2 gaia config set host 127.0.0.1 gaia config set port 8080 gaia config set auto_role.mode heuristic

Show configuration file path

gaia config path

Create default configuration file

gaia config create

Explicitly specify a pre-configured role

gaia ask --role describe "ls -la" gaia ask --role shell "list files in current directory" gaia ask --role code "Hello world in Python" gaia ask --role commit "generate commit message" gaia ask --role branch "create branch name"

Use a custom role (if configured)

gaia ask --role my_custom_role "custom prompt"

1. Run the context_command (if configured) to gather context

API Providers

Use an Alternative Configuration File

```bash gaia --config /path/to/custom/config.yaml ask "Hello!"

Ask a question

gaia ask "What is the meaning of life?"