Skip to content

Ward Security System v2.0.0 - Installation Fixed

Choose a tag to compare

View all tags
@YamonBot YamonBot released this 18 Nov 16:31
· 26 commits to main since this release
Immutable release. Only release title and notes can be modified.
v2.0.0
2ce6bd2

Ward Security System v2.0.0 🛡️

AI-powered terminal protection with Claude Desktop and VS Code integration through Model Context Protocol (MCP).

✨ What's New in v2.0.0

  • 🤖 AI Assistant Integration: Full MCP (Model Context Protocol) support for Claude Desktop, Claude Code, and other AI assistants
  • 🚀 UVX-Based Installation: Secure local-only installation using UVX package manager
  • 🔒 Enhanced Security: Local-only execution prevents global system access
  • 🎯 Smart Labeling: AI-powered folder categorization and labeling system
  • 📁 Advanced Indexing: Intelligent content indexing and search capabilities
  • 🎨 Modern CLI: Clean, spekit-inspired command-line interface
  • ⚡ Zero Configuration: Works out of the box with sensible defaults

🔧 Installation

Quick Install (Recommended)

# One-click installation with MCP support
curl -sSL https://raw.githubusercontent.com/yamonco/ward/main/install.sh | bash

Manual Installation

# Install with UVX (recommended)
uv tool install --from git+https://github.com/yamonco/ward.git

# Configure Claude Desktop
ward-mcp add

# Test Ward installation
ward check .

# Plant protection for a new project
ward plant my-project

Alternative Installation

# Install with pip
pip install git+https://github.com/yamonco/ward.git

# Configure Claude Desktop/VS Code
ward-mcp add --target claude-code

🎯 Key Features

🛡️ AI Safety & Security

  • Terminal Integration: Seamlessly integrates with your existing shell
  • Command Filtering: Whitelist/blacklist dangerous commands automatically
  • Directory Protection: Restrict AI access to sensitive system directories
  • Real-time Monitoring: Track and log all AI-initiated actions
  • Smart Suggestions: Provide safe alternatives to blocked operations

🤖 MCP Integration

  • Claude Desktop: Automatic configuration and tool registration
  • Claude Code/VS Code: Full MCP extension support
  • AI Tool Access: Ward tools available in AI conversations
  • Real-time Protection: AI assistants can check security policies before actions

⚡ Lightweight & Fast

  • Zero Configuration: Works out of the box with sensible defaults
  • Minimal Overhead: No noticeable impact on terminal performance
  • Simple Setup: One-command installation and activation
  • Cross-platform: Linux, macOS, and Windows support

🚀 Usage

Basic Commands

ward                           # Show system status
ward check .                   # Check current directory security
ward init                      # Initialize protection in current directory
ward plant my-project          # Create protection for new project
ward search "config"           # Search indexed folders

AI Assistant Integration

Once installed with MCP, Ward tools are available in Claude conversations:

  • ward_check - Check security policies for paths
  • ward_plant - Plant protection for directories
  • ward_search - Search through indexed folders
  • ward_favorites_* - Manage favorite directories
  • ward_bookmark_* - Manage bookmarks
  • ward_label_* - AI labeling system

MCP Management

ward-mcp status                # Check MCP installation status
ward-mcp add                   # Add to Claude Desktop
ward-mcp add --target claude-code  # Add to VS Code
ward-mcp remove                # Remove MCP integration

🔍 For Other VS Code Environments

To use Ward in other VS Code instances:

# Install Ward with MCP support
uv tool install --from git+https://github.com/yamonco/ward.git

# Configure for Claude Code/VS Code
ward-mcp add --target claude-code

# Restart VS Code and ensure MCP extension is enabled

# Verify installation
ward check .

🔄 Package Management

# Update Ward
uv tool install --force --from git+https://github.com/yamonco/ward.git
# or
pip install --upgrade git+https://github.com/yamonco/ward.git

# Uninstall Ward
uv tool uninstall ward
# or
pip uninstall ward-security

🛠️ Development

For local development:

git clone https://github.com/yamonco/ward.git
cd ward
./setup-ward.sh

📚 Documentation

🐛 Bug Fixes in v2.0.0

  • Fixed UVX Installation: Corrected executable name and command structure
  • Removed PyPI References: Installation now uses GitHub source exclusively
  • Updated Documentation: All installation examples now work correctly
  • Enhanced Error Messages: Better feedback for installation issues

🔒 Security Notice

Ward is designed for local-only installation. It does not modify global system settings or require elevated permissions. This design ensures:

  • ✅ No unintended global system access
  • ✅ Contained execution environment
  • ✅ Safe for multi-user systems
  • ✅ Predictable behavior across environments

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines first.

Ward - Protecting your terminal while enabling AI collaboration. 🛡️✨

🤖 Generated with Claude Code

Assets 3
Loading