Repository navigation
Releases: yamonco/ward
Release list
Ward Security System v2.0.3 - User Experience Fixes
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
🛡️ 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
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-serverAlternative 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 pathsward_plant- Plant protection on directoriesward_favorites_*- Manage favorite directoriesward_search- Search through indexed foldersward_bookmark_*- Manage bookmarksward_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
- Project: https://github.com/yamonco/ward
- Help:
ward-mcp infoafter installation - Status:
ward-mcp status --target all
🔄 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
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 | bashManual 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-projectAlternative 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 foldersAI Assistant Integration
Once installed with MCP, Ward tools are available in Claude conversations:
ward_check- Check security policies for pathsward_plant- Plant protection for directoriesward_search- Search through indexed foldersward_favorites_*- Manage favorite directoriesward_bookmark_*- Manage bookmarksward_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