Skip to content

Commit 33d8356

Browse files
feat: add Daemon Mode section to README with usage examples
1 parent 187a55f commit 33d8356

File tree

1 file changed

+22
-1
lines changed

1 file changed

+22
-1
lines changed

README.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ A terminal UI for managing multiple dev services with colored logs, filtering, a
2020
- **Search** - Filter logs by text pattern
2121
- **Port Management** - Detects ports in use and offers to kill them
2222
- **MCP Server** - Integrate with Claude Code via Model Context Protocol
23+
- **Daemon Mode** - Multiple TUI/MCP clients can connect to the same services
2324

2425
## Installation
2526

@@ -83,6 +84,23 @@ devir --exclude "hmr"
8384
devir --mcp
8485
```
8586

87+
### Daemon Mode
88+
89+
Devir uses a Unix socket daemon, allowing multiple clients (TUI or MCP) to connect to the same running services:
90+
91+
```bash
92+
# Terminal 1: Start TUI (daemon starts automatically)
93+
devir
94+
95+
# Terminal 2: Connect another TUI (same services, same logs)
96+
devir
97+
98+
# Terminal 3: Connect via MCP (Claude Code controls same services)
99+
devir --mcp
100+
```
101+
102+
All clients share the same daemon and see the same logs in real-time. When Claude Code restarts a service, you'll see it immediately in your TUI.
103+
86104
### Keyboard Shortcuts
87105

88106
| Key | Action |
@@ -136,12 +154,15 @@ Add to your project's `.mcp.json`:
136154
"mcpServers": {
137155
"devir": {
138156
"command": "devir",
139-
"args": ["--mcp", "-c", "/path/to/devir.yaml"]
157+
"args": ["--mcp"],
158+
"cwd": "/path/to/project"
140159
}
141160
}
142161
}
143162
```
144163

164+
> **Note:** Set `cwd` to the directory containing your `devir.yaml`. The daemon socket is unique per project directory, so multiple projects can run independently.
165+
145166
### Available MCP Tools
146167

147168
| Tool | Description |

0 commit comments

Comments
 (0)