AI Command Line Tool

Usage:
  ai [OPTIONS] [@AGENT] MESSAGE...

Examples:

ai what is fish
ai / what is fish
ai @ask what is fish


Use "ai /help [agents|commands|tools|info]" for more information.

AI Command Line Tool

Usage:
  ai [OPTIONS] [@AGENT] MESSAGE...

There are multiple ways to interact with this AI tool.

+ Command line input:

  ai @agent what is fish?

+ Read from standard input:

  ai @agent --stdin
  ai @agent -

Ctrl+D to send, Ctrl+C to cancel.

+ Here document:

  ai @agent <<eof
what is the weather today?
eof

+ Piping input:

  git diff origin/main | ai @agent [message...]

+ File redirection:

  ai @agent [message...] < file.txt

+ Reading from system clipboard:

  ai @agent [message...] --pb-read
  ai @agent [message...] {
  ai @agent [message...] --pb-read-wait
  ai @agent [message...] {{

Use system copy (Ctrl+C on Unix) to add selected contents.
Ctrl+C to cancel.

+ Composing with text editor:

  export AI_EDITOR=nano # default: vi
  ai @agent


Miscellaneous:

  ai /mcp                        Manage MCP server
  ai /setup                      Setup configuration


Options:
  -a, --agent string         Specify the agent to use or @agent
      --allow string         List of comma separated system commands allowed for tool calls
      --api-key string       LLM API key
      --base-url string      LLM Base URL
      --config string        config file (default "/Users/liqiang/.ai/config.yaml")
      --deny string          List of comma separated system commands disallowed for tool calls. Approval is required to proceed. Ignored if 'unsafe' is true (default "rm")
  -e, --edit                 Launch editor
      --editor string        Specify the editor to use. default: builtin
      --format string        Output format: raw, text, json, or markdown. (default "markdown")
  -h, --help                 help for ai
      --image-model string   Image LLM model
      --input string         Read input message from a file
  -i, --interactive          Interactive mode
      --l1-model string      Level1 basic LLM model
      --l2-model string      Level2 standard LLM model
      --l3-model string      Level3 advanced LLM model
      --max-turns int        Max number of turns (default 16)
      --model string         LLM default model
  -n, --new                  Start a new converston
      --output string        Save final response to a file.
      --pb-read              Read input from clipboard or '{'
      --pb-read-wait         Read input from clipboard and wait or '{{'
      --pb-write             Copy output to clipboard or '}'
      --pb-write-append      Append output to clipboard or '}}'
      --quiet                Operate quietly. Only show final response
      --shell string         Shell to use for interactive mode (default "/bin/bash")
      --stdin                Read input from stdin or '-'
      --unsafe               Skip command security check to allow unsafe operations. Use with caution
      --verbose              Show progress and debugging information
  -v, --version              version for ai

Environment variables:
  AI_AGENT, AI_ALLOW, AI_API_KEY, AI_BASE_URL, AI_CONFIG, AI_CONTENT, AI_DENY, AI_DRY_RUN, AI_DRY_RUN_CONTENT, AI_EDIT, AI_EDITOR, AI_FILE, AI_FORMAT, AI_HELP, AI_HOST, AI_IMAGE_API_KEY, AI_IMAGE_BASE_URL, AI_IMAGE_MODEL, AI_IMAGE_VIEWER, AI_INPUT, AI_INTERACTIVE, AI_INTERNAL, AI_L1_API_KEY, AI_L1_BASE_URL, AI_L1_MODEL, AI_L2_API_KEY, AI_L2_BASE_URL, AI_L2_MODEL, AI_L3_API_KEY, AI_L3_BASE_URL, AI_L3_MODEL, AI_LOG, AI_MAX_HISTORY, AI_MAX_SPAN, AI_MAX_TIME, AI_MAX_TURNS, AI_MCP_SERVER_URL, AI_MESSAGE, AI_MODEL, AI_NEW, AI_OUTPUT, AI_PB_READ, AI_PB_READ_WAIT, AI_PB_WRITE, AI_PB_WRITE_APPEND, AI_PORT, AI_QUIET, AI_ROLE, AI_ROLE_PROMPT, AI_SHELL, AI_SQL_DB_HOST, AI_SQL_DB_NAME, AI_SQL_DB_PASSWORD, AI_SQL_DB_PORT, AI_SQL_DB_USERNAME, AI_STDIN, AI_TEMPLATE, AI_UNSAFE, AI_VERBOSE, AI_VERSION, AI_WATCH, AI_WORKSPACE

Use "ai /help [agents|commands|tools|info]" for more information.

ai.git@main/. ai> help
  exit                     │  exit ai shell
  history [-c]             │  display or clear command history
  alias [name[=value]      │  set or print aliases
  env [name[=value]        │  export or print environment
  source [file]            │  set alias and environment from file
  edit [file]              │  text editor
  explore [--help] [path]  │  explore local file system
  | page                   │  similar to more or less
  help                     │  help for ai shell
  @[agent]                 │  agent command
  /[command]               │  slash (shell agent) command

  Key Bindings:
  Ctrl + A	Go to the beginning of the line (Home)
  Ctrl + E	Go to the end of the line (End)
  Ctrl + P	Previous command (Up arrow)
  Ctrl + N	Next command (Down arrow)
  Ctrl + F	Forward one character
  Ctrl + B	Backward one character
  Ctrl + D	Delete character under the cursor
  Ctrl + H	Delete character before the cursor (Backspace)
  Ctrl + W	Cut the word before the cursor to the clipboard
  Ctrl + K	Cut the line after the cursor to the clipboard
  Ctrl + U	Cut the line before the cursor to the clipboard
  Ctrl + L	Clear the screen