Skip to content

Releases: yamonco/ward

Ward Security System v2.0.3 - User Experience Fixes

Choose a tag to compare

@YamonBot YamonBot released this 18 Nov 17:20
Immutable release. Only release title and notes can be modified.

Ward Security System v2.0.3 - User Experience Improved

User Experience Fixes:

  • Auto-initialization guidance - No more confusion about missing .ward files
  • Enhanced error messages - Clear next steps when Ward policies are missing
  • Added ward_init MCP tool - Initialize Ward directly from Claude Code
  • Automatic PATH setup - UV tools path configured during installation

Key Improvements:

  • ward_check now suggests ward_init when .ward files are missing
  • MCP server provides clear guidance on initialization steps
  • setup-ward.sh now automatically configures UV tools PATH
  • New ward_init tool available in Claude Code

Usage Examples:

From Claude Code (New):

  • ward_init (initialize current directory)
  • ward_init(path='my-project', description='AI Project') (custom)
  • ward_check my-project (better error messages)

Installation (Improved):

  • ./setup-ward.sh (automatic UV installation with PATH setup)
  • PATH automatically configured!

Bug Fixes:

  • Fixed confusing Ward CLI not found errors
  • Improved missing .ward file detection
  • Enhanced PATH configuration for UV tools
  • Better MCP server initialization flow

Generated with Claude Code

Ward Security System v2.0.2 - MCP Integration Fixed

Choose a tag to compare

@YamonBot YamonBot released this 18 Nov 17:17
Immutable release. Only release title and notes can be modified.

🛡️ Ward Security System v2.0.2

✅ Critical MCP Server Fixes

  • Fixed MCP server lifecycle - now stays running for Claude Code integration
  • Auto-start functionality for AI assistants
  • Proper MCP protocol handshaking
  • Automatic UV tools PATH configuration

🚀 Installation

Ward Security v2.0.1 - MCP Integration Fix

Choose a tag to compare

@YamonBot YamonBot released this 18 Nov 17:05
Immutable release. Only release title and notes can be modified.

Ward Security System v2.0.1

🔧 MCP Integration Bug Fixes

  • Fixed MCP server initialization_options parameter - Resolves server startup issues
  • Improved Claude Desktop/Code integration stability - Better connection handling
  • Enhanced UVX installation support - Simplified MCP dependency management

🚀 Installation

Quick Install (Recommended)

# Install with UVX (includes MCP support)
uv tool install "git+https://github.com/yamonco/ward.git[mcp]"

# Add to Claude (super simple!)
claude mcp add ward-security ward-mcp-server

Alternative Installation

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

# Or manual installation
pip install "git+https://github.com/yamonco/ward.git[mcp]"

🤖 AI Assistant Integration

Ward now provides seamless integration with AI assistants through MCP (Model Context Protocol):

  • Claude Desktop - Automatic configuration
  • Claude Code - VS Code integration with MCP extension
  • Other AI assistants - Standard stdio MCP protocol

🎯 Available MCP Tools

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

🔒 Security Features

  • AI-powered terminal protection with intelligent policy enforcement
  • Real-time security monitoring and alerting
  • Flexible policy configuration with whitelist/blacklist support
  • Comment and annotation system for security decisions
  • Local-only installation prevents accidental global access

📝 Documentation

🔄 Previous Version Fixes

This release builds on v2.0.0 with critical MCP integration stability improvements.


🛡️ Ward Security System - AI-Powered Terminal Protection

Ward Security System v2.0.0 - Installation Fixed

Choose a tag to compare

@YamonBot YamonBot released this 18 Nov 16:31
Immutable release. Only release title and notes can be modified.

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