Skip to content

Commit 4a6dd3d

Browse files
committed
0.2.0
1 parent 74c8604 commit 4a6dd3d

31 files changed

Lines changed: 6221 additions & 75 deletions

CHANGELOG.md

Lines changed: 114 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,120 @@
11
# Changelog
22

3+
## [0.2.0] - 2025-11-17
4+
5+
### 🚀 Major Enhancement: Persistent Daemon Architecture
6+
7+
This release introduces a **complete persistent daemon architecture** that provides Gemini CLI-like session persistence for browser automation MCP servers, enabling seamless multi-command workflows.
8+
9+
### ✨ New Features
10+
11+
#### Persistent Browser Sessions
12+
- **Daemon Background Service** - Cross-platform daemon process for managing persistent MCP connections
13+
- **Automatic Session Persistence** - Browser state maintained across CLI command invocations
14+
- **Zero Configuration Setup** - Works out of the box with existing `mcp_servers.json` configurations
15+
- **Smart Client Bridge** - Automatic daemon usage with fallback to direct connections
16+
- **Multi-MCP Server Support** - Simultaneous sessions for Chrome DevTools, Playwright, and other persistent servers
17+
18+
#### New Daemon CLI Commands
19+
- `daemon start` - Start the background daemon service
20+
- `daemon stop` - Stop the running daemon
21+
- `daemon status` - Display daemon status and active sessions
22+
- `daemon logs` - View daemon service logs
23+
24+
#### Enhanced Browser Automation
25+
- **Chrome DevTools Integration** - Persistent sessions with console access, navigation, and screenshots
26+
- **Playwright Integration** - Advanced browser automation with element interaction and page snapshots
27+
- **Session Auto-Creation** - Browser sessions automatically created when tools are called
28+
- **Cross-Platform Compatibility** - Windows, Linux, macOS, and WSL support
29+
30+
### 🔧 Configuration Enhancements
31+
32+
#### Simplified Server Configuration
33+
```json
34+
{
35+
"chrome-devtools": {
36+
"command": "npx",
37+
"args": ["-y", "chrome-devtools-mcp@latest", "--isolated"],
38+
"persistent": true,
39+
"timeout": 60
40+
},
41+
"playwright": {
42+
"command": "npx",
43+
"args": ["-y", "@playwright/mcp@latest"],
44+
"persistent": true,
45+
"timeout": 60
46+
}
47+
}
48+
```
49+
50+
- **Persistent Flag** - Simple boolean to enable daemon-managed sessions
51+
- **Chrome Isolation** - Automatic `--isolated` flag for browser profile conflict prevention
52+
- **Smart Defaults** - Browser automation servers configured for persistence by default
53+
- **HTTP API Communication** - RESTful daemon interface for reliable session management
54+
55+
### 🏗️ Architecture Improvements
56+
57+
#### Daemon System
58+
- **Cross-Platform Process Management** - Native process lifecycle management for all platforms
59+
- **HTTP API Server** - RESTful interface for daemon communication
60+
- **Session Health Monitoring** - Automatic session cleanup and recovery
61+
- **Resource Management** - Proper cleanup of browser processes and connections
62+
- **PID File Management** - Daemon process tracking and lifecycle coordination
63+
64+
#### Smart Client Architecture
65+
- **Automatic Daemon Detection** - Checks for running daemon before creating connections
66+
- **Graceful Fallback** - Falls back to direct connections if daemon unavailable
67+
- **Session Auto-Start** - Automatically starts daemon for persistent servers
68+
- **Transport-Agnostic** - Works with both HTTP and stdio MCP servers
69+
70+
### 🛠️ Developer Experience
71+
72+
#### Enhanced Error Handling
73+
- **Daemon Status Indicators** - Clear feedback on daemon connectivity
74+
- **Session State Reporting** - Detailed session health and activity information
75+
- **Graceful Degradation** - Continues working even if daemon unavailable
76+
- **Comprehensive Logging** - Detailed daemon logs for troubleshooting
77+
78+
#### Improved CLI Interface
79+
- **Verbose Mode** - Enhanced debugging with daemon communication details
80+
- **Progress Indicators** - Real-time feedback on daemon operations
81+
- **Clear Error Messages** - Actionable error messages with suggestions
82+
- **Status Reporting** - Rich status information for all daemon-managed sessions
83+
84+
### 🔍 Testing and Validation
85+
86+
#### Browser Automation Workflows
87+
- **Chrome DevTools Testing** - Complete workflow validation: navigate → console access → screenshots
88+
- **Playwright Testing** - Advanced automation testing: navigation → interaction → screenshots
89+
- **Session Persistence** - Verified browser state maintained across multiple CLI invocations
90+
- **Cross-Platform Verification** - Daemon functionality validated on macOS, Linux, and Windows
91+
92+
#### Multi-Server Support
93+
- **Simultaneous Sessions** - Multiple MCP servers running concurrently
94+
- **Resource Isolation** - Separate browser instances for each MCP server
95+
- **Memory Management** - Efficient resource usage with proper cleanup
96+
- **Process Recovery** - Automatic recovery from browser process crashes
97+
98+
### 📚 Documentation Updates
99+
100+
#### Configuration Guide
101+
- **Daemon Setup** - Complete guide for enabling persistent sessions
102+
- **Browser Automation** - Updated examples for Chrome DevTools and Playwright
103+
- **Troubleshooting** - Common issues and solutions for daemon usage
104+
- **Migration Guide** - Instructions for upgrading from v0.1.0
105+
106+
#### Updated Examples
107+
- **Persistent Workflows** - Real-world examples of multi-command browser automation
108+
- **Daemon Management** - Complete lifecycle management examples
109+
- **Chrome DevTools Console** - Browser console access and debugging examples
110+
- **Cross-Platform Usage** - Platform-specific configuration and usage
111+
112+
---
113+
3114
## [0.1.0] - 2025-11-15
4115

116+
### 🎉 Initial Release
117+
5118
### Added
6119
- **MCP Protocol Implementation**: Full JSON-RPC 2.0 support for Model Context Protocol
7120
- **Multi-Transport Support**: HTTP and stdio transport layers for MCP servers
@@ -68,5 +181,4 @@
68181
- Go-based implementation for performance and portability
69182
- Makefile with comprehensive build targets
70183
- Automated dependency management
71-
- Development environment setup scripts
72-
184+
- Development environment setup scripts

0 commit comments

Comments
 (0)