Commandstask

ody task edit

Edit an existing task plan

Synopsis

ody task edit [--dry-run]

Flags

FlagAliasTypeDefaultDescription
--dry-run-dbooleanfalsePrint the generated prompt without sending to the agent

Behavior

  1. Scans .ody/tasks/ for all .code-task.md files.
  2. Presents an interactive selection prompt listing each task by title and filename.
  3. Reads the selected task file's full content.
  4. Builds an edit prompt containing the file path and current content.
  5. Sends the prompt to the configured backend agent.
  6. The agent edits the file in place, preserving the YAML frontmatter structure and all required sections.

The agent preserves the status, created, started, and completed frontmatter fields unless you explicitly ask it to change them.

If no task files are found, the command exits with an informational message.

Dry run

Use --dry-run to see the prompt that would be sent to the agent without actually running the edit:

ody task edit --dry-run

Example

$ ody task edit
# Select "Add Email Validation  (add-email-validation.code-task.md)"
# Agent refines the task plan
# Task plan updated

On this page