feat: implement daemon for service management with IPC

- Added a new daemon package to manage services and client connections via Unix sockets.
- Implemented message protocol for communication between clients and the daemon.
- Integrated daemon client into the MCP server for service control.
- Refactored TUI to support both legacy runner and daemon client modes.
- Created playground environment for testing daemon functionality with example services.
- Added scripts for example services to demonstrate logging and error handling.

Author: productdevbook

.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(go build:*)",
+      "Bash(go vet:*)",
+      "Bash(make build:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "devir"
+  ]
+}

.gitignore

@@ -36,3 +36,5 @@ debug/
 *.tar.gz
 *.zip
 checksums.txt
+!.claude
+!CLAUDE.md

CLAUDE.md

@@ -0,0 +1,73 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+make build        # Build binary to ./devir
+make build-all    # Build for all platforms (dist/)
+make test         # Run tests
+make lint         # Run golangci-lint
+make install      # Build and copy to /usr/local/bin
+make clean        # Remove build artifacts
+```
+
+## Architecture
+
+Devir is a terminal UI for managing multiple dev services. Written in Go using Bubble Tea TUI framework.
+
+### Core Components
+
+```
+cmd/devir/main.go     # Entry point, CLI flags, mode selection (TUI vs MCP)
+internal/
+  config/             # YAML config loading, service validation
+  types/              # Shared types (LogLine, LogEntry, ServiceInfo)
+  runner/             # Service lifecycle management, log processing
+  tui/                # Bubble Tea model, view rendering, keyboard handling
+  mcp/                # MCP server for Claude Code integration
+```
+
+### Key Patterns
+
+**Runner** (`internal/runner/runner.go`):
+- Manages service processes with platform-specific handling (Unix/Windows)
+- Channels for log streaming: `LogChan` (simple mode), `LogEntryChan` (TUI mode)
+- Log filtering via compiled regex (`filter`, `exclude` patterns)
+- Port detection and process killing via `process_unix.go`/`process_windows.go`
+
+**TUI Model** (`internal/tui/`):
+- Bubble Tea architecture: Model → Update → View cycle
+- Tab-based service filtering (`activeTab`: -1=all, 0+=specific)
+- Auto-scroll with manual override on user scroll
+- 50ms tick for log collection
+
+**MCP Server** (`internal/mcp/mcp.go`):
+- Exposes 7 tools: `devir_start`, `devir_stop`, `devir_status`, `devir_logs`, `devir_restart`, `devir_check_ports`, `devir_kill_ports`
+- Uses `go-sdk/mcp` with stdio transport
+- Same runner infrastructure as TUI mode
+
+### Configuration
+
+Config file: `devir.yaml` (searched in current dir and parents)
+
+```yaml
+services:
+  name:
+    dir: relative/path    # Working directory
+    cmd: command to run   # Command to execute
+    port: 3000            # Port for status display
+    color: blue           # Log prefix color
+
+defaults:
+  - name                  # Services to start by default
+```
+
+### Dependencies
+
+- `github.com/charmbracelet/bubbletea` - TUI framework
+- `github.com/charmbracelet/bubbles` - TUI components (viewport, textinput)
+- `github.com/charmbracelet/lipgloss` - Styling
+- `github.com/modelcontextprotocol/go-sdk` - MCP server
+- `gopkg.in/yaml.v3` - Config parsing

cmd/devir/main.go

@@ -8,6 +8,7 @@ import (
 	tea "github.com/charmbracelet/bubbletea"
 
 	"devir/internal/config"
+	"devir/internal/daemon"
 	"devir/internal/mcp"
 	"devir/internal/runner"
 	"devir/internal/tui"
@@ -54,17 +55,62 @@ func main() {
 		os.Exit(1)
 	}
 
+	// Get socket path based on config directory
+	socketPath := daemon.SocketPath(cfg.RootDir)
+
 	// MCP mode
 	if mcpMode {
-		mcpServer := mcp.New(cfg, Version)
+		runMCPMode(cfg, socketPath)
+		return
+	}
+
+	// TUI mode
+	runTUIMode(cfg, socketPath)
+}
+
+func runMCPMode(cfg *config.Config, socketPath string) {
+	// Check if daemon already exists
+	if daemon.Exists(socketPath) {
+		// Connect to existing daemon
+		client, err := daemon.Connect(socketPath)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Failed to connect to daemon: %v\n", err)
+			os.Exit(1)
+		}
+		defer client.Close()
+
+		mcpServer := mcp.NewWithClient(cfg, client, Version)
 		if err := mcpServer.Run(); err != nil {
 			fmt.Fprintf(os.Stderr, "MCP error: %v\n", err)
 			os.Exit(1)
 		}
 		return
 	}
 
-	// TUI mode
+	// Start new daemon + MCP
+	d := daemon.New(cfg, socketPath)
+	if err := d.Start(); err != nil {
+		fmt.Fprintf(os.Stderr, "Failed to start daemon: %v\n", err)
+		os.Exit(1)
+	}
+	defer d.Stop()
+
+	// Connect as client
+	client, err := daemon.Connect(socketPath)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Failed to connect to daemon: %v\n", err)
+		os.Exit(1)
+	}
+	defer client.Close()
+
+	mcpServer := mcp.NewWithClient(cfg, client, Version)
+	if err := mcpServer.Run(); err != nil {
+		fmt.Fprintf(os.Stderr, "MCP error: %v\n", err)
+		os.Exit(1)
+	}
+}
+
+func runTUIMode(cfg *config.Config, socketPath string) {
 	services := flag.Args()
 	if len(services) == 0 {
 		services = cfg.Defaults
@@ -83,11 +129,43 @@ func main() {
 		}
 	}
 
-	// Create runner
-	r := runner.New(cfg, services, filter, exclude)
+	// Check if daemon already exists
+	if daemon.Exists(socketPath) {
+		// Connect to existing daemon (services already running)
+		client, err := daemon.Connect(socketPath)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "Failed to connect to daemon: %v\n", err)
+			os.Exit(1)
+		}
+		defer client.Close()
+
+		// Start TUI with client
+		p := tea.NewProgram(
+			tui.NewWithClient(client, services, cfg),
+			tea.WithAltScreen(),
+			tea.WithMouseCellMotion(),
+		)
+
+		if _, err := p.Run(); err != nil {
+			fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+			os.Exit(1)
+		}
+		return
+	}
+
+	// No existing daemon - start new daemon + TUI
+	d := daemon.New(cfg, socketPath)
+	if err := d.Start(); err != nil {
+		fmt.Fprintf(os.Stderr, "Failed to start daemon: %v\n", err)
+		os.Exit(1)
+	}
+	defer d.Stop()
 
 	// Check for ports in use
+	r := runner.New(cfg, services, filter, exclude)
 	portsInUse := r.CheckPorts()
+	killPorts := false
+
 	if len(portsInUse) > 0 {
 		fmt.Println("\n⚠️  Aşağıdaki portlar zaten kullanımda:")
 		for name, port := range portsInUse {
@@ -99,20 +177,28 @@ func main() {
 		_, _ = fmt.Scanln(&answer)
 
 		if answer == "y" || answer == "Y" {
-			for name, port := range portsInUse {
-				if err := r.KillPort(port); err != nil {
-					fmt.Printf("   ✗ %s (port %d) kapatılamadı: %v\n", name, port, err)
-				} else {
-					fmt.Printf("   ✓ %s (port %d) kapatıldı\n", name, port)
-				}
-			}
-			fmt.Println()
+			killPorts = true
 		}
 	}
 
+	// Connect as client
+	client, err := daemon.Connect(socketPath)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Failed to connect to daemon: %v\n", err)
+		os.Exit(1)
+	}
+	defer client.Close()
+
+	// Start services via daemon
+	_, err = client.StartAndWait(services, killPorts, 10*1e9) // 10 seconds timeout
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Failed to start services: %v\n", err)
+		os.Exit(1)
+	}
+
 	// Start TUI
 	p := tea.NewProgram(
-		tui.New(r),
+		tui.NewWithClient(client, services, cfg),
 		tea.WithAltScreen(),
 		tea.WithMouseCellMotion(),
 	)
@@ -133,6 +219,7 @@ Options:
   -c <file>     Config file path (default: devir.yaml)
   -filter <p>   Show only logs matching pattern
   -exclude <p>  Hide logs matching pattern
+  -mcp          Run as MCP server (daemon mode)
   -v            Show version
   -h            Show this help
 
@@ -142,6 +229,10 @@ Examples:
   devir --filter "error"   # Show only errors
   devir --exclude "hmr"    # Hide HMR logs
 
+Daemon Mode:
+  Multiple TUI/MCP clients can connect to same daemon.
+  First instance starts daemon, others connect automatically.
+
 Keyboard Shortcuts:
   Tab          Cycle through services
   1-9          Select specific service