Skip to content

The remaining tool scripts and bash helpers are Python or gone #210

Open

Description

@ooloth

Current state

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

Decisions

Constraints

Open

Starting points

  • tools/bash/utils.bash: the helpers most scripts source
  • tools/claude/cc.bash: a tool script that is run directly
  • tools/homebrew/generate-brewfile.bash: another

Depends on

  • The sub-issue that sets up the repo-level Python project: the ported code needs the project to live in

Activity

  1. ooloth commented on Oct 26, 2026

    @ooloth
    OwnerAuthor

    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
  2. added
    maintenanceUpkeep that changes how the repo is built, not what it does
    on Oct 30, 2026
  3. ooloth commented on Oct 31, 2026

    @ooloth
    OwnerAuthor

    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.

  4. ooloth commented on Nov 1, 2026

    @ooloth
    OwnerAuthor

    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.

  5. ooloth commented on Nov 19, 2026

    @ooloth
    OwnerAuthor

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    maintenanceUpkeep that changes how the repo is built, not what it does

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions