Codex guide

Organize files with Codex: what to check before renaming or moving

6 min readSkillshop operator and creator of the Maker Evan YouTube channel

Translated from Korean. View original

Before asking Codex to organize a folder, decide which files are in scope and how to classify them. Review the file list and proposed renames, then apply them to copies so results are easy to compare. This guide practices consistent filenames and separately checks collisions and ambiguous classifications.

Illustration of a person working with documents on a laptop
Start with one small task and open the resulting file. This is an AI-generated illustration.

Narrow the folder scope

Start with one folder of similar material, such as event resources or this month's notes. A whole Downloads folder may mix installers, documents and photos that are difficult to organize with one rule.

Prepare copies in a practice folder and connect it to a local project. Here inbox is the source and organized is the result folder. Adapt the request if your folders have different names.

Even when a connected folder is in scope, actual reads and writes depend on permissions. If access fails, check the required path and allowed scope.

Get a file list before moving anything

Example request: ‘List filenames, relative paths, extensions and sizes inside inbox, including subfolders. Do not move or rename anything yet. List any unreadable files separately.’ Relative paths describe locations within inbox.

Check that the expected files appear. Identical names can be in different subfolders, so compare paths as well as filenames. Decide whether hidden files and shortcuts belong in this task.

Renaming alone does not require reading every file's contents. Request content reads only where needed for classification; this makes the scope easier to explain.

Define naming and classification rules with examples

For event photos and notes, choose clear folder names such as photos and notes. A filename can use only needed parts, such as date_topic_number. It is an example, not a universal rule; choose one that fits how you find files.

Example request: ‘Propose YYYY-MM-DD_topic names only where the date is explicit in the filename. If absent or ambiguous, do not guess; mark it for review. Show current path, new path and reason in a table.’

A filesystem modification date is not necessarily the document creation or photo date. Decide which date to use and check whether distinct files would receive the same name.

Example current nameTreatmentWhy check
2026-09-09 meeting-notes.txt2026-09-09_meeting-notes.txtThe filename contains an explicit date.
final meeting-notes.txtLeave in the review listDo not guess the date.
Same filename in another folderCompare contents and full pathsIdentical names can represent different material.
These names illustrate the rule; choose criteria that fit your actual files.

Review proposals and copy into the result folder

Check that names do not become too long or contain hard-to-find abbreviations. Apply the rule to a few first, then expand if the result looks right.

Example request: ‘Copy according to the reviewed proposal into organized. Leave the originals in inbox, do not overwrite existing names, and save separate lists of processed and excluded files.’

This exercise organizes copies. If moving or deleting originals is needed, define that scope separately after reviewing the result. Check available storage for large folders.

ListCheck target files and full paths
ProposeReview names and classification reasons
CopyApply in a separate folder and keep a record
VerifyCompare counts, contents and exclusions
You can inspect proposed renames before changing files.

Are files missing or contents changed?

Ask whether the number of target files equals processed plus excluded files. Check that collisions or read errors were not listed as successes.

If only names and locations changed, contents should remain the same. Ask for per-file comparison of originals and copies and a list of anything not verified. Open a few documents and photos yourself too.

Changing an extension does not convert a format: renaming .txt to .pdf does not make a PDF. Request conversion separately if needed and verify the resulting file opens.

Keep rules for the next cleanup

If the result works, record the filename pattern, folder criteria and treatment of ambiguous cases. Rules such as ‘do not guess dates,’ ‘do not overwrite collisions’ and ‘record old and new paths’ may be enough.

Separate duplicate deletion from renaming. Files with identical names or contents may still be needed in two locations. Next time, request duplicate candidates and their evidence for review before asking for deletion.

Frequently asked questions

Can I delete files as duplicates when their names match?

Files with the same name may differ. Check full paths and contents and whether both locations are needed. This exercise lists candidates for review without deleting them.

Can I organize the originals directly?

Copies or a separate result folder make an initial test easier to compare. If originals must move, review the proposal and recovery method, then request that scope separately.

What if a renamed file no longer opens?

Check whether the original opens, whether its extension changed and whether copying finished. Changing an extension is not conversion. Compare old and new paths in the processing record.

Sources