@mblua/agentscommander 0.39.0 → 0.41.0
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 +23 -9
- package/install.js +68 -56
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -5,11 +5,23 @@
|
|
|
5
5
|
When installing through npm, use `-g` so the `agentscommander` command is available from any directory:
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
npm install -g @mblua/agentscommander
|
|
8
|
+
npm install -g @mblua/agentscommander
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
This installs the current `latest` release. Before installing, follow [Resolve versions and preserve configuration](#resolve-versions-and-preserve-configuration), then [Install and validate](#install-and-validate). Check the supported platforms and requirements below before installing.
|
|
12
12
|
|
|
13
|
+
## Test pre-release builds
|
|
14
|
+
|
|
15
|
+
New builds are published first under the `next` tag. To try one before it becomes the default release:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npm install -g @mblua/agentscommander@next
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
`next` builds are not fully tested and can break. Share feedback in the [#testers Discord channel](https://discord.gg/T4R8RvEFX4).
|
|
22
|
+
|
|
23
|
+
## npm website install command
|
|
24
|
+
|
|
13
25
|
The npm website's **Install** sidebar shows the generic local-install command. For the recommended global npm installation, include `-g` as shown above.
|
|
14
26
|
|
|
15
27
|
## Choosing the npm route
|
|
@@ -46,22 +58,24 @@ Before an install, update, or uninstall, resolve and report the exact existing p
|
|
|
46
58
|
```bash
|
|
47
59
|
npm list -g @mblua/agentscommander --depth=0
|
|
48
60
|
npm root -g
|
|
49
|
-
npm view @mblua/agentscommander
|
|
61
|
+
npm view @mblua/agentscommander version
|
|
50
62
|
```
|
|
51
63
|
|
|
52
64
|
`npm list` reports the installed package version and can exit nonzero when the package is absent. `npm root -g` exits 0 and prints the global `node_modules` directory. Use that root to inspect the installed `@mblua/agentscommander/package.json`, `install.js`, `run.js`, and native file under `bin/`. Correlate the package-manager record and `package.json` version with the install script's version and release URL, the launcher's exact native path, and the corresponding GitHub tag, asset, and checksum. `npm view` reports the selected registry version without installing it. If the local records, independent release evidence, native file, or selected version disagree or cannot be identified exactly, stop before mutation. `agentscommander --version` prints the native CLI version from `v0.31.0` onward; `v0.30.5` and older builds reject that flag, so probe a binary for a self-reported version only after its exact tag proves support.
|
|
53
65
|
|
|
54
66
|
The existing binary's exact resolver determines what must be preserved. The selected package's exact release tag determines post-install behavior. Verify both against the corresponding `v<version>` source tag; do not use `main` as evidence for a published npm package.
|
|
55
67
|
|
|
56
|
-
### npm `0.
|
|
68
|
+
### npm `0.41.0`
|
|
69
|
+
|
|
70
|
+
`0.41.0` is the release described by this package. Its installer downloads the `v0.41.0` native release asset and verifies it against `SHASUMS256.txt`. On Windows and Linux it renames the asset to the unsuffixed executable in the package's `bin/` directory. On macOS it downloads the `agentscommander-mac-<arch>.app.tar.gz` bundle, extracts the single `.app` directory into `bin/`, and validates the executable named by the bundle's `CFBundleExecutable`. The launcher spawns that executable and injects no configuration override. A global install also creates the desktop entry points described in [Windows Start Menu shortcut](#windows-start-menu-shortcut), [macOS Launchpad and Spotlight](#macos-launchpad-and-spotlight), and [Linux application menu](#linux-application-menu).
|
|
57
71
|
|
|
58
|
-
|
|
72
|
+
The `v0.41.0` native resolver selects a non-blank `AGENTSCOMMANDER_CONFIG_DIR` value verbatim when present. Otherwise, the normal unsuffixed npm executable selects the user's home directory plus `.agentscommander`, independently of its install location and build profile. It does not probe an adjacent configuration directory on this route. Suffixed executables use their adjacent `.agentscommander_<suffix>` directory and refuse to start when it is not writable.
|
|
59
73
|
|
|
60
|
-
|
|
74
|
+
**Version `0.41.0` keeps the `0.32.0` default location.** Versions `0.31.0` and `0.30.5` normally selected `.agentscommander` beside the native executable under `@mblua/agentscommander/bin/` when that location was writable, with their documented home fallback and refusal rules. None of `0.32.0` through `0.41.0` discovers, copies, moves or migrates any old configuration automatically. Before updating from `0.31.0` or older, identify and back up the old version's active configuration. If you intend to keep using that directory, set `AGENTSCOMMANDER_CONFIG_DIR` to its verified path; otherwise arrange the intended configuration at the new home location separately. Version `0.33.0` dropped the legacy pre-v2 `codingAgentProfiles` settings migration, and later versions keep it removed.
|
|
61
75
|
|
|
62
|
-
**Version `0.
|
|
76
|
+
**Version `0.41.0` renames its configuration files, and you cannot downgrade past it.** On the first start it renames the files inside the active configuration directory to the layered names of the file naming convention, for example `settings.json` to `settings.30.instance.no-git.json`, once, without deleting or overwriting any file. An older version started afterwards does not find those names and starts from defaults. Back up the configuration directory before updating.
|
|
63
77
|
|
|
64
|
-
**Version `0.
|
|
78
|
+
**Version `0.41.0` keeps bounded backups of its settings file.** Every successful save archives the bytes it replaced into `settings.30.instance.no-git.backup.1.json` through `settings.30.instance.no-git.backup.5.json` in the same configuration directory, newest in slot 1. These files live beside `settings.30.instance.no-git.json`, so preserve them with it when you move or back up a configuration directory.
|
|
65
79
|
|
|
66
80
|
The older npm `0.30.3` resolver immediately selected an executable-adjacent directory when the parent and stem were available and did not support the configuration override or portable-marker/write-probe rules. npm never published `0.30.4`; that number exists only as a GitHub release. For other versions, inspect `src-tauri/src/config/mod.rs`, `src-tauri/src/config/profile.rs`, `npm/run.js`, and `npm/install.js` at the exact `v<version>` tag.
|
|
67
81
|
|
|
@@ -72,7 +86,7 @@ Copy the complete persistent configuration directory to a user-controlled backup
|
|
|
72
86
|
## Install and validate
|
|
73
87
|
|
|
74
88
|
```bash
|
|
75
|
-
npm install -g @mblua/agentscommander
|
|
89
|
+
npm install -g @mblua/agentscommander
|
|
76
90
|
```
|
|
77
91
|
|
|
78
92
|
The command installs the current `latest` release and exits 0 on success. The package's install script downloads that package version's raw asset and `SHASUMS256.txt` from `mblua/AgentsCommander`, computes SHA-256, and fails the install on a missing record or mismatch. This does not protect against compromise of the publisher or repository account because the asset and checksum share that trust boundary.
|
|
@@ -84,7 +98,7 @@ npm list -g @mblua/agentscommander --depth=0
|
|
|
84
98
|
agentscommander --help
|
|
85
99
|
```
|
|
86
100
|
|
|
87
|
-
Both commands must exit 0. Confirm that `npm list` and the installed `package.json` report the `latest` version that `npm view @mblua/agentscommander
|
|
101
|
+
Both commands must exit 0. Confirm that `npm list` and the installed `package.json` report the `latest` version that `npm view @mblua/agentscommander version` returned; re-check the installed scripts, native path, and checksum correlation described above. `--help` must print the AgentsCommander command help, and on `0.31.0` or newer `agentscommander --version` must print the same version `npm list` reports. The npm package is `@mblua/agentscommander`; the installed command is `agentscommander`.
|
|
88
102
|
|
|
89
103
|
### Windows Start Menu shortcut
|
|
90
104
|
|
package/install.js
CHANGED
|
@@ -9,7 +9,7 @@ const { createStartMenuShortcut } = require('./windows-shortcut');
|
|
|
9
9
|
const { createLaunchpadAlias } = require('./macos-alias');
|
|
10
10
|
const { createDesktopEntry } = require('./linux-desktop-entry');
|
|
11
11
|
|
|
12
|
-
const VERSION = "0.
|
|
12
|
+
const VERSION = "0.41.0"; // Must match package.json
|
|
13
13
|
const OWNER = 'mblua';
|
|
14
14
|
const REPO = 'AgentsCommander';
|
|
15
15
|
|
|
@@ -104,11 +104,74 @@ async function verifyChecksum(filePath, fileName, expectedShasums) {
|
|
|
104
104
|
});
|
|
105
105
|
}
|
|
106
106
|
|
|
107
|
+
function installMacBundle() {
|
|
108
|
+
console.log('Extracting macOS bundle...');
|
|
109
|
+
const extractTmpDir = path.join(binDir, 'tmp-extract');
|
|
110
|
+
if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
|
|
111
|
+
fs.mkdirSync(extractTmpDir, { recursive: true });
|
|
112
|
+
try {
|
|
113
|
+
execSync(`tar -xzf "${tmpPath}" -C "${extractTmpDir}"`);
|
|
114
|
+
const extractedFiles = fs.readdirSync(extractTmpDir);
|
|
115
|
+
for (const file of extractedFiles) {
|
|
116
|
+
const dest = path.join(binDir, file);
|
|
117
|
+
if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
|
|
118
|
+
fs.renameSync(path.join(extractTmpDir, file), dest);
|
|
119
|
+
}
|
|
120
|
+
} finally {
|
|
121
|
+
if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
|
|
122
|
+
}
|
|
123
|
+
fs.unlinkSync(tmpPath);
|
|
124
|
+
const macBinPath = assertExecutable('darwin', binDir);
|
|
125
|
+
// <bundle>.app/Contents/MacOS/<exe> -> <bundle>.app
|
|
126
|
+
const bundlePath = path.dirname(path.dirname(path.dirname(macBinPath)));
|
|
127
|
+
try {
|
|
128
|
+
const alias = createLaunchpadAlias(bundlePath, { platform });
|
|
129
|
+
if (alias.created) {
|
|
130
|
+
console.log(`Launchpad alias created: ${alias.path}`);
|
|
131
|
+
console.log('The app bundle is not signed, so macOS may block the first launch. Do not bypass Gatekeeper: report the block at https://github.com/mblua/AgentsCommander/issues');
|
|
132
|
+
}
|
|
133
|
+
} catch (err) {
|
|
134
|
+
console.warn(`Warning: Launchpad alias not created: ${err.message}`);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function createPlatformShortcut(finalBinPath) {
|
|
139
|
+
if (platform === 'win32') {
|
|
140
|
+
try {
|
|
141
|
+
const shortcut = createStartMenuShortcut(finalBinPath);
|
|
142
|
+
if (shortcut.created) console.log(`Start Menu shortcut created: ${shortcut.path}`);
|
|
143
|
+
} catch (err) {
|
|
144
|
+
console.warn(`Warning: Start Menu shortcut not created: ${err.message}`);
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
if (platform === 'linux') {
|
|
148
|
+
try {
|
|
149
|
+
const entry = createDesktopEntry(finalBinPath, { platform });
|
|
150
|
+
if (entry.created) console.log(`Application menu entry created: ${entry.path}`);
|
|
151
|
+
} catch (err) {
|
|
152
|
+
console.warn(`Warning: application menu entry not created: ${err.message}`);
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function installBinary() {
|
|
158
|
+
const finalBinPath = path.join(binDir, platform === 'win32' ? 'agentscommander.exe' : 'agentscommander');
|
|
159
|
+
if (platform !== 'win32') {
|
|
160
|
+
fs.chmodSync(tmpPath, 0o755);
|
|
161
|
+
}
|
|
162
|
+
fs.renameSync(tmpPath, finalBinPath);
|
|
163
|
+
createPlatformShortcut(finalBinPath);
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
function cleanupFailedInstall(shasumTmpPath) {
|
|
167
|
+
if (fs.existsSync(tmpPath)) fs.unlinkSync(tmpPath);
|
|
168
|
+
if (typeof shasumTmpPath !== 'undefined' && fs.existsSync(shasumTmpPath)) fs.unlinkSync(shasumTmpPath);
|
|
169
|
+
}
|
|
170
|
+
|
|
107
171
|
async function main() {
|
|
108
172
|
const shasumTmpPath = path.join(binDir, 'SHASUMS256.txt.tmp');
|
|
109
173
|
try {
|
|
110
174
|
console.log(`Downloading SHASUMS256.txt from ${shasumUrl}`);
|
|
111
|
-
// moved to top
|
|
112
175
|
await downloadFile(shasumUrl, shasumTmpPath);
|
|
113
176
|
const expectedShasums = fs.readFileSync(shasumTmpPath, 'utf8');
|
|
114
177
|
|
|
@@ -119,65 +182,14 @@ async function main() {
|
|
|
119
182
|
await verifyChecksum(tmpPath, assetName, expectedShasums);
|
|
120
183
|
console.log('Checksum verified.');
|
|
121
184
|
|
|
122
|
-
if (platform === 'darwin')
|
|
123
|
-
|
|
124
|
-
const extractTmpDir = path.join(binDir, 'tmp-extract');
|
|
125
|
-
if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
|
|
126
|
-
fs.mkdirSync(extractTmpDir, { recursive: true });
|
|
127
|
-
try {
|
|
128
|
-
execSync(`tar -xzf "${tmpPath}" -C "${extractTmpDir}"`);
|
|
129
|
-
const extractedFiles = fs.readdirSync(extractTmpDir);
|
|
130
|
-
for (const file of extractedFiles) {
|
|
131
|
-
const dest = path.join(binDir, file);
|
|
132
|
-
if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
|
|
133
|
-
fs.renameSync(path.join(extractTmpDir, file), dest);
|
|
134
|
-
}
|
|
135
|
-
} finally {
|
|
136
|
-
if (fs.existsSync(extractTmpDir)) fs.rmSync(extractTmpDir, { recursive: true, force: true });
|
|
137
|
-
}
|
|
138
|
-
fs.unlinkSync(tmpPath);
|
|
139
|
-
const macBinPath = assertExecutable('darwin', binDir);
|
|
140
|
-
// <bundle>.app/Contents/MacOS/<exe> -> <bundle>.app
|
|
141
|
-
const bundlePath = path.dirname(path.dirname(path.dirname(macBinPath)));
|
|
142
|
-
try {
|
|
143
|
-
const alias = createLaunchpadAlias(bundlePath, { platform });
|
|
144
|
-
if (alias.created) {
|
|
145
|
-
console.log(`Launchpad alias created: ${alias.path}`);
|
|
146
|
-
console.log('The app bundle is not signed, so macOS may block the first launch. Do not bypass Gatekeeper: report the block at https://github.com/mblua/AgentsCommander/issues');
|
|
147
|
-
}
|
|
148
|
-
} catch (err) {
|
|
149
|
-
console.warn(`Warning: Launchpad alias not created: ${err.message}`);
|
|
150
|
-
}
|
|
151
|
-
} else {
|
|
152
|
-
const finalBinPath = path.join(binDir, platform === 'win32' ? 'agentscommander.exe' : 'agentscommander');
|
|
153
|
-
if (platform !== 'win32') {
|
|
154
|
-
fs.chmodSync(tmpPath, 0o755);
|
|
155
|
-
}
|
|
156
|
-
fs.renameSync(tmpPath, finalBinPath);
|
|
157
|
-
if (platform === 'win32') {
|
|
158
|
-
try {
|
|
159
|
-
const shortcut = createStartMenuShortcut(finalBinPath);
|
|
160
|
-
if (shortcut.created) console.log(`Start Menu shortcut created: ${shortcut.path}`);
|
|
161
|
-
} catch (err) {
|
|
162
|
-
console.warn(`Warning: Start Menu shortcut not created: ${err.message}`);
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
if (platform === 'linux') {
|
|
166
|
-
try {
|
|
167
|
-
const entry = createDesktopEntry(finalBinPath, { platform });
|
|
168
|
-
if (entry.created) console.log(`Application menu entry created: ${entry.path}`);
|
|
169
|
-
} catch (err) {
|
|
170
|
-
console.warn(`Warning: application menu entry not created: ${err.message}`);
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
}
|
|
185
|
+
if (platform === 'darwin') installMacBundle();
|
|
186
|
+
else installBinary();
|
|
174
187
|
|
|
175
188
|
fs.unlinkSync(shasumTmpPath);
|
|
176
189
|
console.log('Installation completed successfully.');
|
|
177
190
|
} catch (err) {
|
|
178
191
|
console.error('Installation failed:', err.message);
|
|
179
|
-
|
|
180
|
-
if (typeof shasumTmpPath !== 'undefined' && fs.existsSync(shasumTmpPath)) fs.unlinkSync(shasumTmpPath);
|
|
192
|
+
cleanupFailedInstall(shasumTmpPath);
|
|
181
193
|
process.exit(1);
|
|
182
194
|
}
|
|
183
195
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mblua/agentscommander",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.41.0",
|
|
4
4
|
"description": "Install and run AgentsCommander, the local terminal session manager for AI coding agent teams with Claude Code, Codex, Hermes, Cursor CLI, OpenCode, and more to come.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"bin": {
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"engines": {
|
|
22
22
|
"node": ">=18.0.0"
|
|
23
23
|
},
|
|
24
|
-
"homepage": "https://agentscommander.
|
|
24
|
+
"homepage": "https://agentscommander.org",
|
|
25
25
|
"bugs": {
|
|
26
26
|
"url": "https://github.com/mblua/AgentsCommander/issues"
|
|
27
27
|
},
|