@aiwg/cockpit 2026.6.7 → 2026.6.8
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 +101 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,16 +1,108 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
1
3
|
# AIWG Cockpit
|
|
2
4
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
5
|
+
**Local control plane for AIWG and multi-stack agentic sessions**
|
|
6
|
+
|
|
7
|
+
Observe live agent work, attach to sessions, handle approvals, launch runtime
|
|
8
|
+
targets, and coordinate AIWG actions from one local operator surface. Cockpit
|
|
9
|
+
fronts the AIWG CLI and the agentic-sandbox executor; it does not replace either.
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm i -g aiwg # install the base AIWG CLI
|
|
13
|
+
aiwg use cockpit # install the opt-in Cockpit package, version-locked to AIWG
|
|
14
|
+
aiwg cockpit # launch the local Bridge + web UI
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
[](https://www.npmjs.com/package/@aiwg/cockpit)
|
|
18
|
+
[](https://www.npmjs.com/package/aiwg)
|
|
19
|
+
[](https://github.com/jmagly/aiwg/blob/main/LICENSE)
|
|
20
|
+
[](https://nodejs.org)
|
|
21
|
+
[](https://github.com/jmagly/aiwg/tree/main/apps/cockpit)
|
|
22
|
+
|
|
23
|
+
[**Quick Start**](#quick-start) · [**What You Get**](#what-you-get) · [**Architecture**](#architecture) · [**Verify**](#verify) · [**Release Pattern**](https://github.com/jmagly/aiwg/blob/main/apps/cockpit/RELEASE.md)
|
|
24
|
+
|
|
25
|
+
</div>
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Quick Start
|
|
30
|
+
|
|
31
|
+
The recommended path is through the base `aiwg` CLI. It installs Cockpit outside
|
|
32
|
+
the base package footprint, under `~/.aiwg/cockpit/package`, and pins the Cockpit
|
|
33
|
+
version to the installed AIWG version.
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
npm i -g aiwg
|
|
37
|
+
aiwg use cockpit
|
|
38
|
+
aiwg cockpit --status
|
|
39
|
+
aiwg cockpit
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
For direct package testing, you can install the scoped package itself:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
npm i -g @aiwg/cockpit
|
|
46
|
+
aiwg-cockpit
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Cockpit expects a reachable agentic-sandbox executor. By default the Bridge looks
|
|
50
|
+
for `http://127.0.0.1:8122` and serves the local UI on `127.0.0.1:8140`.
|
|
6
51
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
52
|
+
```bash
|
|
53
|
+
AIWG_COCKPIT_EXECUTOR_URL=http://127.0.0.1:8122 aiwg cockpit
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## What You Get
|
|
57
|
+
|
|
58
|
+
- **Home** — connected-state overview, first-run flow, and a session-first entry point.
|
|
59
|
+
- **Inventory** — host, container, Docker, and VM runtime targets with lifecycle controls.
|
|
60
|
+
- **Running** — active work across stacks, spend posture, and task stop controls.
|
|
61
|
+
- **Sessions** — observe-first terminal attach, explicit drive/control, and replay posture.
|
|
62
|
+
- **Approvals** — unified human-in-the-loop decision inbox.
|
|
63
|
+
- **Explore** — read-only AIWG capability catalog for discovery and routing.
|
|
64
|
+
- **Library** — user-owned assets cloned/imported under `~/.aiwg/cockpit/library`.
|
|
65
|
+
- **Actions** — contributed buttons that inject commands into an agentic session.
|
|
66
|
+
|
|
67
|
+
## What Cockpit Is
|
|
68
|
+
|
|
69
|
+
Cockpit is a **session-control surface, not a CLI runner**. Agents run the CLI;
|
|
70
|
+
you direct the agents. An action button injects a command into an agentic
|
|
71
|
+
session, and the agent in that session runs it. Cockpit sources read-only catalog
|
|
72
|
+
data for display and sends control-plane requests through a local token-gated
|
|
73
|
+
Bridge.
|
|
74
|
+
|
|
75
|
+
Cockpit is also **opt-in and separately published**. Nothing here ships in the
|
|
76
|
+
base `aiwg` npm package; `test/smoke/cockpit-base-footprint.test.js` guards that
|
|
77
|
+
boundary.
|
|
78
|
+
|
|
79
|
+
## What Cockpit Is Not
|
|
80
|
+
|
|
81
|
+
- **Not a replacement for `aiwg`.** The CLI remains the source of truth for AIWG
|
|
82
|
+
install, deploy, discovery, and maintenance operations.
|
|
83
|
+
- **Not an agent runtime.** Agent execution belongs to the provider stack and the
|
|
84
|
+
agentic-sandbox executor.
|
|
85
|
+
- **Not cloud-hosted.** The current surface is local-first: loopback Bridge,
|
|
86
|
+
token-gated browser/VS Code/Tauri shells, and operator-owned runtime files.
|
|
87
|
+
|
|
88
|
+
## Installation Troubleshooting
|
|
89
|
+
|
|
90
|
+
If `aiwg cockpit` reports that Cockpit is not installed, run:
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
aiwg use cockpit
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
If the installed Cockpit version does not match the base AIWG version, refresh it
|
|
97
|
+
the same way:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
aiwg use cockpit
|
|
101
|
+
```
|
|
11
102
|
|
|
12
|
-
|
|
13
|
-
|
|
103
|
+
If direct global npm install fails with `EACCES`, use the same npm global-prefix
|
|
104
|
+
fix documented in the root AIWG README, or prefer the base CLI path above so the
|
|
105
|
+
Cockpit package is installed under `~/.aiwg/cockpit/package`.
|
|
14
106
|
|
|
15
107
|
## Architecture
|
|
16
108
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aiwg/cockpit",
|
|
3
|
-
"version": "2026.6.
|
|
3
|
+
"version": "2026.6.8",
|
|
4
4
|
"description": "AIWG Cockpit — UX-first control plane over AIWG + multi-stack agentic sessions. Opt-in, separately published; NOT shipped in the base aiwg npm package (guarded by test/smoke/cockpit-base-footprint.test.js).",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|