Skip to Content
CLI ReferenceCommandstask create

ah task create

Create a new task or add to an existing task branch.

ah task create [OPTIONS] [BRANCH]

Arguments

ArgumentDescription
[BRANCH]Branch name for new tasks

Prompt Options

OptionDescription
--prompt <TEXT>Task prompt (direct)
--prompt-file <FILE>Read prompt from file

Agent Options

OptionDescription
--agent <TYPE>Agent type (repeatable)
--model <NAME>Model for last —agent
--instances <N>Instances for last —agent

Sandbox Options

OptionDescriptionDefault
--sandbox <TYPE>none, local, devcontainer, vmnone
--allow-network <BOOL>Allow internet accessno
--allow-containers <BOOL>Enable container device accessno
--allow-kvm <BOOL>Enable KVM device accessno

Delivery Options

OptionDescription
--delivery <METHOD>pr, branch, patch
--target-branch <NAME>Target branch for delivery
--push-to-remote <BOOL>Auto-push branch to remote

Other Options

OptionDescriptionDefault
--followLaunch TUI to monitorfalse
-y, --yesSkip interactive promptsfalse
--non-interactiveNon-interactive modefalse
--mcp-config <PATH>Path to MCP config file—
--create-task-files <BOOL>Create local task filesyes
--notifications <BOOL>OS notifications on completionyes

Examples

Basic task:

ah task create --agent claude --prompt "Add unit tests"

Read prompt from file:

ah task create --agent claude --prompt-file task.md

Multiple agents:

ah task create --agent claude --agent codex --prompt "Add tests"

Multiple instances:

ah task create --agent claude --instances 3 --prompt "Find bugs"

With specific model:

ah task create --agent claude --model sonnet --prompt "Refactor"

With delivery method:

ah task create --agent claude --prompt "Fix bug" --delivery pr --target-branch main

Non-interactive with auto-push:

ah task create --agent claude --prompt "Update docs" --non-interactive --push-to-remote true

Follow task in TUI:

ah task create --agent claude --prompt "Task" --follow
tuitask get