| name | import-organizer |
| description | Organizes and sorts import statements in code files. Use when imports are messy or need organization. |
| allowed-tools | Read, Edit, Grep |
Import Organizer
Automatically organize and sort import statements in JavaScript, TypeScript, Python, and other languages.
When to Activate
- "organize imports in this file"
- "sort the imports"
- "clean up import statements"
- "fix import order"
Process
- Read the file to see current imports
- Identify import groups:
- External/third-party imports
- Internal/local imports
- Type imports (TypeScript)
- Side-effect imports
- Sort within groups alphabetically
- Remove duplicates if any
- Apply language-specific conventions:
- JavaScript/TypeScript: External, then internal
- Python: Standard library, third-party, local
- Preserve comments attached to imports
- Update the file with organized imports
Language-Specific Rules
JavaScript/TypeScript
// External packages first
import React from 'react'
import { useState } from 'react'
import axios from 'axios'
// Internal imports
import { Button } from './components/Button'
import { utils } from './utils'
// Type imports (TypeScript)
import type { User } from './types'
// Side-effect imports last
import './styles.css'
Python
# Standard library
import os
import sys
from datetime import datetime
# Third-party
import requests
from django.db import models
# Local
from .models import User
from .utils import helper
Best Practices
- Group by source (external vs internal)
- Sort alphabetically within groups
- Separate groups with blank lines
- Remove unused imports (warn user)
- Preserve special comments
- Follow language conventions