CLI Options

agsh [OPTIONS]

Options

Run a one-shot prompt and exit. The agent processes the prompt, prints its response, and the process terminates.

agsh -p "list all files larger than 1MB in the current directory"

Resume an existing session by its UUID. The session’s message history is loaded and the conversation continues.

agsh -s 550e8400-e29b-41d4-a716-446655440000

Errors if the session does not exist or is locked by another agsh instance.

Resume the most recently updated session. Equivalent to -s with the last session’s UUID.

agsh -c

Set the initial permission mode. Accepts none (or n), read (or r), write (or w). Case-insensitive.

agsh --permission write
agsh --permission w

Default: read.

Set the LLM provider. Overrides AGSH_PROVIDER and the config file.

agsh --provider anthropic

Supported values: openai, anthropic.

Set the model name. Overrides AGSH_MODEL and the config file.

agsh -m gpt-4o-mini

Set a custom API base URL. Overrides OPENAI_BASE_URL and the config file.

agsh --base-url http://localhost:11434/v1

Disable streaming mode. The agent waits for the complete response before displaying it. By default, responses are streamed token-by-token.

agsh --no-stream

Increase log verbosity. Can be repeated up to three times.

agsh -v      # info
agsh -vv     # debug
agsh -vvv    # trace

Print help information.

Print version information.