claude-organizer

Claude Organize solves the file clutter problem that occurs when Claude Code creates test scripts, debug files, and documentation at your project root despite instructions. It uses AI-powered categorization to understand file purpose from content and automatically moves files into organized directories like docs/, scripts/, and their subcategories. The tool integrates seamlessly with Claude Code via PostToolUse hooks, running automatically after file creation without requiring manual intervention. It protects critical files like README and LICENSE while reducing context bloat for improved Claude performance. This complements Claude Code best practices by ensuring consistent organization regardless of session length or CLAUDE.md configuration.

[{"step":1,"action":"Specify the directory to organize using [DIRECTORY_PATH] in the prompt. Example: '/projects/my-ai-project'.","tip":"Use absolute paths for reliability. Avoid directories with system-critical files."},{"step":2,"action":"Define cleanup rules for temporary files using [LAST_MODIFIED_DATE] and [FILE_EXTENSION]. Example: 'Last modified before 2024-01-01' or '.tmp, .bak'.","tip":"Set conservative cleanup schedules (e.g., 30 days) for critical projects to avoid data loss."},{"step":3,"action":"Run the prompt in Claude Code or a similar environment with file access permissions.","tip":"Use `claude --dir /path/to/dir` to ensure the AI has the correct context for file operations."},{"step":4,"action":"Review the report and confirm the actions. Manually intervene if needed (e.g., files misclassified as temporary).","tip":"Check the `temp/` directory before cleanup to ensure no important files are accidentally moved."},{"step":5,"action":"Set up recurring organization tasks using Claude’s automation hooks or cron jobs.","tip":"Schedule weekly runs for active projects to maintain organization without manual effort."}]