j Verified current stable Not installed? Filesystem

J / Remove Non Existing Directories From Database

Remove Non Existing Directories From Database

Cleans the Autojump database by removing paths to non-existing directories.

Terminal

j --purge

j --purge

#!/bin/bash

# Remove Non Existing Directories From Database
j --purge

import subprocess

# Remove Non Existing Directories From Database
# Make sure to replace <placeholders> with actual values
def run_command():
    cmd = [
        "j",
        "--purge"
    ]
    
    try:
        print(f"Executing: {' '.join(cmd)}")
        subprocess.run(cmd, check=True)
    except subprocess.CalledProcessError as e:
        print(f"Error: {e}")
    except FileNotFoundError:
        print("Error: j not found. Please install it first.")

if __name__ == "__main__":
    run_command()

When To Use

During routine maintenance of the Autojump database to ensure efficient navigation without dead links.

Pro Tip

Run this command before major directory reorganization to prevent obsolete entries from causing confusion in jumps.

Terminal Output

Expected runtime feedback

Simulated preview

Output

Removed 5 non-existing directories from the database.

Summary:
---------------------------------------------------
Deleted    : 5
Remaining   : 120

Operation successful. Database updated.

Anatomy of Output

Understanding the result

Purging non-existing directories from Autojump database... Purge Status

Indicates that non-existing paths are being cleaned up.

Removed 5 non-existing paths. Removal Counter

Denotes the number of dead entries purged.

Database now contains 100 valid paths. Remaining Paths

Shows the current count of valid paths in the database.

Power User Variants

Optimized versions

j -a

Purge and reindex the database in a single action.

j --silent

Run without output for cleaner logs.

j -v

Enable verbose mode for detailed operation log.

Troubleshooting

Common pitfalls

Autojump: Database not found.

Solution: Ensure Autojump is properly installed and database path is correctly configured.

No non-existing directories to purge.

Solution: Check the current state of the Autojump database.

Purge failed: Permission denied.

Solution: Run command with appropriate user permissions.

Command Breakdown

What each part is doing

j: Base Command; The executable that performs this operation. Here it runs J before the shell applies any redirect operators.
--purge: Command Option; Tool-specific option used by this command invocation.

How To Run

Execution path

Step 1
Run the command: `j --purge`
Step 2
Check the output for any records of deleted directories.

Alternative Approaches

Comparable commands in other tools

Alternative filesystem tools for the same job.

Keepassxc Cli / Delete Entry From Database keepassxc-cli rm <path/to/database_file> <entry_name> Strip / Strip Executable File strip <path/to/file> Strigger / Execute Program On Job Termination strigger --set -j <job_id> -f -p "<path/to/executable> <argument1 argument2 ...>" Systemd Hwdb / Update Binary Hardware Database Custom Root systemd-hwdb -r <path/to/root> update Zoxide / Remove Directory From Zoxide Database zoxide remove <path/to/directory>