Skip to content

CLI reference

Generated from one/cli/args.py by scripts/generate_docs_reference.py. The declarations below show parser defaults and constraints, not every runtime validation rule. one run is a public subcommand: it accepts a task (including @file) and the run-specific options below. Other subcommands include doctor, install, remove, update, list, and config; their own arguments are not fully described by the shared parser. Consult one --help, the subcommand help, and one/cli/main.py for dispatch and validation. See automation.

parser.add_argument('messages', nargs='*')
parser.add_argument('--help', '-h', action='store_true')
parser.add_argument('--version', '-v', action='store_true')
parser.add_argument('--provider')
parser.add_argument('--model')
parser.add_argument('--api-key')
parser.add_argument('--llama-cpp-url')
parser.add_argument('--ollama-url')
parser.add_argument('--system-prompt')
parser.add_argument('--append-system-prompt')
parser.add_argument('--preset')
parser.add_argument('--thinking')
parser.add_argument('--temperature')
parser.add_argument('--temperature-mode')
parser.add_argument('--continue', '-c', dest='continue_session', action='store_true')
parser.add_argument('--resume', '-r', action='store_true')
parser.add_argument('--mode')
parser.add_argument('--no-session', action='store_true')
parser.add_argument('--session')
parser.add_argument('--fork')
parser.add_argument('--session-dir')
parser.add_argument('--models')
parser.add_argument('--tools')
parser.add_argument('--no-tools', action='store_true')
parser.add_argument('--extension', '-e', action='append', default=[])
parser.add_argument('--no-extensions', '-ne', action='store_true')
parser.add_argument('--print', '-p', action='store_true', dest='print_mode')
parser.add_argument('--export')
parser.add_argument('--export-format', choices=['html', 'jsonl'], default='html')
parser.add_argument('--skill', action='append', default=[])
parser.add_argument('--no-skills', '-ns', action='store_true')
parser.add_argument('--no-mcp', action='store_true', dest='no_mcp', help='Do not start MCP servers from settings.json.')
parser.add_argument('--prompt-template', action='append', default=[])
parser.add_argument('--no-prompt-templates', '-np', action='store_true')
parser.add_argument('--theme', action='append', default=[])
parser.add_argument('--no-themes', action='store_true')
parser.add_argument('--list-models', nargs='?', const=True)
parser.add_argument('--offline', action='store_true')
parser.add_argument('--verbose', action='store_true')
parser.add_argument('--cooperation', action='store_true', help='Cooperation mode: ask the user before running mutating tools (bash/write/edit/plan/apply_patch); rejections require a reason that is fed back to the model.')
parser.add_argument('--no-subagents', action='store_true', help='Disable subagents: the spawn_subagent tool is not registered.')
parser.add_argument('--no-bash-output', action='store_true', help='Do not print bash command output; show only the exit code.')
parser.add_argument('--json', action='store_true', dest='json_output', help='Print the run result as JSON (summary, goalSuccess, finished).')
parser.add_argument('--answer-file', dest='answer_file', help='Headless answer channel for ask_user: questions are written to this file and answers are read back (polled).')
parser.add_argument('--steer-file', dest='steer_file', help='Headless steering channel: write a message to this file while the run is active; it is read and cleared.')
parser.add_argument('--image', dest='image_paths', action='append', default=[], help='Image file path for vision input (repeatable); equivalent to the read_image tool.')
parser.add_argument('--param', '-P', action='append', default=[], help='Template parameter name=value (repeatable); {{name}} in @file content is replaced.')