@rse/claudex 1.0.3 → 1.0.5

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/CHANGELOG.md CHANGED
@@ -2,6 +2,19 @@
2
2
  ChangeLog
3
3
  =========
4
4
 
5
+ 1.0.5 (2026-05-13)
6
+ ------------------
7
+
8
+ - BUGFIX: fix "claudex -C install|update" by correctly passing options -s (sudo) to capsula
9
+ - BUGFIX: use "node" inside container instead of full path to Node executable
10
+ - BUGFIX: correctly pass environment to container processes
11
+ - BUGFIX: remove incorrect Capsula environment check
12
+
13
+ 1.0.4 (2026-05-10)
14
+ ------------------
15
+
16
+ - IMPROVEMENT: set `ASE_HEADLESS=true` when option -A/--ase and -p/--print are given
17
+
5
18
  1.0.3 (2026-05-10)
6
19
  ------------------
7
20
 
package/claudex.js CHANGED
@@ -254,26 +254,26 @@ const actionInstall = async (capsula) => {
254
254
  /* dispatch according to host/container mode */
255
255
  if (capsula) {
256
256
  info("update Debian GNU/Linux operating system");
257
- await self("internal", "capsula", "sudo", "-E", "apt", "update", "-qq");
258
- await self("internal", "capsula", "sudo", "-E", "apt", "upgrade", "-qq", "-y");
257
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "update", "-qq");
258
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "upgrade", "-qq", "-y");
259
259
  info("install Tmux / LazyGit / Git");
260
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "tmux", "lazygit", "git");
260
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "tmux", "lazygit", "git");
261
261
  info("install Node.js");
262
- await self("internal", "capsula", "sudo", "-E", "bash", "-c", "curl -fsSL https://deb.nodesource.com/setup_24.x | bash -");
263
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "nodejs");
264
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "binutils", "gcc", "g++", "make");
262
+ await self("internal", "capsula", "-s", "sudo", "-E", "bash", "-c", "curl -fsSL https://deb.nodesource.com/setup_24.x | bash -");
263
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "nodejs");
264
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "binutils", "gcc", "g++", "make");
265
265
  info("install Claude Code");
266
266
  await self("internal", "capsula", "bash", "-c", `PATH="${HOME}/.local/bin:$PATH"; curl -kfsSL https://claude.ai/install.sh | bash`);
267
267
  info("install ANSI-Recolor");
268
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor");
268
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor");
269
269
  info("install TypeScript LS");
270
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server");
270
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server");
271
271
  info("install CodeBurn");
272
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn");
272
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn");
273
273
  info("install ASE");
274
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase");
274
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase");
275
275
  info("install Claude wrapper");
276
- await self("internal", "capsula", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude");
276
+ await self("internal", "capsula", "-s", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude");
277
277
  /* prune obsolete versions only after successful install */
278
278
  await self("internal", "capsula", "bash", "-c", "VERSIONS=\"$HOME/.local/share/claude/versions\"; " +
279
279
  "[ -d \"$VERSIONS\" ] || exit 0; " +
@@ -411,20 +411,20 @@ const actionUpdate = async (capsula) => {
411
411
  /* dispatch according to host/container mode */
412
412
  if (capsula) {
413
413
  info("update Debian GNU/Linux operating system");
414
- await self("internal", "capsula", "sudo", "apt", "update", "-qq");
415
- await self("internal", "capsula", "sudo", "apt", "upgrade", "-qq", "-y");
414
+ await self("internal", "capsula", "-s", "sudo", "apt", "update", "-qq");
415
+ await self("internal", "capsula", "-s", "sudo", "apt", "upgrade", "-qq", "-y");
416
416
  info("update Claude Code");
417
417
  await self("internal", "capsula", "bash", "-c", `PATH="${HOME}/.local/bin:$PATH"; ${HOME}/.local/bin/claude update`);
418
418
  info("update ANSI-Recolor");
419
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor");
419
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor");
420
420
  info("update TypeScript LS");
421
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server");
421
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server");
422
422
  info("update CodeBurn");
423
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn");
423
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn");
424
424
  info("update ASE");
425
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase");
425
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase");
426
426
  info("update Claude wrapper");
427
- await self("internal", "capsula", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude");
427
+ await self("internal", "capsula", "-s", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude");
428
428
  }
429
429
  else {
430
430
  info("update Tmux");
@@ -747,9 +747,6 @@ const actionDefault = (opts, args) => {
747
747
  innerFlags.push("-A");
748
748
  /* branch: tmux mode (with or without capsula) */
749
749
  if (opts.tmux) {
750
- /* sanity check environment */
751
- if (ENVIRONMENT === "capsula")
752
- fatal("cannot execute tmux mode from within Capsula environment");
753
750
  /* determine session name (from "-T <name>" option value, or auto-detected) */
754
751
  let session;
755
752
  if (typeof opts.tmux === "string" && opts.tmux !== "")
@@ -781,7 +778,7 @@ const actionDefault = (opts, args) => {
781
778
  `HOME=${shQ.quote([HOME])} ` +
782
779
  `CLAUDEX_FLAGS=${shQ.quote([claudexFlags])} ` +
783
780
  `sudo -E -u ${shQ.quote([USER])} ` +
784
- `${shQ.quote([process.execPath, selfPathJS])} ` +
781
+ `${shQ.quote(["node" /* process.execPath is not valid inside container! */, selfPathJS])} ` +
785
782
  `${opts.ase ? "-A " : ""}internal tmux new-session -A -s ${shQ.quote([session])}`
786
783
  ]);
787
784
  }
@@ -791,7 +788,7 @@ const actionDefault = (opts, args) => {
791
788
  selfPathJS, "internal", "capsula",
792
789
  "-e", `CLAUDEX_FLAGS=${claudexFlags}`,
793
790
  "-e", `CLAUDEX_INTERNAL_EXEC=${inPane}`,
794
- "-C", container, process.execPath, selfPathJS,
791
+ "-C", container, "node" /* process.execPath is not valid inside container! */, selfPathJS,
795
792
  ...(opts.ase ? ["-A"] : []), "internal", "tmux",
796
793
  "new-session", "-A", "-s", session, "-n", "claude",
797
794
  "claudex", "internal", "exec"
@@ -833,7 +830,7 @@ const actionDefault = (opts, args) => {
833
830
  `TERM=${shQ.quote([TERM])} ` +
834
831
  `HOME=${shQ.quote([HOME])} ` +
835
832
  `sudo -E -u ${shQ.quote([USER])} ` +
836
- `${shQ.quote([process.execPath, selfPathJS])} ` +
833
+ `${shQ.quote(["node" /* process.execPath is not valid inside container! */, selfPathJS])} ` +
837
834
  `${shQ.quote(passthru)}`
838
835
  ]);
839
836
  }
@@ -842,9 +839,9 @@ const actionDefault = (opts, args) => {
842
839
  return execInherit(process.execPath, [
843
840
  selfPathJS,
844
841
  "internal", "capsula", "-C", container,
845
- process.execPath, selfPathJS,
842
+ "node" /* process.execPath is not valid inside container! */, selfPathJS,
846
843
  ...passthru
847
- ]);
844
+ ], { env: process.env });
848
845
  }
849
846
  }
850
847
  /* branch: plain claude -- execute Claude Code, optionally
@@ -909,24 +906,26 @@ const actionDefault = (opts, args) => {
909
906
  }
910
907
  /* override ASE configuration (for its diagram rendering) */
911
908
  if (opts.ase) {
912
- if (process.env.ASE_TERM_WIDTH === undefined) {
909
+ if (env.ASE_TERM_WIDTH === undefined) {
913
910
  let width = 0;
914
911
  if (process.stdout.isTTY) {
915
912
  const cols = process.stdout.columns;
916
913
  if (typeof cols === "number" && cols > 0)
917
914
  width = cols;
918
915
  }
919
- process.env.ASE_TERM_WIDTH = `${width}`;
916
+ env.ASE_TERM_WIDTH = `${width}`;
920
917
  }
921
- if (process.env.ASE_TERM_COLORS === undefined) {
918
+ if (env.ASE_TERM_COLORS === undefined) {
922
919
  let colorMode = "none";
923
920
  const depth = process.stdout.getColorDepth();
924
921
  if (depth >= 8)
925
922
  colorMode = "ansi256";
926
923
  else if (depth >= 4)
927
924
  colorMode = "ansi16";
928
- process.env.ASE_TERM_COLORS = `${colorMode}`;
925
+ env.ASE_TERM_COLORS = `${colorMode}`;
929
926
  }
927
+ if (args.includes("-p") || args.includes("--print"))
928
+ env.ASE_HEADLESS = "true";
930
929
  }
931
930
  /* determine Claude Code settings */
932
931
  let claudeSettings = {
package/claudex.ts CHANGED
@@ -290,34 +290,34 @@ const actionInstall = async (capsula: boolean): Promise<void> => {
290
290
  /* dispatch according to host/container mode */
291
291
  if (capsula) {
292
292
  info("update Debian GNU/Linux operating system")
293
- await self("internal", "capsula", "sudo", "-E", "apt", "update", "-qq")
294
- await self("internal", "capsula", "sudo", "-E", "apt", "upgrade", "-qq", "-y")
293
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "update", "-qq")
294
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "upgrade", "-qq", "-y")
295
295
 
296
296
  info("install Tmux / LazyGit / Git")
297
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "tmux", "lazygit", "git")
297
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "tmux", "lazygit", "git")
298
298
 
299
299
  info("install Node.js")
300
- await self("internal", "capsula", "sudo", "-E", "bash", "-c", "curl -fsSL https://deb.nodesource.com/setup_24.x | bash -")
301
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "nodejs")
302
- await self("internal", "capsula", "sudo", "-E", "apt", "install", "-qq", "-y", "binutils", "gcc", "g++", "make")
300
+ await self("internal", "capsula", "-s", "sudo", "-E", "bash", "-c", "curl -fsSL https://deb.nodesource.com/setup_24.x | bash -")
301
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "nodejs")
302
+ await self("internal", "capsula", "-s", "sudo", "-E", "apt", "install", "-qq", "-y", "binutils", "gcc", "g++", "make")
303
303
 
304
304
  info("install Claude Code")
305
305
  await self("internal", "capsula", "bash", "-c", `PATH="${HOME}/.local/bin:$PATH"; curl -kfsSL https://claude.ai/install.sh | bash`)
306
306
 
307
307
  info("install ANSI-Recolor")
308
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor")
308
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor")
309
309
 
310
310
  info("install TypeScript LS")
311
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server")
311
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server")
312
312
 
313
313
  info("install CodeBurn")
314
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn")
314
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn")
315
315
 
316
316
  info("install ASE")
317
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase")
317
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase")
318
318
 
319
319
  info("install Claude wrapper")
320
- await self("internal", "capsula", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude")
320
+ await self("internal", "capsula", "-s", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude")
321
321
 
322
322
  /* prune obsolete versions only after successful install */
323
323
  await self("internal", "capsula", "bash", "-c",
@@ -473,26 +473,26 @@ const actionUpdate = async (capsula: boolean): Promise<void> => {
473
473
  /* dispatch according to host/container mode */
474
474
  if (capsula) {
475
475
  info("update Debian GNU/Linux operating system")
476
- await self("internal", "capsula", "sudo", "apt", "update", "-qq")
477
- await self("internal", "capsula", "sudo", "apt", "upgrade", "-qq", "-y")
476
+ await self("internal", "capsula", "-s", "sudo", "apt", "update", "-qq")
477
+ await self("internal", "capsula", "-s", "sudo", "apt", "upgrade", "-qq", "-y")
478
478
 
479
479
  info("update Claude Code")
480
480
  await self("internal", "capsula", "bash", "-c", `PATH="${HOME}/.local/bin:$PATH"; ${HOME}/.local/bin/claude update`)
481
481
 
482
482
  info("update ANSI-Recolor")
483
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor")
483
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "ansi-recolor")
484
484
 
485
485
  info("update TypeScript LS")
486
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server")
486
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "typescript-language-server")
487
487
 
488
488
  info("update CodeBurn")
489
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn")
489
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "codeburn")
490
490
 
491
491
  info("update ASE")
492
- await self("internal", "capsula", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase")
492
+ await self("internal", "capsula", "-s", "sudo", "-E", "npm", "install", "-y", "-g", "@rse/ase")
493
493
 
494
494
  info("update Claude wrapper")
495
- await self("internal", "capsula", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude")
495
+ await self("internal", "capsula", "-s", "sudo", "install", "-c", "-m", "755", `${basedir}/claude`, "/usr/bin/claude")
496
496
  }
497
497
  else {
498
498
  info("update Tmux")
@@ -837,10 +837,6 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
837
837
 
838
838
  /* branch: tmux mode (with or without capsula) */
839
839
  if (opts.tmux) {
840
- /* sanity check environment */
841
- if (ENVIRONMENT === "capsula")
842
- fatal("cannot execute tmux mode from within Capsula environment")
843
-
844
840
  /* determine session name (from "-T <name>" option value, or auto-detected) */
845
841
  let session: string
846
842
  if (typeof opts.tmux === "string" && opts.tmux !== "")
@@ -876,7 +872,7 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
876
872
  `HOME=${shQ.quote([ HOME ])} ` +
877
873
  `CLAUDEX_FLAGS=${shQ.quote([ claudexFlags ])} ` +
878
874
  `sudo -E -u ${shQ.quote([ USER ])} ` +
879
- `${shQ.quote([ process.execPath, selfPathJS ])} ` +
875
+ `${shQ.quote([ "node" /* process.execPath is not valid inside container! */, selfPathJS ])} ` +
880
876
  `${opts.ase ? "-A " : ""}internal tmux new-session -A -s ${shQ.quote([ session ])}`
881
877
  ])
882
878
  }
@@ -886,7 +882,7 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
886
882
  selfPathJS, "internal", "capsula",
887
883
  "-e", `CLAUDEX_FLAGS=${claudexFlags}`,
888
884
  "-e", `CLAUDEX_INTERNAL_EXEC=${inPane}`,
889
- "-C", container, process.execPath, selfPathJS,
885
+ "-C", container, "node" /* process.execPath is not valid inside container! */, selfPathJS,
890
886
  ...(opts.ase ? [ "-A" ] : []), "internal", "tmux",
891
887
  "new-session", "-A", "-s", session, "-n", "claude",
892
888
  "claudex", "internal", "exec"
@@ -930,7 +926,7 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
930
926
  `TERM=${shQ.quote([ TERM ])} ` +
931
927
  `HOME=${shQ.quote([ HOME ])} ` +
932
928
  `sudo -E -u ${shQ.quote([ USER ])} ` +
933
- `${shQ.quote([ process.execPath, selfPathJS ])} ` +
929
+ `${shQ.quote([ "node" /* process.execPath is not valid inside container! */, selfPathJS ])} ` +
934
930
  `${shQ.quote(passthru)}`
935
931
  ])
936
932
  }
@@ -939,9 +935,9 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
939
935
  return execInherit(process.execPath, [
940
936
  selfPathJS,
941
937
  "internal", "capsula", "-C", container,
942
- process.execPath, selfPathJS,
938
+ "node" /* process.execPath is not valid inside container! */, selfPathJS,
943
939
  ...passthru
944
- ])
940
+ ], { env: process.env })
945
941
  }
946
942
  }
947
943
 
@@ -1007,24 +1003,26 @@ const actionDefault = (opts: TopOpts, args: string[]): never => {
1007
1003
 
1008
1004
  /* override ASE configuration (for its diagram rendering) */
1009
1005
  if (opts.ase) {
1010
- if (process.env.ASE_TERM_WIDTH === undefined) {
1006
+ if (env.ASE_TERM_WIDTH === undefined) {
1011
1007
  let width = 0
1012
1008
  if (process.stdout.isTTY) {
1013
1009
  const cols = process.stdout.columns
1014
1010
  if (typeof cols === "number" && cols > 0)
1015
1011
  width = cols
1016
1012
  }
1017
- process.env.ASE_TERM_WIDTH = `${width}`
1013
+ env.ASE_TERM_WIDTH = `${width}`
1018
1014
  }
1019
- if (process.env.ASE_TERM_COLORS === undefined) {
1015
+ if (env.ASE_TERM_COLORS === undefined) {
1020
1016
  let colorMode = "none"
1021
1017
  const depth = process.stdout.getColorDepth()
1022
1018
  if (depth >= 8)
1023
1019
  colorMode = "ansi256"
1024
1020
  else if (depth >= 4)
1025
1021
  colorMode = "ansi16"
1026
- process.env.ASE_TERM_COLORS = `${colorMode}`
1022
+ env.ASE_TERM_COLORS = `${colorMode}`
1027
1023
  }
1024
+ if (args.includes("-p") || args.includes("--print"))
1025
+ env.ASE_HEADLESS = "true"
1028
1026
  }
1029
1027
 
1030
1028
  /* determine Claude Code settings */
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@rse/claudex",
3
3
  "publishConfig": { "access": "public" },
4
- "version": "1.0.3",
4
+ "version": "1.0.5",
5
5
  "description": "Claude Code eXtended",
6
6
  "type": "module",
7
7
  "keywords": [ "claude", "code", "extension", "wrapper" ],