Skip to content

Quick Start Guide

Jump to bottom
Akshay Sharma edited this page Mar 14, 2026 · 1 revision

🚀 Quick Start Guide

Deploy your tactical firewall and secure your local workspace in under 60 seconds.

📥 1. Installation

Kavach is a portable, high-performance binary. There are zero cloud dependencies and no registry bloat.

  1. Download: Go to the Releases page and grab the version for your OS.
  2. Launch: Run Kavach.exe (Windows) or Kavach.dmg (macOS).
  3. Bypass OS Warnings: * Windows: Click More Info -> Run Anyway.
    • macOS: Open System Settings > Privacy & Security and click Open Anyway.

🛡️ 2. Defining the Perimeter

Once the dashboard boots up, you need to tell Kavach what to protect.

  1. Select Workspace: Click the Target icon in the side navigation.
  2. Choose Directory: Select the folder where your AI agents are currently working.
  3. Set Trust Level: * GHOST: Enables the Phantom Workspace (Full redirection).
    • SENTRY: Log only mode (Observation).
    • VETO: Strict mode (Requires manual approval for every change).

⚡ 3. Your First Interception

To ensure the Rust backend is successfully hooking into your OS, run a simple test:

  1. Open your terminal and attempt to run a script that modifies a file in your protected workspace.
  2. Watch the Kavach Dashboard. You should see a Radioactive Amber alert flash instantly.
  3. Select Veto to block the change, or Phantom to let the agent think it succeeded while saving your original file.

⏳ 4. Mastering Time Travel

If an agent makes an unauthorized change before you can stop it, use the Temporal Rollback:

  1. Navigate to the Audit Log tab.
  2. Find the unauthorized modification entry.
  3. Hover over the entry and click the Rewind icon.
  4. Kavach will instantly swap the mangled file with the cryptographic cache version.

💡 Pro-Tips

  • Admin Rights: On Windows, run Kavach as Administrator to ensure the backend can hook into system-level process spawns.
  • Turing Mode: Keep the UI visible on your screen; the Adversarial Noise only works if the window is active!

Important

Kavach is a local-first tool. If you close the application, the firewall is disarmed. Ensure it is running in the background whenever you are using autonomous agents.

🛡️ Kavach Wiki

🔗 Resources

Status: PERIMETER SECURED

Clone this wiki locally