@plumpslabs/fennec-cli 0.7.2 → 0.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +91 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/plumpslabs/fennec/main/public/fennec.png" alt="🦊 Fennec" width="170" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">@plumpslabs/fennec-cli</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<strong>Ears everywhere in your stack.</strong>
|
|
9
|
+
<br />
|
|
10
|
+
<em>AI-native developer observability — browser, terminal, and processes, all in one MCP server.</em>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p align="center">
|
|
14
|
+
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
|
|
15
|
+
<a href="https://www.npmjs.com/package/@plumpslabs/fennec-cli"><img src="https://img.shields.io/npm/v/@plumpslabs/fennec-cli" alt="npm version" /></a>
|
|
16
|
+
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js" alt="Node.js" /></a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## What is Fennec?
|
|
22
|
+
|
|
23
|
+
**Fennec** is an MCP (Model Context Protocol) server that bridges the gap between AI agents and your development environment. It gives your AI full-stack visibility:
|
|
24
|
+
|
|
25
|
+
- 🔍 **Observe** browser console logs, network requests, and performance metrics
|
|
26
|
+
- 🖥️ **Watch** terminal output and server logs
|
|
27
|
+
- 🎮 **Control** browser sessions — navigate, click, type, screenshot
|
|
28
|
+
- 🔐 **Persist** authentication sessions across conversations
|
|
29
|
+
- 🔗 **Correlate** events across layers to identify root causes automatically
|
|
30
|
+
|
|
31
|
+
## Installation
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
npm install -g @plumpslabs/fennec-cli
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Then install browser engines:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
fennec install-browsers
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Quick Start
|
|
44
|
+
|
|
45
|
+
### 1. Start the MCP server
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
fennec start
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### 2. Configure your MCP client
|
|
52
|
+
|
|
53
|
+
Add this to your MCP client's config file:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"mcpServers": {
|
|
58
|
+
"fennec": {
|
|
59
|
+
"command": "fennec",
|
|
60
|
+
"args": ["start"]
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## CLI Commands
|
|
67
|
+
|
|
68
|
+
| Command | Description |
|
|
69
|
+
|---|---|
|
|
70
|
+
| `fennec start` | Start the Fennec MCP server |
|
|
71
|
+
| `fennec pipe --name <name>` | Pipe process output to Fennec for log watching |
|
|
72
|
+
| `fennec attach-pid <pid>` | Attach to a running process by PID |
|
|
73
|
+
| `fennec attach-port <port>` | Discover and attach to a process by port |
|
|
74
|
+
| `fennec watch <path>` | Watch a log file for changes |
|
|
75
|
+
| `fennec sessions` | List saved authentication sessions |
|
|
76
|
+
| `fennec setup` | Guided setup for your MCP client |
|
|
77
|
+
| `fennec init` | Generate a configuration file |
|
|
78
|
+
| `fennec install-browsers` | Install Playwright browser engines |
|
|
79
|
+
| `fennec help` | Show help information |
|
|
80
|
+
|
|
81
|
+
## Documentation
|
|
82
|
+
|
|
83
|
+
- [Getting Started Guide](https://github.com/plumpslabs/fennec/blob/main/docs/getting-started.md)
|
|
84
|
+
- [Full Tool Reference](https://github.com/plumpslabs/fennec/blob/main/docs/tools/README.md)
|
|
85
|
+
- [Configuration Reference](https://github.com/plumpslabs/fennec/blob/main/docs/configuration.md)
|
|
86
|
+
- [Security Model](https://github.com/plumpslabs/fennec/blob/main/docs/security-model.md)
|
|
87
|
+
- [GitHub Repository](https://github.com/plumpslabs/fennec)
|
|
88
|
+
|
|
89
|
+
## License
|
|
90
|
+
|
|
91
|
+
MIT — see [LICENSE](https://github.com/plumpslabs/fennec/blob/main/LICENSE) for details.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@plumpslabs/fennec-cli",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.3",
|
|
4
4
|
"description": "Fennec CLI — pipe, attach, watch, and start the Fennec MCP server",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"@clack/prompts": "^0.7.0",
|
|
42
42
|
"pino": "^8.19.0",
|
|
43
43
|
"playwright": "^1.42.0",
|
|
44
|
-
"@plumpslabs/fennec-core": "0.7.
|
|
44
|
+
"@plumpslabs/fennec-core": "0.7.3"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
47
|
"@types/node": "^20.11.0",
|