@rse/claudex 0.9.13 → 0.9.15

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 CHANGED
@@ -7,15 +7,6 @@ environment for macOS and Linux. It mainly provides a thin `claudex` (claude eXt
7
7
  wrapper command which provides the following distinct features on top of the regular
8
8
  Claude Code command:
9
9
 
10
- - **Encapsulated Runtime**: It uses the companion tool
11
- [capsula](https://github.com/rse/capsula), also from RSE, for
12
- executing `claude` inside a cleverly established Docker container,
13
- which mimicks the host environment (filesystem layout, user/group
14
- name/id, etc) as close as possible.
15
-
16
- *Rationale*: Prevents any programs `claude` spawns from
17
- damaging more than the current working directory.
18
-
19
10
  - **Adjusted Theme**: It uses the companion tool [ansi-recolor](https://github.com/rse/ansi-recolor),
20
11
  also from RSE, to on-the-fly re-color Claude Code's terminal UI
21
12
  (configured to run in regular light theme) into the RSE brown/blue
@@ -34,6 +25,15 @@ Claude Code command:
34
25
  *Rationale*: Allow one to easily run multiple Claude Code sessions in
35
26
  parallel with full terminal interaction.
36
27
 
28
+ - **Encapsulated Runtime**: It optionally uses the companion tool
29
+ [capsula](https://github.com/rse/capsula), also from RSE, for
30
+ executing `claude` inside a cleverly established Docker container,
31
+ which mimicks the host environment (filesystem layout, user/group
32
+ name/id, etc) as close as possible.
33
+
34
+ *Rationale*: Prevents any programs `claude` spawns from
35
+ damaging more than the current working directory.
36
+
37
37
  - **Companion Tools**: It allows you to execute (visually in a modal window on top
38
38
  of Claude Code with the help of tmux popups) the companion tools
39
39
  [LazyGit](https://github.com/jesseduffield/lazygit) (for Git version
@@ -50,15 +50,15 @@ The following is a main view of the macOS Terminal with a **claudeX**
50
50
  session running. Three Claude Code instances are running in separate
51
51
  panes of the screen.
52
52
 
53
- ![screenshot](screenshot-1.png)
53
+ ![screenshot](doc/screenshot-1.png)
54
54
 
55
55
  This is with LazyGit opened in a modal window:
56
56
 
57
- ![screenshot](screenshot-2.png)
57
+ ![screenshot](doc/screenshot-2.png)
58
58
 
59
59
  This is with Bash opened in a modal window:
60
60
 
61
- ![screenshot](screenshot-3.png)
61
+ ![screenshot](doc/screenshot-3.png)
62
62
 
63
63
  Installation
64
64
  ------------
@@ -72,7 +72,10 @@ Usage
72
72
  -----
73
73
 
74
74
  ```sh
75
- $ claudex session
75
+ $ claudex -T # tmux session (formerly: claudex session)
76
+ $ claudex # plain claude (formerly: claudex naked)
77
+ $ claudex -R # claude wrapped with ansi-recolor
78
+ $ claudex -C -T # tmux session inside a Capsula sandbox
76
79
  ```
77
80
 
78
81
  See Also
@@ -83,24 +86,6 @@ See Also
83
86
  License
84
87
  -------
85
88
 
86
- Copyright © 2025-2026 Dr. Ralf S. Engelschall (http://engelschall.com/)
87
-
88
- Permission is hereby granted, free of charge, to any person obtaining
89
- a copy of this software and associated documentation files (the
90
- "Software"), to deal in the Software without restriction, including
91
- without limitation the rights to use, copy, modify, merge, publish,
92
- distribute, sublicense, and/or sell copies of the Software, and to
93
- permit persons to whom the Software is furnished to do so, subject to
94
- the following conditions:
95
-
96
- The above copyright notice and this permission notice shall be included
97
- in all copies or substantial portions of the Software.
98
-
99
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
100
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
101
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
102
- IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
103
- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
104
- TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
105
- SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
89
+ Copyright &copy; 2026 [Dr. Ralf S. Engelschall](https://engelschall.com)<br/>
90
+ Licensed under [GPL 3.0](https://spdx.org/licenses/GPL-3.0-only)
106
91
 
package/ansi-recolor.conf CHANGED
@@ -1,5 +1,7 @@
1
1
  ##
2
- ## ansi-recolor.conf
2
+ ## claudeX -- Claude Code eXtended
3
+ ## Copyright (c) 2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
4
+ ## Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
3
5
  ##
4
6
 
5
7
  # ==== simplified RSE color theme ====
package/claude CHANGED
@@ -1,15 +1,13 @@
1
1
  #!/bin/sh
2
- if [ ".$CLAUDEX" != . ]; then
3
- PATH="$CLAUDEX:$PATH"
4
- fi
5
- sandbox=""
6
- if [ $# -ge 1 ] && [ ".$1" = ".-s" ]; then
7
- shift
8
- sandbox="-s"
9
- fi
10
- if [ ".$1" = .session ]; then
11
- shift
12
- exec claudex $sandbox session ${1+"$@"}
13
- else
14
- exec claudex $sandbox naked ${1+"$@"}
2
+ ##
3
+ ## claudeX -- Claude Code eXtended
4
+ ## Copyright (c) 2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
5
+ ## Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
6
+ ##
7
+
8
+ if [ ".$CLAUDEX_BASEDIR" != . ]; then
9
+ PATH="$CLAUDEX_BASEDIR:$PATH"
15
10
  fi
11
+
12
+ exec claudex ${1+"$@"}
13
+
@@ -15,5 +15,13 @@
15
15
  "teammateMode": "tmux",
16
16
  "preferences": {
17
17
  "tmuxSplitPanes": true
18
+ },
19
+ "spinnerTipsEnabled": false,
20
+ "spinnerVerbs": {
21
+ "mode": "replace",
22
+ "verbs": [
23
+ "Working",
24
+ "Working (Just be patient)"
25
+ ]
18
26
  }
19
27
  }
package/claudex CHANGED
@@ -2,7 +2,7 @@
2
2
  ##
3
3
  ## claudeX -- Claude Code eXtended
4
4
  ## Copyright (c) 2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
5
- ## Licensed under MIT <https://spdx.org/licenses/MIT>
5
+ ## Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
6
6
  ##
7
7
  ## Thin POSIX-sh launcher: resolve our own path (handling symlinks),
8
8
  ## then exec the compiled Node.js program (claudex.js) next to it.
@@ -19,5 +19,6 @@ while [ -L "$self" ]; do
19
19
  done
20
20
  basedir=$(cd "$(dirname "$self")" && pwd)
21
21
 
22
+ # pass-through execution
22
23
  exec node "$basedir/claudex.js" "$@"
23
24