🧹 Kiro IDE Cleaner

Cross-platform interactive program for complete cleanup of Kiro IDE data and solving OAuth authorization problems.

📋 Description

Kiro IDE Cleaner is a convenient console utility that helps solve authorization problems in Kiro IDE by completely cleaning user data, settings and cache. Supports macOS, Linux and Windows.

✨ Features

• 🔄 Full automatic cleanup - performs all steps with one click
• 📋 Step-by-step cleanup - allows you to select specific actions
• 🔍 Process monitoring - checking active Kiro processes
• 📊 Data size analysis - shows the amount of space occupied
• 🛡️ Safe operation - creating backups and operation confirmations
• 🎨 Beautiful interface - colored output with emoji and clear menus

🚀 Quick Start

Installation

# Clone repository
git clone https://github.com/guard22/KiroAbuse.git
cd KiroAbuse

Launch

macOS

chmod +x kiro_cleaner_macos.sh
./kiro_cleaner_macos.sh

Linux

chmod +x kiro_cleaner_linux.sh
./kiro_cleaner_linux.sh

Windows (Command Prompt)

kiro_cleaner_windows.bat

Windows (PowerShell)

.\kiro_cleaner_windows.ps1

📖 Usage

After launching the program you will see the main menu:

╔══════════════════════════════════════════════════════════════╗
║                    🧹 KIRO IDE CLEANER 🧹                    ║
║              Kiro IDE Data Cleanup Program                   ║
╚══════════════════════════════════════════════════════════════╝

Choose an action:

1. 🔄 Full cleanup (all steps at once)
2. 📋 Step-by-step cleanup (choose each step)
3. 🔍 Check Kiro process status
4. 📊 Show Kiro data size
5. ❓ Help
0. 🚪 Exit

Operating Modes

1. Full Cleanup

Performs all 10 cleanup steps automatically:

• Closing Kiro processes
• Removing user data
• Clearing cache and logs
• Removing settings
• Clearing Keychain (with confirmation)
• Resetting system permissions (with confirmation)
• And much more...

2. Step-by-step Cleanup

Allows you to select specific actions to perform. For each step you can choose:

• Y - execute step
• n - skip step
• q - exit mode

🔧 What Gets Cleaned

Main Directories

• ~/Library/Application Support/Kiro
• ~/.kiro
• ~/.config/kiro
• ~/.local/share/Kiro

Logs and Cache

• ~/Library/Logs/Kiro
• ~/Library/Caches/dev.kiro*
• ~/Library/HTTPStorages/dev.kiro.desktop

System Settings

• ~/Library/Preferences/dev.kiro*
• System permissions (TCC)
• Quarantine attributes

AWS Data (optional)

• ~/.aws/sso
• ~/.aws/cli/cache
• ~/.aws/config (with backup creation)
• ~/.aws/credentials (with backup creation)

Keychain

• Saved passwords for Kiro
• AWS Builder ID tokens
• OAuth tokens

⚠️ Important Notes

• Requires appropriate OS - each version works only on its target platform
• Administrator password - some operations require sudo/admin rights
• AWS backups - AWS configuration is saved to backup before deletion
• Settings loss - all Kiro user settings will be lost

🛡️ Security

The program includes several levels of protection:

1. Confirmations - requests confirmation for critical operations
2. Backups - creates backup copies of important files
3. Information - shows exactly what will be deleted
4. Cancellation option - operations can be interrupted at any time

🐛 Troubleshooting

When to use:

• ❌ OAuth authorization problems
• ❌ Hanging during system login
• ❌ AWS connection errors
• ❌ Need for complete settings reset
• ❌ Kiro doesn't start or works incorrectly

After cleanup:

1. 🚀 Launch Kiro IDE again
2. 🔐 Login via GitHub or Google (recommended)
3. 🆔 Or try logging in via Builder ID

📝 Usage Examples

Quick full cleanup

./kiro_cleaner_macos.sh
# Choose option 1
# Confirm operation: y

Check processes before cleanup

./kiro_cleaner_macos.sh
# Choose option 3 to check processes
# Then option 1 or 2 for cleanup

Cache cleanup only (step-by-step mode)

./kiro_cleaner_macos.sh
# Choose option 2
# Skip unnecessary steps (n)
# Execute only needed ones (Y)

🤝 Contributing

We welcome contributions to the project! If you have suggestions or found a bug:

1. Create an Issue describing the problem
2. Fork the repository
3. Create a branch for your changes
4. Submit a Pull Request

📄 License

This project is distributed under the MIT license. See LICENSE file for details.

🆘 Support

If you encounter problems:

1. Check the Troubleshooting section
2. Look at existing Issues
3. Create a new Issue with detailed problem description

📊 Supported Platforms

macOS

• ✅ macOS 10.15+ (Catalina and newer)
• ✅ Compatible with zsh and bash
• ✅ Keychain and system permissions cleanup
• 📁 File: kiro_cleaner_macos.sh

Linux

• ✅ Ubuntu, Debian, CentOS, Fedora and other distributions
• ✅ Compatible with bash
• ✅ GNOME Keyring and secret-tool support
• 📁 File: kiro_cleaner_linux.sh

Windows

• ✅ Windows 10/11
• ✅ Batch version: kiro_cleaner_windows.bat
• ✅ PowerShell version: kiro_cleaner_windows.ps1
• ✅ Registry and system settings cleanup

🔧 Platform-Specific Features

macOS specific functions:

• Keychain cleanup (keychain)
• System permissions reset (TCC)
• Quarantine attributes removal
• Library directories cleanup

Linux specific functions:

• GNOME Keyring support
• .config and .local/share cleanup
• Application database update
• Autostart cleanup

Windows specific functions:

• Windows registry cleanup
• Shortcuts and autostart removal
• APPDATA and LOCALAPPDATA support
• System services management

---

💡 Tip: Run the program whenever you have authorization problems in Kiro IDE - it's the fastest way to solve most problems!