brainctl 0.1.12 → 0.1.14
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 +34 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,26 +17,11 @@
|
|
|
17
17
|
|
|
18
18
|
## 📦 Install & Set Up
|
|
19
19
|
|
|
20
|
-
> **
|
|
21
|
-
|
|
22
|
-
### 1. Install the CLI
|
|
23
|
-
|
|
24
|
-
```bash
|
|
25
|
-
npm install -g brainctl
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
Verify:
|
|
29
|
-
|
|
30
|
-
```bash
|
|
31
|
-
brainctl --version
|
|
32
|
-
brainctl doctor # checks which agents are on your PATH
|
|
33
|
-
```
|
|
20
|
+
> **Zero install required.** Brainctl runs straight from npx — register it as an MCP server in your agent and you're done. No global install, no bin to manage.
|
|
34
21
|
|
|
35
22
|
> **Prerequisite:** at least one of `claude`, `codex`, or `gemini` installed and on your `PATH`.
|
|
36
23
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
### 2. Register `brainctl` as an MCP server (pick your agents)
|
|
24
|
+
### 1. Register `brainctl` as an MCP server (pick your agents)
|
|
40
25
|
|
|
41
26
|
Each agent has its own config file. Brainctl exposes **22 MCP tools** (profiles, sync, skills, run, web UI launch, etc.) — once you register it, any of them can call those tools.
|
|
42
27
|
|
|
@@ -70,7 +55,13 @@ Reload the MCP in Claude Code: `/mcp` → `brainctl` → **Reconnect**.
|
|
|
70
55
|
<details open>
|
|
71
56
|
<summary><b>🟢 Codex</b> — <code>~/.codex/config.toml</code></summary>
|
|
72
57
|
|
|
73
|
-
|
|
58
|
+
Easiest: use the `codex` CLI.
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
codex mcp add brainctl -- npx -y brainctl mcp
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Or edit `~/.codex/config.toml` directly:
|
|
74
65
|
|
|
75
66
|
```toml
|
|
76
67
|
[mcp_servers.brainctl]
|
|
@@ -85,7 +76,13 @@ Restart your Codex session to pick it up.
|
|
|
85
76
|
<details open>
|
|
86
77
|
<summary><b>🔵 Gemini CLI</b> — <code>~/.gemini/settings.json</code></summary>
|
|
87
78
|
|
|
88
|
-
|
|
79
|
+
Easiest: use the `gemini` CLI.
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
gemini mcp add -s user brainctl npx -y brainctl mcp
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Or edit `~/.gemini/settings.json` directly (merge into the top-level `mcpServers` object):
|
|
89
86
|
|
|
90
87
|
```json
|
|
91
88
|
{
|
|
@@ -104,14 +101,28 @@ Restart your Gemini session.
|
|
|
104
101
|
|
|
105
102
|
---
|
|
106
103
|
|
|
107
|
-
###
|
|
104
|
+
### 2. Open the dashboard
|
|
105
|
+
|
|
106
|
+
From any MCP-connected agent, just ask:
|
|
107
|
+
|
|
108
|
+
> _"Open the brainctl UI"_
|
|
109
|
+
|
|
110
|
+
It'll start the server **and** open your browser automatically at http://127.0.0.1:3333.
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
### Optional: install the CLI globally
|
|
115
|
+
|
|
116
|
+
Prefer a shell command? Install globally:
|
|
108
117
|
|
|
109
118
|
```bash
|
|
110
|
-
brainctl
|
|
111
|
-
|
|
119
|
+
npm install -g brainctl
|
|
120
|
+
brainctl --version
|
|
121
|
+
brainctl doctor # checks which agents are on your PATH
|
|
122
|
+
brainctl ui # launch the dashboard from your terminal
|
|
112
123
|
```
|
|
113
124
|
|
|
114
|
-
|
|
125
|
+
The CLI is entirely optional — everything it does is also available through the MCP tools and the dashboard.
|
|
115
126
|
|
|
116
127
|
---
|
|
117
128
|
|