@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/.claude/CLAUDE.md +1 -0
- package/AGENTS.md +69 -0
- package/CHANGELOG.md +160 -0
- package/LICENSE.txt +674 -0
- package/README.md +18 -33
- package/ansi-recolor.conf +3 -1
- package/claude +11 -13
- package/claude-settings.json +8 -0
- package/claudex +2 -1
- package/claudex.js +773 -569
- package/claudex.ts +829 -596
- package/eslint.mjs +1 -1
- package/lazygit.yaml +5 -0
- package/package.json +5 -3
- package/stx.conf +1 -1
- package/tmux.conf +11 -5
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
|
-

|
|
53
|
+

|
|
54
54
|
|
|
55
55
|
This is with LazyGit opened in a modal window:
|
|
56
56
|
|
|
57
|
-

|
|
57
|
+

|
|
58
58
|
|
|
59
59
|
This is with Bash opened in a modal window:
|
|
60
60
|
|
|
61
|
-

|
|
61
|
+

|
|
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 ©
|
|
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 © 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
package/claude
CHANGED
|
@@ -1,15 +1,13 @@
|
|
|
1
1
|
#!/bin/sh
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
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
|
+
|
package/claude-settings.json
CHANGED
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
|
|
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
|
|