ody plan

Synopsis

ody plan [planFile] [--dry-run] [--verbose]

Arguments

Flags

Behavior

Interactive mode (default)

Without arguments, ody plan enters an interactive loop:

1. Prompts you for a task description.
2. Asks if you want to add another plan.
3. Repeats until you decline or cancel.
4. Sends each description to the configured backend agent, which generates a .code-task.md file in .ody/tasks/.

Each generated file includes YAML frontmatter (status: pending, creation date) and all required sections: Description, Background, Technical Requirements, Dependencies, Implementation Approach, Acceptance Criteria, and Metadata.

Batch mode

When a planFile argument is provided, the agent reads the planning document and decomposes it into multiple discrete task files:

ody plan docs/feature-plan.md

The agent analyzes the document and creates one .code-task.md file per actionable task, ordering them logically so dependencies come first.

Dry run

Use --dry-run to preview the prompt that would be sent to the agent without actually generating task files:

ody plan --dry-run
ody plan docs/feature-plan.md --dry-run

Examples

Create a single task interactively:

$ ody plan
# Enter: "Add email validation to the signup form"
# Decline adding another plan
# Agent generates .ody/tasks/add-email-validation.code-task.md

Generate multiple tasks from a planning document:

ody plan docs/auth-system-plan.md

Preview the batch prompt without running:

ody plan docs/auth-system-plan.md --dry-run

Stream agent output while generating:

ody plan --verbose

Related

• ody task list -- View pending tasks after generating plans
• ody task edit -- Refine a generated task plan
• ody run -- Execute pending tasks with the agent loop