feat: add uninstall command to cli (#20)

* feat: add sus uninstall command for easy removal

Adds a self-uninstall command that removes the sus binary from the system.
Supports --yes to skip confirmation and --all to also remove project files
(.sus-docs/, sus.json). Updated install script to show uninstall instructions.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: bump version to v0.1.6

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: remove sus section from AGENTS.md on uninstall --all

Previously uninstall --all only removed .sus-docs/ and sus.json.
Now it also removes the sus Docs Index section from AGENTS.md while
preserving any other content in the file.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: homanp

Cargo.toml

@@ -11,7 +11,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.1.5"
+version = "0.1.6"
 edition = "2021"
 authors = ["sus contributors"]
 license = "MIT"

crates/cli/src/agents_md.rs

@@ -116,7 +116,6 @@ fn update_agents_md_index_at_path(agents_path: &Path, docs_dir: &Path) -> Result
 }
 
 /// Remove sus section from AGENTS.md
-#[allow(dead_code)]
 pub fn remove_agents_md_index() -> Result<()> {
     remove_agents_md_index_at_path(Path::new(AGENTS_MD_PATH))
 }

crates/cli/src/commands/mod.rs

@@ -5,5 +5,6 @@ pub mod check;
 pub mod init;
 pub mod remove;
 pub mod scan;
+pub mod uninstall;
 pub mod update;
 pub mod why;

crates/cli/src/commands/uninstall.rs

@@ -0,0 +1,125 @@
+//! Uninstall command - remove sus from the system
+
+use crate::agents_md;
+use anyhow::Result;
+use colored::Colorize;
+use dialoguer::Confirm;
+use std::path::Path;
+
+/// Run the uninstall command
+pub async fn run(yes: bool, all: bool) -> Result<()> {
+    // Get the current executable path
+    let exe_path = std::env::current_exe()?;
+
+    println!();
+    println!("🗑️  sus uninstaller");
+    println!();
+    println!(
+        "   Binary location: {}",
+        exe_path.display().to_string().cyan()
+    );
+
+    // Check for project-level files
+    let sus_docs = Path::new(".sus-docs");
+    let sus_json = Path::new("sus.json");
+    let agents_md = Path::new("AGENTS.md");
+    let has_agents_md_section = agents_md.exists()
+        && std::fs::read_to_string(agents_md)
+            .map(|c| c.contains("[sus Docs Index]"))
+            .unwrap_or(false);
+    let has_project_files = sus_docs.exists() || sus_json.exists() || has_agents_md_section;
+
+    if all && has_project_files {
+        println!();
+        println!("   Project files to remove:");
+        if sus_docs.exists() {
+            println!("   - {}", ".sus-docs/".cyan());
+        }
+        if sus_json.exists() {
+            println!("   - {}", "sus.json".cyan());
+        }
+        if has_agents_md_section {
+            println!("   - {}", "AGENTS.md (sus section only)".cyan());
+        }
+    }
+
+    // Confirm unless --yes flag
+    if !yes {
+        println!();
+        let confirm = Confirm::new()
+            .with_prompt("   Remove sus?")
+            .default(false)
+            .interact()?;
+
+        if !confirm {
+            println!();
+            println!("   {} Uninstall cancelled.", "✗".red());
+            return Ok(());
+        }
+    }
+
+    // Remove project-level files if --all flag
+    if all {
+        if sus_docs.exists() {
+            std::fs::remove_dir_all(sus_docs)?;
+            println!("   {} Removed .sus-docs/", "✓".green());
+        }
+        if sus_json.exists() {
+            std::fs::remove_file(sus_json)?;
+            println!("   {} Removed sus.json", "✓".green());
+        }
+        if has_agents_md_section {
+            agents_md::remove_agents_md_index()?;
+            println!("   {} Removed sus section from AGENTS.md", "✓".green());
+        }
+    }
+
+    // Delete the binary
+    // Note: On some systems, we can't delete a running executable directly
+    // So we try a few approaches
+    #[cfg(unix)]
+    {
+        // On Unix, we can usually delete the file while it's running
+        // The file will be removed when the process exits
+        std::fs::remove_file(&exe_path)?;
+    }
+
+    #[cfg(windows)]
+    {
+        // On Windows, we need to schedule deletion or use a workaround
+        // For now, we'll try direct deletion which works in some cases
+        if let Err(_) = std::fs::remove_file(&exe_path) {
+            // If direct deletion fails, create a batch script to delete after exit
+            let batch_path = std::env::temp_dir().join("sus_uninstall.bat");
+            let batch_content = format!(
+                "@echo off\n\
+                 :loop\n\
+                 del \"{}\" 2>nul\n\
+                 if exist \"{}\" goto loop\n\
+                 del \"%~f0\"\n",
+                exe_path.display(),
+                exe_path.display()
+            );
+            std::fs::write(&batch_path, batch_content)?;
+            std::process::Command::new("cmd")
+                .args(["/C", "start", "/min", batch_path.to_str().unwrap()])
+                .spawn()?;
+        }
+    }
+
+    println!();
+    println!("   {} sus has been uninstalled.", "✓".green());
+    println!();
+
+    // Suggest cleanup if project files exist but --all wasn't used
+    if !all && has_project_files {
+        println!(
+            "   {} Project files (.sus-docs/, sus.json) were not removed.",
+            "note:".yellow()
+        );
+        println!("   Run with {} to remove them too.", "--all".cyan());
+        println!();
+    }
+
+    Ok(())
+}

crates/cli/src/main.rs

@@ -84,6 +84,17 @@ enum Commands {
         /// Package to trace
         package: String,
     },
+
+    /// Uninstall sus from this system
+    Uninstall {
+        /// Skip confirmation prompt
+        #[arg(long, short)]
+        yes: bool,
+
+        /// Also remove project-level files (.sus-docs/, sus.json)
+        #[arg(long)]
+        all: bool,
+    },
 }
 
 #[tokio::main]
@@ -120,5 +131,7 @@ async fn main() -> anyhow::Result<()> {
         Commands::Update { dry_run } => commands::update::run(&client, dry_run).await,
 
         Commands::Why { package } => commands::why::run(&package).await,
+
+        Commands::Uninstall { yes, all } => commands::uninstall::run(yes, all).await,
     }
 }

scripts/install.sh

@@ -91,6 +91,8 @@ main() {
     fi
 
     info "Done! Run 'sus --help' to get started."
+    echo ""
+    echo "To uninstall later, run: sus uninstall"
 }
 
 main