usage - MadBomber/aia GitHub Wiki

aia --help

AIA your AI Assistant
  - designed for generative AI workflows,
  - effortlessly manage AI prompts,
  - integrate seamlessly with shell and embedded Ruby (ERB),
  - run batch processes,
  - engage in interactive chats,
  - with user defined directives, tools and MCP clients.

Usage: aia [options] [PROMPT_ID] [CONTEXT_FILE]*
       aia --chat [PROMPT_ID] [CONTEXT_FILE]*
       aia --chat [CONTEXT_FILE]*
        --chat                       Begin a chat session with the LLM after processing all prompts in the pipeline.
    -f, --fuzzy                      Use fuzzy matching for prompt search
        --terse                      Adds a special instruction to the prompt asking the AI to keep responses short and to the point
        --adapter ADAPTER            Interface that adapts AIA to the LLM
        --available_models [QUERY]   List (then exit) available models that match the optional query - a comma separated list of AND components like: openai,mini
    -m, --model MODEL                Name of the LLM model to use
        --sm, --speech_model MODEL   Speech model to use
        --tm, --transcription_model MODEL
                                     Transcription model to use
    -c, --config_file FILE           Load config file
    -o, --[no-]out_file [FILE]       Output file (default: temp.md)
    -a, --[no-]append                Append to output file instead of overwriting
    -l, --[no-]log_file [FILE]       Log file
        --md, --[no-]markdown        Format with Markdown
        --prompts_dir DIR            Directory containing prompt files
        --roles_prefix PREFIX        Subdirectory name for role files (default: roles)
    -r, --role ROLE_ID               Role ID to prepend to prompt
    -n, --next PROMPT_ID             Next prompt to process
    -p, --pipeline PROMPTS           Pipeline of comma-seperated prompt IDs to process
    -x, --[no-]exec                  Used to designate an executable prompt file
        --system_prompt PROMPT_ID    System prompt ID to use for chat sessions
        --regex pattern              Regex pattern to extract parameters from prompt text
    -t, --temperature TEMP           Temperature for text generation
        --max_tokens TOKENS          Maximum tokens for text generation
        --top_p VALUE                Top-p sampling value
        --frequency_penalty VALUE    Frequency penalty
        --presence_penalty VALUE     Presence penalty
        --speak                      Simple implementation. Uses the speech model to convert text to audio, then plays the audio. Fun with --chat. Supports configuration of speech model and voice.
        --voice VOICE                Voice to use for speech
        --is, --image_size SIZE      Image size for image generation
        --iq, --image_quality QUALITY
                                     Image quality for image generation
        --style, --image_style STYLE Style for image generation
        --rq, --require LIBS         Ruby libraries to require for Ruby directive
        --tools PATH_LIST            Add a tool(s)
        --at, --allowed_tools TOOLS_LIST
                                     Allow only these tools to be used
        --rt, --rejected_tools TOOLS_LIST
                                     Reject these tools
    -d, --debug                      Enable debug output
        --no-debug                   Disable debug output
    -v, --[no-]verbose               Be verbose
        --refresh DAYS               Refresh models database interval in days
        --dump FILE                  Dump config to file
        --completion SHELL           Show completion script for bash|zsh|fish - default is nil
        --version                    Show version
    -h, --help                       Prints this help

Explore Further:
- AIA Report an Issue:   https://github.com/MadBomber/aia/issues
- AIA Documentation:     https://github.com/madbomber/aia/blob/main/README.md
- AIA GitHub Repository: https://github.com/MadBomber/aia
- PromptManager Docs:    https://github.com/MadBomber/prompt_manager/blob/main/README.md
- ERB Documentation:     https://rubyapi.org/o/erb
- RubyLLM Tool Docs:     https://rubyllm.com/guides/tools
- MCP Client Docs:       https://github.com/patvice/ruby_llm-mcp/blob/main/README.md