A utility toolkit for Augment VIP users, providing tools to manage and clean VS Code databases. Now with Python-based cross-platform compatibility!
Tested on Mac Os Vscode Status : Working Last Tested : 4 June 2025 1:50PM GMT8+
- Database Cleaning: Remove Augment-related entries from VS Code databases
- Telemetry ID Modification: Generate random telemetry IDs for VS Code to enhance privacy
- Cross-Platform Support: Works on Windows, macOS, and Linux
- Python-Based: Uses Python for better cross-platform compatibility
- Virtual Environment: Isolates dependencies to avoid conflicts
- Safe Operations: Creates backups before making any changes
- User-Friendly: Clear, color-coded output and detailed status messages
- Python 3.6 or higher
- No external system dependencies required (all managed through Python)
You can install with a single command using curl:
curl -fsSL https://raw.githubusercontent.com/azrilaiman2003/augment-vip/main/install.sh -o install.sh && chmod +x install.sh && ./install.shThis will:
- Download the installation script
- Make it executable
- Check for Python 3.6 or higher
- Create a new
augment-vipdirectory in your current location - Download the Python installer and package files
- Set up a Python virtual environment
- Install the package in the virtual environment
- Prompt you if you want to run the database cleaning and telemetry ID modification tools
- Run the selected tools automatically
You can also run the installation script with options to automatically run the cleaning and ID modification tools:
# Install and run database cleaning
curl -fsSL https://raw.githubusercontent.com/azrilaiman2003/augment-vip/python/install.sh -o install.sh && chmod +x install.sh && ./install.sh --clean
# Install and modify telemetry IDs
curl -fsSL https://raw.githubusercontent.com/azrilaiman2003/augment-vip/python/install.sh -o install.sh && chmod +x install.sh && ./install.sh --modify-ids
# Install and run all tools
curl -fsSL https://raw.githubusercontent.com/azrilaiman2003/augment-vip/python/install.sh -o install.sh && chmod +x install.sh && ./install.sh --all
# Show help
curl -fsSL https://raw.githubusercontent.com/azrilaiman2003/augment-vip/python/install.sh -o install.sh && chmod +x install.sh && ./install.sh --helpIf you prefer to clone the entire repository:
git clone https://github.com/azrilaiman2003/augment-vip.git
cd augment-vip
python install.pyIf you prefer to set up manually:
# Clone the repository
git clone https://github.com/azrilaiman2003/augment-vip.git
cd augment-vip
# Create a virtual environment
python -m venv .venv
# Activate the virtual environment
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate
# Install the package
pip install -e .To remove Augment-related entries from VS Code databases:
# If using the virtual environment (recommended)
.venv/bin/augment-vip clean # macOS/Linux
.venv\Scripts\augment-vip clean # Windows
# If installed globally
augment-vip cleanThis will:
- Detect your operating system
- Find VS Code database files
- Create backups of each database
- Remove entries containing "augment" from the databases
- Report the results
To change the telemetry IDs in VS Code's storage.json file:
# If using the virtual environment (recommended)
.venv/bin/augment-vip modify-ids # macOS/Linux
.venv\Scripts\augment-vip modify-ids # Windows
# If installed globally
augment-vip modify-idsThis will:
- Locate the VS Code storage.json file
- Generate a random 64-character hex string for machineId
- Generate a random UUID v4 for devDeviceId
- Create a backup of the original file
- Update the file with the new random values
To run both tools at once:
# If using the virtual environment (recommended)
.venv/bin/augment-vip all # macOS/Linux
.venv\Scripts\augment-vip all # Windows
# If installed globally
augment-vip allaugment-vip/
├── .venv/ # Virtual environment (created during installation)
├── augment_vip/ # Main package
│ ├── __init__.py # Package initialization
│ ├── cli.py # Command-line interface
│ ├── db_cleaner.py # Database cleaning functionality
│ ├── id_modifier.py # Telemetry ID modification functionality
│ └── utils.py # Utility functions
├── install.py # Python installation script
├── install.sh # Bash wrapper for Python installer
├── README.md # This file
├── requirements.txt # Package dependencies
└── setup.py # Package setup script
The database cleaning tool works by:
-
Finding Database Locations: Automatically detects the correct paths for VS Code databases based on your operating system.
-
Creating Backups: Before making any changes, the tool creates a backup of each database file.
-
Cleaning Databases: Uses SQLite commands to remove entries containing "augment" from the databases.
-
Reporting Results: Provides detailed feedback about the operations performed.
Python Not Found
[ERROR] Python 3 is not installed or not in PATH
Install Python 3.6 or higher:
- Windows: Download from https://www.python.org/downloads/
- macOS:
brew install python3or download from https://www.python.org/downloads/ - Ubuntu/Debian:
sudo apt install python3 python3-venv - Fedora/RHEL:
sudo dnf install python3 python3-venv
Permission Denied
[ERROR] Permission denied
Make sure the scripts are executable:
chmod +x install.shNo Databases Found
[WARNING] No database files found
This may occur if you haven't used VS Code on your system, or if it's installed in non-standard locations.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Azril Aiman - me@azrilaiman.my
Project Link: https://github.com/azrilaiman2003/augment-vip
Made with ❤️ by Azril Aiman