ody compact

Synopsis

ody compact

Flags

This command has no flags.

Behavior

ody compact performs two archival operations:

Task archival

1. Scans .ody/tasks/ for .code-task.md files with status: completed in their YAML frontmatter.
2. Generates a tasks.md summary containing each task's title, completion date, and description.
3. Writes the summary to .ody/history/<YYYY-MM-DD>/tasks.md.
4. Deletes the original completed task files from .ody/tasks/.

Progress archival

1. Reads .ody/progress.txt if it exists and has content.
2. Writes the content to .ody/history/<YYYY-MM-DD>/progress.md.
3. Clears the original progress.txt file.

If neither completed tasks nor progress entries are found, the command reports that there is nothing to compact and exits.

Output structure

After running ody compact, the archive is organized by date:

Example

$ ody compact

Output:

Archived 3 completed task(s) to .ody/history/2026-02-15/tasks.md
Archived progress log to .ody/history/2026-02-15/progress.md
Compaction complete

Related

• ody run -- The agent loop that generates completed tasks and progress entries
• ody plan -- Create task plans that compact eventually archives