You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
The remaining tool scripts and bash helpers are Python or gone #210
Once the categories above move, a few scripts and the helpers they shared are left in bash. tools/claude/cc.bash, tools/claude/notify.bash and tools/homebrew/generate-brewfile.bash are run directly, and utils.bash files in tools/bash, tools/homebrew, tools/macos, tools/neovim, tools/node, tools/rust, tools/tmux, tools/uv and tools/vscode are sourced by other scripts.
Ideal state
tools/claude/cc.bash, tools/claude/notify.bash and tools/homebrew/generate-brewfile.bash are Python, tested by tests that import them
No bash helper file remains that is still needed, apart from what setup's first step uses
tools/rex/saver.py, added for #199, is another script that is run directly: tools/rex/config/init.lua starts it with uv run --offline --script each time the Rex server loads its config. It is a single-file uv script for now, written in three marked sections (domain, boundary and I/O) so it can become modules. Moving it into the project means:
its three sections become modules, with an import contract that keeps the domain free of I/O
init.lua starts it from the project rather than as a script, still without reaching the network at boot, and tools/rex/update.bash prepares what that needs instead of filling uv's script cache
scripts/checks/types.bash drops --extra-search-path tools/rex, which exists only so ty can resolve the tests' import of the script
tools/rex/tests/test_saver.py imports the module instead of putting tools/rex on sys.path; tools/rex/tests/live_restore.py stays a script run by hand, since CI cannot run Rex
tools/bash/private-env.bash (58e521a4, #230) is a new bash helper that has to stay shell. tools/zsh/config/core.zsh sources it at startup to export the PRIVATE_* values, and tools/bash/utils.bash sources it for scripts started outside zsh. Once no bash script sources utils.bash, the zsh caller remains, so the ideal state's exception should name this helper as well as what setup's first step uses.
tools/rex/saver.py is gone, so it no longer needs moving into the Python project. Rex's own server now restores sessions after a restart, and decision 009 records why the saver was removed.
tools/claude/cc.bash now has a caller outside this repo: the work laptop's hub hub.toml names it by absolute path as [investigation] launcher (ooloth/hub#435). hub runs that path directly with its own arguments, and refuses to start when it isn't a file with an execute bit. A port has to leave a directly executable file at that path, or change that hub.toml in the same change.
Activity
ooloth commentedon Oct 26, 2026
tools/rex/saver.py, added for #199, is another script that is run directly:tools/rex/config/init.luastarts it withuv run --offline --scripteach time the Rex server loads its config. It is a single-file uv script for now, written in three marked sections (domain, boundary and I/O) so it can become modules. Moving it into the project means:init.luastarts it from the project rather than as a script, still without reaching the network at boot, andtools/rex/update.bashprepares what that needs instead of filling uv's script cachescripts/checks/types.bashdrops--extra-search-path tools/rex, which exists only so ty can resolve the tests' import of the scripttools/rex/tests/test_saver.pyimports the module instead of puttingtools/rexonsys.path;tools/rex/tests/live_restore.pystays a script run by hand, since CI cannot run Rexooloth commentedon Oct 31, 2026
tools/bash/private-env.bash(58e521a4, #230) is a new bash helper that has to stay shell.tools/zsh/config/core.zshsources it at startup to export thePRIVATE_*values, andtools/bash/utils.bashsources it for scripts started outside zsh. Once no bash script sourcesutils.bash, the zsh caller remains, so the ideal state's exception should name this helper as well as what setup's first step uses.rex: rely on Rex's own session restore and remove the saver
ooloth commentedon Nov 1, 2026
tools/rex/saver.pyis gone, so it no longer needs moving into the Python project. Rex's own server now restores sessions after a restart, and decision 009 records why the saver was removed.docs: record decision 009's issue updates as done
ooloth commentedon Nov 19, 2026
tools/claude/cc.bashnow has a caller outside this repo: the work laptop's hubhub.tomlnames it by absolute path as[investigation] launcher(ooloth/hub#435). hub runs that path directly with its own arguments, and refuses to start when it isn't a file with an execute bit. A port has to leave a directly executable file at that path, or change thathub.tomlin the same change.