TODO Archive

If a slash or dollar invocation already added these instructions to the conversation, follow them directly. In that case, do not invoke this skill again through a skill tool.

Arguments

• path (optional): Repository root or any path inside the repository. Default to the current directory.
• --hint TEXT (optional): Archive only the section whose heading contains TEXT (case-insensitive substring), including its subsections. Without it, archive checked tasks from the whole file. Checked tasks outside the matched section stay in .ai/TODO.md.
• --date YYYY-MM-DD|YYYY_MM_DD (optional): Archive date. Default to today's local date.
• --dry-run (optional): Preview target paths and rendered content without writing.

Workflow

1. Resolve the supplied path, or the current directory when omitted. For an existing file, use its containing directory. For a directory, use that directory. Store the absolute directory as start_dir, then resolve its Git root: