task-creator

Task Creator

A saved task is a pre-configured, self-contained prompt template and configuration that can be executed autonomously on demand via /task run <task_id> [key=value ...] or ollama-agent task run <task_id> [key=value ...]. Tasks reside in /tasks/<task_id>.yaml (persisted in ~/.ollama-agent/tasks/<task_id>.yaml).

Task YAML Schema

Each task is saved as a single YAML file: /tasks/<task_id>.yaml.

title: "Clear, descriptive title of the task"
prompt: "Jinja2 prompt template with {{ variable }}, {% if %}, {% for %}, and @mentions..."
model: "gemma4:26b" # Required non-empty model name (e.g. the active model or a specific model)
reasoning_effort: "default" # Required reasoning effort (as advertised by the model in Ollama /api/show, e.g. "max", "low", "false", "hide"), or "default"
inputs:
  target_file:
    description: "Target file to analyze"
    type: "string"
    required: true
  strict:
    description: "Enable strict mode"
    type: "boolean"
    default: false

Fields Specification

• title (string, required): Short descriptive title for display in /task list.
• prompt (string, required): Jinja2-compatible prompt template. Because tasks run autonomously, the prompt should provide all necessary context, step-by-step instructions, and expected deliverables.
• model (string, required): Non-empty Ollama model name (e.g. "gemma4:26b" or the session's active model). Must not be empty ("").
• reasoning_effort (string, required): Non-empty reasoning effort supported by the target model in Ollama (advertised in /api/show), or "default" to use the model's default.
• inputs (mapping, optional): Dictionary of input parameter definitions:
  • description (string, optional): Human-readable explanation of the input parameter.
  • type (string, optional): Data type for value coercion (string, boolean, number). Default is string.
  • required (boolean, optional): Whether the variable must be provided when running the task. Default is false.
  • default (any, optional): Default fallback value when the variable is omitted at runtime.