devstuff 2.22.0__tar.gz → 2.24.0__tar.gz

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.
Files changed (268) hide show
  1. {devstuff-2.22.0 → devstuff-2.24.0}/.claude/skills/run-stuff/smoke.sh +1 -1
  2. {devstuff-2.22.0 → devstuff-2.24.0}/.github/workflows/test-installs.yml +8 -0
  3. {devstuff-2.22.0 → devstuff-2.24.0}/AGENTS.md +4 -2
  4. {devstuff-2.22.0 → devstuff-2.24.0}/CHANGELOG.md +12 -0
  5. {devstuff-2.22.0 → devstuff-2.24.0}/PKG-INFO +9 -1
  6. {devstuff-2.22.0 → devstuff-2.24.0}/README.md +8 -0
  7. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/README.md +1 -0
  8. devstuff-2.24.0/docs/specs/fmhy-picks/development-plan.md +58 -0
  9. devstuff-2.24.0/docs/specs/fmhy-picks/specifications.md +93 -0
  10. devstuff-2.24.0/docs/specs/fmhy-picks/stack-decisions.md +74 -0
  11. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/lazygit-config/development-plan.md +3 -2
  12. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/lazygit-config/specifications.md +4 -2
  13. {devstuff-2.22.0 → devstuff-2.24.0}/pyproject.toml +1 -1
  14. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/wizard.py +42 -3
  15. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/links.yaml +54 -0
  16. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/tools.yaml +153 -0
  17. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_tools.py +3 -0
  18. devstuff-2.24.0/tests/test_catalog_scripts.py +308 -0
  19. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_lazygit.py +125 -0
  20. {devstuff-2.22.0 → devstuff-2.24.0}/uv.lock +1 -1
  21. {devstuff-2.22.0 → devstuff-2.24.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  22. {devstuff-2.22.0 → devstuff-2.24.0}/.github/codex/review.md +0 -0
  23. {devstuff-2.22.0 → devstuff-2.24.0}/.github/workflows/agent.yml +0 -0
  24. {devstuff-2.22.0 → devstuff-2.24.0}/.github/workflows/bump.yml +0 -0
  25. {devstuff-2.22.0 → devstuff-2.24.0}/.github/workflows/ci.yml +0 -0
  26. {devstuff-2.22.0 → devstuff-2.24.0}/.github/workflows/publish.yml +0 -0
  27. {devstuff-2.22.0 → devstuff-2.24.0}/.gitignore +0 -0
  28. {devstuff-2.22.0 → devstuff-2.24.0}/CLAUDE.md +0 -0
  29. {devstuff-2.22.0 → devstuff-2.24.0}/dev/Dockerfile +0 -0
  30. {devstuff-2.22.0 → devstuff-2.24.0}/dev/Dockerfile.ci +0 -0
  31. {devstuff-2.22.0 → devstuff-2.24.0}/dev/Makefile +0 -0
  32. {devstuff-2.22.0 → devstuff-2.24.0}/dev/docker-compose.yml +0 -0
  33. {devstuff-2.22.0 → devstuff-2.24.0}/devstuff +0 -0
  34. {devstuff-2.22.0 → devstuff-2.24.0}/docs/ROADMAP.md +0 -0
  35. {devstuff-2.22.0 → devstuff-2.24.0}/docs/github-agent.md +0 -0
  36. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/agent/development-plan.md +0 -0
  37. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/agent/specifications.md +0 -0
  38. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/agent/stack-decisions.md +0 -0
  39. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/ansible-config/development-plan.md +0 -0
  40. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/ansible-config/specifications.md +0 -0
  41. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  42. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/bat-config/development-plan.md +0 -0
  43. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/bat-config/specifications.md +0 -0
  44. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  45. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  46. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/commitizen-config/specifications.md +0 -0
  47. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  48. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/docker-config/development-plan.md +0 -0
  49. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/docker-config/specifications.md +0 -0
  50. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  51. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  52. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/mcp/development-plan.md +0 -0
  53. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/mcp/specifications.md +0 -0
  54. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/mcp/stack-decisions.md +0 -0
  55. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/outdated/development-plan.md +0 -0
  56. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/outdated/specifications.md +0 -0
  57. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/outdated/stack-decisions.md +0 -0
  58. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/plan-and-progress/specifications.md +0 -0
  59. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/precommit-config/development-plan.md +0 -0
  60. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/precommit-config/specifications.md +0 -0
  61. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  62. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile/development-plan.md +0 -0
  63. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile/specifications.md +0 -0
  64. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile/stack-decisions.md +0 -0
  65. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile-apply/development-plan.md +0 -0
  66. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile-apply/specifications.md +0 -0
  67. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
  68. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/starship-config/development-plan.md +0 -0
  69. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/starship-config/specifications.md +0 -0
  70. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  71. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/syncthing-config/development-plan.md +0 -0
  72. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/syncthing-config/specifications.md +0 -0
  73. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/syncthing-config/stack-decisions.md +0 -0
  74. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  75. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/uv-backbone/specifications.md +0 -0
  76. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  77. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  78. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/verbose-mode/specifications.md +0 -0
  79. {devstuff-2.22.0 → devstuff-2.24.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  80. {devstuff-2.22.0 → devstuff-2.24.0}/install.sh +0 -0
  81. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/__init__.py +0 -0
  82. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/__main__.py +0 -0
  83. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/__init__.py +0 -0
  84. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/approval.py +0 -0
  85. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/bridges.py +0 -0
  86. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/catalog.py +0 -0
  87. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/completion.py +0 -0
  88. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/config.py +0 -0
  89. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/loop.py +0 -0
  90. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/ollama.py +0 -0
  91. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/preflight.py +0 -0
  92. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/primitives.py +0 -0
  93. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/registry.py +0 -0
  94. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/sandbox.py +0 -0
  95. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/session.py +0 -0
  96. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/transcript.py +0 -0
  97. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent/wizard.py +0 -0
  98. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent_tools.schema.json +0 -0
  99. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/agent_tools.yaml +0 -0
  100. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/apply_exec.py +0 -0
  101. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/apply_plan.py +0 -0
  102. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/base.py +0 -0
  103. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
  104. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
  105. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/devops.yaml +0 -0
  106. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/essentials.yaml +0 -0
  107. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/languages.yaml +0 -0
  108. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles/python.yaml +0 -0
  109. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/bundles.py +0 -0
  110. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/catalog.py +0 -0
  111. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/cli.py +0 -0
  112. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/__init__.py +0 -0
  113. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/_plan.py +0 -0
  114. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/add_cmd.py +0 -0
  115. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  116. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  117. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/configure_cmd.py +0 -0
  118. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  119. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/docs_cmd.py +0 -0
  120. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
  121. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/functions_cmd.py +0 -0
  122. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/help_cmd.py +0 -0
  123. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/install_cmd.py +0 -0
  124. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/links_cmd.py +0 -0
  125. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/list_cmd.py +0 -0
  126. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
  127. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
  128. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/profile_cmd.py +0 -0
  129. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  130. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/run_cmd.py +0 -0
  131. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  132. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/commands/update_cmd.py +0 -0
  133. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/__init__.py +0 -0
  134. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  135. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  136. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/model.py +0 -0
  137. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/render.py +0 -0
  138. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  139. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  140. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  141. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/detect.py +0 -0
  142. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/model.py +0 -0
  143. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/preview.py +0 -0
  144. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/render.py +0 -0
  145. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  146. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  147. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  148. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  149. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  150. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  151. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  152. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  153. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/detect.py +0 -0
  154. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/model.py +0 -0
  155. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/render.py +0 -0
  156. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/validate.py +0 -0
  157. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  158. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  159. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  160. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  161. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  162. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  163. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  164. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  165. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/model.py +0 -0
  166. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/render.py +0 -0
  167. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  168. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  169. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  170. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  171. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  172. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  173. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/icons.py +0 -0
  174. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/model.py +0 -0
  175. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/preview.py +0 -0
  176. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/render.py +0 -0
  177. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  178. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/__init__.py +0 -0
  179. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/api.py +0 -0
  180. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/detect.py +0 -0
  181. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/model.py +0 -0
  182. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/wizard.py +0 -0
  183. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/doctor.py +0 -0
  184. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/function_runner.py +0 -0
  185. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/functions.schema.json +0 -0
  186. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/functions.yaml +0 -0
  187. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/functions_catalog.py +0 -0
  188. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/functions_registry.py +0 -0
  189. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/generic.py +0 -0
  190. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/links.schema.json +0 -0
  191. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/links_catalog.py +0 -0
  192. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/links_registry.py +0 -0
  193. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/__init__.py +0 -0
  194. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/core.py +0 -0
  195. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/http.py +0 -0
  196. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/openapi.py +0 -0
  197. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/printconfig.py +0 -0
  198. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/process.py +0 -0
  199. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/stdio.py +0 -0
  200. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/mcp/token.py +0 -0
  201. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/profile.py +0 -0
  202. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/registry.py +0 -0
  203. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/snapshot.py +0 -0
  204. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/ui.py +0 -0
  205. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/updates.py +0 -0
  206. {devstuff-2.22.0 → devstuff-2.24.0}/src/dev_setup/verbose.py +0 -0
  207. {devstuff-2.22.0 → devstuff-2.24.0}/tests/__init__.py +0 -0
  208. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/__init__.py +0 -0
  209. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/conftest.py +0 -0
  210. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_agent_smoke.py +0 -0
  211. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_agent_tui.py +0 -0
  212. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_commitizen_config.py +0 -0
  213. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_mcp_claude.py +0 -0
  214. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_mcp_conformance.py +0 -0
  215. {devstuff-2.22.0 → devstuff-2.24.0}/tests/integration/test_profile_apply.py +0 -0
  216. {devstuff-2.22.0 → devstuff-2.24.0}/tests/mcp_http_support.py +0 -0
  217. {devstuff-2.22.0 → devstuff-2.24.0}/tests/mcp_process_support.py +0 -0
  218. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent.py +0 -0
  219. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_bridges.py +0 -0
  220. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_completion.py +0 -0
  221. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_loop.py +0 -0
  222. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_sandbox.py +0 -0
  223. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_tools.py +0 -0
  224. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_agent_wizard.py +0 -0
  225. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_apply_exec.py +0 -0
  226. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_apply_plan.py +0 -0
  227. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_apply_run.py +0 -0
  228. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_bundles.py +0 -0
  229. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_catalog.py +0 -0
  230. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_ansible.py +0 -0
  231. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_bat.py +0 -0
  232. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_commitizen.py +0 -0
  233. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_docker.py +0 -0
  234. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_precommit.py +0 -0
  235. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_reptyr.py +0 -0
  236. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_starship.py +0 -0
  237. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_configure_syncthing.py +0 -0
  238. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_doctor.py +0 -0
  239. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_functions.py +0 -0
  240. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_generic.py +0 -0
  241. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_installed_version.py +0 -0
  242. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_lifecycle_cmds.py +0 -0
  243. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_links.py +0 -0
  244. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_classify.py +0 -0
  245. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_core.py +0 -0
  246. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_http.py +0 -0
  247. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_http_cmd.py +0 -0
  248. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_openapi.py +0 -0
  249. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_printconfig.py +0 -0
  250. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_process.py +0 -0
  251. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_stdio.py +0 -0
  252. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_mcp_token.py +0 -0
  253. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_outdated_cmd.py +0 -0
  254. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_pin_support.py +0 -0
  255. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_plan_and_select.py +0 -0
  256. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_profile.py +0 -0
  257. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_profile_apply_cmd.py +0 -0
  258. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_profile_diff.py +0 -0
  259. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_profile_diff_cmd.py +0 -0
  260. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_profile_snapshot_cmd.py +0 -0
  261. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_registry.py +0 -0
  262. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_snapshot.py +0 -0
  263. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_ui.py +0 -0
  264. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_update_checker_parity.py +0 -0
  265. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_update_notes.py +0 -0
  266. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_updates.py +0 -0
  267. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_uv_probes.py +0 -0
  268. {devstuff-2.22.0 → devstuff-2.24.0}/tests/test_verbose.py +0 -0
@@ -35,7 +35,7 @@ echo "=== devstuff smoke tests ==="
35
35
  echo ""
36
36
 
37
37
  check "version" uv run devstuff version
38
- check_output "version number" "1\." uv run devstuff version
38
+ check_output "version number" "devstuff [0-9]" uv run devstuff version
39
39
  check "list (all)" uv run devstuff list
40
40
  check "list core" uv run devstuff list core
41
41
  check "list tools" uv run devstuff list tools
@@ -56,14 +56,18 @@ jobs:
56
56
  - arcane-cli # release binary into /usr/local/bin
57
57
  - aws
58
58
  - bat
59
+ - bubblewrap # apt: bubblewrap + socat for Claude Code /sandbox
59
60
  - claude-code # npm tool, installs nvm first via `requires`
60
61
  - codex # npm tool, installs nvm first via `requires`
61
62
  - commitizen # uvx tool, requires uv
63
+ - delta # apt: git-delta
62
64
  - devin # curl|bash installer, ~/.local/bin
65
+ - fzf # apt + ~/.bashrc key bindings
63
66
  - gh
64
67
  - ghgrab # uvx tool, requires uv
65
68
  - git-lfs
66
69
  - go
70
+ - gum # Charm apt repo
67
71
  - hey-dave # uvx tool, requires uv + a managed Python 3.14
68
72
  - homebrew # slow: builds from source
69
73
  - htop
@@ -76,15 +80,19 @@ jobs:
76
80
  - mkcert
77
81
  - nerd-font
78
82
  - nvm
83
+ - opencode # npm: opencode-ai, requires nvm
79
84
  - php
80
85
  - pi # installs nvm first via its declared `requires`
81
86
  - pre-commit # uvx tool, requires uv
82
87
  - python # uv-managed CPython, requires uv
83
88
  - ruby # compiles from source — this job takes ~15 minutes
84
89
  - reptyr
90
+ - ripgrep
85
91
  - saml2aws
92
+ - shellcheck
86
93
  - starship
87
94
  - syncthing # official apt repo (v2); no systemd user session in CI
95
+ - tmux
88
96
  - uv
89
97
  - yq
90
98
 
@@ -62,13 +62,13 @@ When you open or update a PR, say in its body what was **run** and what was **no
62
62
  exists but has not had its first real run, or that needs a sudo or Docker the author's machine
63
63
  didn't have, is stated as exactly that: not as passing.
64
64
 
65
- ## Open PRs (snapshot, 2026-10-12)
65
+ ## Open PRs (snapshot, 2026-10-13)
66
66
 
67
67
  Refresh with the `gh pr list` command above when this looks stale.
68
68
 
69
69
  | PR | Branch | Base | Notes |
70
70
  |---|---|---|---|
71
- | [#75](https://github.com/thesawdawg/dev-setup-py/pull/75) `syncthing` tool + `configure syncthing` pairing wizard | `feat/syncthing` | `master` | Opened 2026-10-12. Not yet run: a real `devstuff install syncthing` (the CI canary is its first run) and the wizard against a live user service. |
71
+ | [#77](https://github.com/thesawdawg/dev-setup-py/pull/77) `delta`, `ripgrep`, `shellcheck`, `fzf`, `opencode` tools; lazygit wizard's delta install offer; five FMHY links | `feat/fmhy-picks` | `master` | Opened 2026-10-13. Also carries the AGENTS.md #76 follow-up commit. Not yet run: a real install of any of the five (no Docker on the dev host), so the CI canary is their first run; the lazygit wizard under a pty. |
72
72
 
73
73
  ### Closed as dropped
74
74
 
@@ -89,3 +89,5 @@ commits rather than merging `master` in.
89
89
  |---|---|
90
90
  | [#60](https://github.com/thesawdawg/dev-setup-py/pull/60) `profile apply`, bundles, docs (merged 2026-10-11, released as 2.13.0) | The first run of `make run-apply-tests` (in `dev/`) in the CI image. The test is written, and its `uv` + pinned-`commitizen` half was run against the real installers in an isolated `HOME`; the `yq` half and the container run have not happened. Tick the last box under M3 in `docs/ROADMAP.md` when it passes. |
91
91
  | [#62](https://github.com/thesawdawg/dev-setup-py/pull/62) plan preview, live progress view and the guided `add` wizard (merged 2026-10-11, released as 2.14.0) | (1) About ten older sites still put error text into `ui.error`/`ui.dim` unescaped, which raises `MarkupError` on a `[/…]`-shaped string: `configure_cmd`, `doctor_cmd`, `run_cmd`, `skills_cmd`, the commitizen and reptyr wizards, `add_cmd`. Escape with `rich.markup.escape` when touching one (see `docs/specs/plan-and-progress/`, F-1). (2) Not run live: `update` and its picker, the `install`/`remove` pickers, and the `npm`, `apt` and `git` installers under the progress view; unit-tested only. (3) Open design points, deliberately unchanged: a missing requirement asks three questions, and the `add` step counter reads `1/7` then `2/8`. |
92
+ | [#75](https://github.com/thesawdawg/dev-setup-py/pull/75) `syncthing` tool and `configure syncthing` pairing wizard (merged 2026-10-12, released as 2.22.0) | (1) The first real `devstuff install syncthing`: the weekly `test-installs.yml` canary is its first run, where the no-user-session branch is the expected path. (2) The interactive wizard against a live user service, and `sudo loginctl enable-linger` itself. Both are unit-tested only, with a fake API client; the real-binary tests drive two throwaway daemons, not the wizard. When either happens, update "What was run and what was not" in `docs/specs/syncthing-config/development-plan.md` and the status row in `docs/specs/README.md`. |
93
+ | [#76](https://github.com/thesawdawg/dev-setup-py/pull/76) `tmux`, `gum`, `bubblewrap` (+ `socat`) tools; Druid, Homepage, Server Box and tmux wiki links (merged 2026-10-13, released as 2.23.0) | The first real install of `tmux`, `gum` and `bubblewrap`: the dev host has no Docker, so the weekly `test-installs.yml` canary is their first run. The bubblewrap remove refusal and both-binaries check are tested with fake `apt-get`/`sudo` only. |
@@ -1,3 +1,15 @@
1
+ ## v2.24.0 (2026-10-13)
2
+
3
+ ### Features
4
+
5
+ - **tools**: add delta, ripgrep, ShellCheck, fzf and OpenCode; add five FMHY links
6
+
7
+ ## v2.23.0 (2026-10-13)
8
+
9
+ ### Features
10
+
11
+ - **tools**: add tmux, gum and bubblewrap; add Druid, Homepage, Server Box and tmux wiki links
12
+
1
13
  ## v2.22.0 (2026-10-12)
2
14
 
3
15
  ### Features
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: devstuff
3
- Version: 2.22.0
3
+ Version: 2.24.0
4
4
  Summary: Development environment setup CLI for Linux
5
5
  Project-URL: Repository, https://github.com/thesawdawg/dev-setup-py
6
6
  Author-email: Sawyer <sawyerksu@gmail.com>
@@ -1646,15 +1646,20 @@ links:
1646
1646
 
1647
1647
  | `arcane-cli` | Arcane CLI | Command-line client for an Arcane Docker management server (needs a running server) | `arcane-cli --help` |
1648
1648
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1649
+ | `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
1649
1650
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1651
+ | `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
1652
+ | `fzf` | fzf | Command-line fuzzy finder — installs the apt package and adds Ctrl-R/Ctrl-T/Alt-C key bindings to `~/.bashrc` | `fzf --help` |
1650
1653
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
1651
1654
  | `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
1652
1655
  | `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
1656
+ | `gum` | gum | Prompts, pickers, spinners and styled output for shell scripts (Charm) | `gum --help` |
1653
1657
  | `htop` | htop | Interactive process and resource monitor | `man htop` |
1654
1658
  | `homebrew` | Homebrew | Package manager for Linux (and macOS) | `brew --help` |
1655
1659
  | `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
1656
1660
  | `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
1657
1661
  | `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
1662
+ | `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
1658
1663
  | `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
1659
1664
  | `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
1660
1665
  | `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
@@ -1667,10 +1672,13 @@ links:
1667
1672
  | `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
1668
1673
  | `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
1669
1674
  | `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
1675
+ | `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
1670
1676
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1671
1677
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1678
+ | `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
1672
1679
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1673
1680
  | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1681
+ | `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
1674
1682
  | `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
1675
1683
 
1676
1684
  ### Languages
@@ -1619,15 +1619,20 @@ links:
1619
1619
 
1620
1620
  | `arcane-cli` | Arcane CLI | Command-line client for an Arcane Docker management server (needs a running server) | `arcane-cli --help` |
1621
1621
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1622
+ | `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
1622
1623
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1624
+ | `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
1625
+ | `fzf` | fzf | Command-line fuzzy finder — installs the apt package and adds Ctrl-R/Ctrl-T/Alt-C key bindings to `~/.bashrc` | `fzf --help` |
1623
1626
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
1624
1627
  | `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
1625
1628
  | `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
1629
+ | `gum` | gum | Prompts, pickers, spinners and styled output for shell scripts (Charm) | `gum --help` |
1626
1630
  | `htop` | htop | Interactive process and resource monitor | `man htop` |
1627
1631
  | `homebrew` | Homebrew | Package manager for Linux (and macOS) | `brew --help` |
1628
1632
  | `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
1629
1633
  | `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
1630
1634
  | `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
1635
+ | `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
1631
1636
  | `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
1632
1637
  | `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
1633
1638
  | `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
@@ -1640,10 +1645,13 @@ links:
1640
1645
  | `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
1641
1646
  | `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
1642
1647
  | `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
1648
+ | `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
1643
1649
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1644
1650
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1651
+ | `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
1645
1652
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1646
1653
  | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1654
+ | `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
1647
1655
  | `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
1648
1656
 
1649
1657
  ### Languages
@@ -47,6 +47,7 @@ They are most useful when they capture:
47
47
  | [`ansible-config/`](ansible-config/) — `devstuff configure ansible`, the ansible.cfg wizard | Complete (v1) |
48
48
  | [`lazygit-config/`](lazygit-config/) — `devstuff configure lazygit`, the icons/pager/panels wizard | Complete (v1) |
49
49
  | [`syncthing-config/`](syncthing-config/) — the `syncthing` tool plus `devstuff configure syncthing`, device pairing over the local API | Complete (v1; first real install and live wizard run pending) |
50
+ | [`fmhy-picks/`](fmhy-picks/) — five tools (delta, ripgrep, ShellCheck, fzf, OpenCode) and five links chosen from the FMHY wiki, plus the lazygit wizard's delta install offer | Implemented 2026-10-13 (first real installs pending: the CI canary is their first run) |
50
51
  | [`verbose-mode/`](verbose-mode/) — `-v`/`-vv`, the process-wide verbosity level | Complete (v1) |
51
52
  | [`outdated/`](outdated/) — `devstuff outdated`, the read-only installed-vs-latest report | Complete (v1) |
52
53
  | [`profile/`](profile/) — `devstuff profile snapshot` / `diff`, a portable description of a machine's tools | Complete (v1: snapshot, diff; apply is its own spec) |
@@ -0,0 +1,58 @@
1
+ # FMHY picks — development plan
2
+
3
+ One branch (`feat/fmhy-picks`) and one PR, like #76.
4
+
5
+ ## Milestones
6
+
7
+ - **M-1 Selection documented.** This directory. *Done 2026-10-13.*
8
+ - **M-2 Catalog.** The five tools (FR-1…FR-5) and five links (FR-10), CI matrix entries and README
9
+ rows (FR-6). *Done 2026-10-13.*
10
+ - **M-3 fzf script tests.** Run the shipped fzf install/remove scripts in bash against a temporary
11
+ `HOME` with fake `sudo`/`apt-get`/`fzf`, in `tests/test_catalog_scripts.py` (FR-4a…FR-4c).
12
+ *Done 2026-10-13.*
13
+ - **M-4 lazygit offer.** The delta install offer in `configure/lazygit/wizard.py` (FR-7…FR-9),
14
+ with tests, and an update to `docs/specs/lazygit-config/`. *Done 2026-10-13.*
15
+
16
+ ## Testing
17
+
18
+ - Unit: `uv run pytest`, including the catalog/matrix coverage tests that already require a matrix
19
+ entry for every built-in.
20
+ - fzf block: source the written `~/.bashrc` in a fresh `bash -i`-like run for each case — `fzf
21
+ --bash` works; `fzf --bash` fails and the fallback file exists; neither; fzf absent — and
22
+ assert a zero exit and empty stderr. Each test must fail against a deliberately broken block.
23
+ - lazygit: drive `_ask_pager` with stubbed `ui`, `shutil.which` and `install_by_key`: offer made
24
+ and accepted, declined, install failed, non-delta pager missing (no offer), delta present (no
25
+ offer).
26
+
27
+ ## What was run and what was not
28
+
29
+ Run on the dev host, 2026-10-13:
30
+
31
+ - `uv run pytest tests/test_catalog_scripts.py tests/test_configure_lazygit.py
32
+ tests/test_catalog.py tests/test_links.py -q` — 125 passed, 12 skipped, including
33
+ `test_ci_matrix_covers_every_builtin_tool` (both directions).
34
+ - Full `uv run pytest -q` — 2371 passed, 52 skipped (12 are the lazygit live tests, skipped
35
+ because lazygit is not on this host).
36
+ - `uv run ruff check .` — clean.
37
+ - `bash .claude/skills/run-stuff/smoke.sh` — all 11 checks (after fixing its stale
38
+ `1\.` version expectation; the project is at 2.x).
39
+ - `devstuff list` shows all five tools as not installed.
40
+ - Teeth checks: the fzf block tests were shown to fail against a naive `eval "$(fzf --bash)"`
41
+ block (stderr leaks in the three non-happy cases); the fzf `check_cmd` marker test was shown
42
+ to fail against the old `check_cmd: fzf` (a binary alone returns 0); and the lazygit gate
43
+ tests 1, 4 and 7 were shown to fail against a stubbed-out `_DeltaGate.check`. All restored.
44
+
45
+ Not run:
46
+
47
+ - No real install of the five tools on the dev host (none is installed and the host has no
48
+ Docker, and no sudo/apt/npm installs were run), so the weekly `test-installs.yml` canary is
49
+ their first real run. For fzf, that test's `is_installed()` covers the binary and the
50
+ `~/.bashrc` marker (FR-4d), but not that the key bindings actually load: the CI image's fzf
51
+ 0.44 has no `--bash` and the minimized image likely has no fallback file (D-3).
52
+ - The interactive lazygit wizard under a pty; the gate was exercised with stubbed prompts.
53
+
54
+ ## Risks
55
+
56
+ - `opencode-ai`'s `postinstall` downloads a platform binary; a network or registry change there
57
+ fails the install even though `npm install` itself works. The CI canary catches it.
58
+ - fzf's fallback path is not exercised by the CI container (D-3).
@@ -0,0 +1,93 @@
1
+ # FMHY picks — specifications
2
+
3
+ Five tools and five links chosen from a scan of the FMHY wiki's docs
4
+ (<https://github.com/fmhy/edit/tree/main/docs>), mainly `developer-tools.md`, `linux-macos.md`,
5
+ `system-tools.md`, `file-tools.md` and `text-tools.md`. Selected 2026-10-13; the owner approved the
6
+ list and answered the design questions recorded in [`stack-decisions.md`](stack-decisions.md).
7
+
8
+ ## Selection criteria
9
+
10
+ A candidate was ranked on:
11
+
12
+ 1. **Fit.** A Linux command-line tool that one of the existing install types can install, and that
13
+ the CI install container (`ubuntu:24.04`) can test. Desktop-only and server-stack software is a
14
+ link, not a tool.
15
+ 2. **Connection to the catalog.** It completes something devstuff already ships (a wizard, a tool
16
+ group), rather than standing alone.
17
+ 3. **Prominence.** FMHY stars it, or lists it in more than one place.
18
+ 4. **Not already present.** Anything in `tools.yaml` or `links.yaml` was excluded (lazygit, bat,
19
+ htop, starship, tmux, gum, gh, ghgrab, syncthing, Homepage, Server Box, Devhints, Linux Command
20
+ Library, crontab.guru and so on).
21
+
22
+ ## Selected tools
23
+
24
+ | Key | Tool | FMHY section | Why |
25
+ |---|---|---|---|
26
+ | `delta` | delta | Git Tools | The lazygit wizard's recommended "With delta" preset writes `delta --dark --paging=never` but cannot install delta. |
27
+ | `ripgrep` | ripgrep | CLI Tools | The standard fast code search. |
28
+ | `shellcheck` | ShellCheck | Terminal / Shell | Lints shell scripts; this project ships a lot of bash in YAML. The pre-commit wizard's shellcheck hook runs in Docker and gives no local binary. |
29
+ | `fzf` | fzf | Fuzzy finders | The usual fuzzy finder, behind shell history search and many other tools. |
30
+ | `opencode` | OpenCode | AI coding harnesses (starred) | The main open-source coding agent missing from `ai-tools` (claude-code, codex, pi, devin). |
31
+
32
+ Runners-up, not selected: lazydocker (no apt package), btop (overlaps htop), zoxide, glow, lnav, gdu.
33
+
34
+ ## Selected links
35
+
36
+ | Key | Link | Category | FMHY section |
37
+ |---|---|---|---|
38
+ | `devdocs` | DevDocs — <https://devdocs.io/> | `reference` | Developer Tools (starred) |
39
+ | `archwiki` | ArchWiki — <https://wiki.archlinux.org/> | `reference` | Linux Guides (starred) |
40
+ | `explainshell` | explainshell — <https://explainshell.com/> | `shell` | Terminal / Shell |
41
+ | `awesome-selfhosted` | Awesome Selfhosted — <https://awesome-selfhosted.net/> | `discovery` | Server / Selfhosting (starred) |
42
+ | `deps-dev` | deps.dev — <https://deps.dev/> | `security` | Developer Tools |
43
+
44
+ Runners-up, not selected: Free for Developers, Can I Use, Compiler Explorer, TerminalTrove, grep.app.
45
+
46
+ ## Requirements
47
+
48
+ ### Tools
49
+
50
+ - **FR-1** `delta`: `type: apt`, `apt_packages: git-delta`, `check_cmd: delta`. The package and the
51
+ command have different names; the check names the command.
52
+ - **FR-2** `ripgrep`: `type: apt`, `apt_packages: ripgrep`, `check_cmd: rg`.
53
+ - **FR-3** `shellcheck`: `type: apt`, `apt_packages: shellcheck`, `check_cmd: shellcheck`.
54
+ - **FR-4** `fzf`: `type: bash`. The install script installs the `fzf` apt package and appends a
55
+ marked block to `~/.bashrc` that turns on fzf's key bindings (Ctrl-R, Ctrl-T, Alt-C). The remove
56
+ script removes the package and strips exactly that block.
57
+ - **FR-4a** The block must work on fzf 0.44 (Ubuntu 24.04, no `fzf --bash`) and on fzf ≥ 0.48:
58
+ use `fzf --bash` when it succeeds, otherwise source
59
+ `/usr/share/doc/fzf/examples/key-bindings.bash` if it is readable, otherwise do nothing.
60
+ - **FR-4b** The block must never make a shell's startup fail or print an error, including when
61
+ fzf has since been uninstalled by other means.
62
+ - **FR-4c** Re-running install must not add a second block.
63
+ - **FR-4d** fzf counts as installed only when the `fzf` command exists and `~/.bashrc`
64
+ carries the marker line, so an fzf installed earlier by other means still gets the
65
+ block on `devstuff install fzf`.
66
+ - **FR-5** `opencode`: `type: npm`, `npm_name: opencode-ai`, `check_cmd: opencode`, requires `nvm`
67
+ (the npm type's default).
68
+ - **FR-6** Every new tool has a CI install-matrix entry in `.github/workflows/test-installs.yml`
69
+ and a row in the README's tool table.
70
+
71
+ ### lazygit wizard
72
+
73
+ - **FR-7** When the user picks a delta pager and `delta` is not on `PATH`, the wizard offers to
74
+ install the `delta` catalog tool through `install_by_key`, the same way the starship wizard
75
+ offers `nerd-font`. Declining keeps the current warning and continues; the chosen pager is not
76
+ changed.
77
+ - **FR-8** The offer is made only for a pager whose command is `delta`. Any other missing pager
78
+ command keeps today's warning with no offer.
79
+ - **FR-9** If the install fails or is declined, the warning tells the user how to install later:
80
+ `devstuff install delta`.
81
+
82
+ ### Links
83
+
84
+ - **FR-10** The five links above are added to `links.yaml` under existing categories.
85
+
86
+ ## Non-goals
87
+
88
+ - Installing a tool does not change its configuration. In particular, `delta` does not set git's
89
+ `core.pager`; that belongs to a git configurator (see the unscheduled `git-config/` item in
90
+ `docs/ROADMAP.md`).
91
+ - No newer-than-archive builds. All four apt tools use the Ubuntu archive even where upstream is
92
+ ahead (see `stack-decisions.md`).
93
+ - No fzf integration for shells other than bash, matching the starship and homebrew entries.
@@ -0,0 +1,74 @@
1
+ # FMHY picks — stack decisions
2
+
3
+ ## Measured package versions (2026-10-13)
4
+
5
+ From packages.ubuntu.com and npm:
6
+
7
+ | Package | `noble` (24.04, the CI image) | `resolute` (dev host) | Upstream |
8
+ |---|---|---|---|
9
+ | `git-delta` (installs `/usr/bin/delta`) | 0.16.5 | 0.18.2 | 0.20.1 |
10
+ | `ripgrep` | 14.1.0 | 15.1.0 | — |
11
+ | `shellcheck` | 0.9.0 | 0.11.0 | — |
12
+ | `fzf` | 0.44.1 | 0.67.0 | 0.74.5 |
13
+ | npm `opencode-ai` | — | — | 1.19.0, MIT, `bin: opencode`, has a `postinstall` |
14
+
15
+ None of the five is installed on the dev host.
16
+
17
+ ## Decisions
18
+
19
+ ### D-1: the Ubuntu archive for delta, ripgrep, ShellCheck and fzf
20
+
21
+ **Chosen:** `apt` from the distro archive (`type: bash` for fzf, see D-3).
22
+
23
+ **Rejected:** upstream GitHub release binaries. Each is newer, but needs a per-tool download
24
+ script with architecture mapping, version discovery and checksum handling, plus a hand-written
25
+ updater. The archive versions are all usable: delta 0.16.5 already supports `--dark` and
26
+ `--paging=never`, which is what the lazygit preset writes. `type: apt` also gives `outdated`,
27
+ `update` and version pinning for free.
28
+
29
+ ### D-2: the lazygit wizard offers to install delta
30
+
31
+ **Chosen** (owner, 2026-10-13): when a delta pager is selected and `delta` is missing, offer to
32
+ install it through `install_by_key` (`commands/install_cmd.py`), the existing seam the starship
33
+ wizard uses for `nerd-font`.
34
+
35
+ **Rejected:** catalog entry only, leaving the wizard's warning as the only help.
36
+
37
+ ### D-3: fzf as a `type: bash` entry with a `~/.bashrc` block
38
+
39
+ **Chosen** (owner, 2026-10-13): a bash script that installs the apt package and appends a marked
40
+ block, with a remove script that strips it. Same pattern as `starship` and `homebrew`.
41
+
42
+ **Cost, accepted:** a `bash` entry has no update checker, so `devstuff outdated` reports fzf as
43
+ `unsupported`, `devstuff update fzf` is a full reinstall, and fzf cannot be pinned in a profile.
44
+
45
+ **Cost, accepted (owner, 2026-10-13):** the check requires the marker in `~/.bashrc` (FR-4d),
46
+ so a user whose own fzf setup already binds the keys sees fzf as *not installed* — and
47
+ `devstuff remove fzf` would apt-remove an fzf they may have installed themselves.
48
+
49
+ **Rejected:** extending the `apt` type to run `install_script` after `apt-get install`. It would
50
+ keep fzf's update check, but is an engine change. **Finding while deciding:** today an `apt` entry
51
+ honours `remove_script` but silently ignores `install_script`, and `validate_catalog` does not
52
+ reject it. That trap is recorded here, not fixed by this work.
53
+
54
+ **Why the block has a fallback (FR-4a):** `fzf --bash` was added in fzf 0.48, and the CI image's
55
+ fzf is 0.44. Both noble's and resolute's `fzf` packages ship
56
+ `/usr/share/doc/fzf/examples/key-bindings.bash`. Minimized Docker images exclude `/usr/share/doc`,
57
+ so in the CI container the block may legitimately do nothing; the install test checks the binary,
58
+ not the key bindings.
59
+
60
+ ### D-4: OpenCode through the `npm` type
61
+
62
+ **Chosen** (owner kept OpenCode over the runners-up, 2026-10-13): `npm_name: opencode-ai`, like
63
+ `claude-code` and `codex`.
64
+
65
+ **Rejected:** OpenCode's `curl | bash` installer, which would make it a `bash` entry with no update
66
+ check. Note that the package's real binary comes from its `postinstall`; the generic npm installer
67
+ runs scripts (only the `pi` entry passes `--ignore-scripts`, in its own script), so nothing extra is
68
+ needed.
69
+
70
+ ### D-5: link categories
71
+
72
+ All five go into existing categories (`reference`, `shell`, `discovery`, `security`). explainshell
73
+ sits under `shell` next to the tmux wiki and Linux Command Library rather than `reference`, because
74
+ it explains shell commands specifically.
@@ -78,5 +78,6 @@ wizard's own launch check uses one internally too):
78
78
  - Keybinding remapping (Open Question 1) and `gui.theme` colours (Open Question 2).
79
79
  - `customCommands` authoring — preserved, never edited.
80
80
  - Running the type probe at wizard time (Open Question 3).
81
- - Offering to install delta when it is chosen but missing (Open Question 4) — `delta` is not
82
- in `tools.yaml` yet, which is what that would need first.
81
+ - ~~Offering to install delta when it is chosen but missing (Open Question 4)~~ — resolved
82
+ 2026-10-13: `delta` is a catalog tool and the wizard offers to install it through
83
+ `install_by_key` when a delta pager is chosen (see `docs/specs/fmhy-picks/`).
@@ -45,7 +45,9 @@ effect.
45
45
  - `customCommands`. Same reasoning: preserved, never authored.
46
46
  - Themes beyond the icon settings. `gui.theme` is fifteen colour-role lists; the starship
47
47
  configurator is where this repo does colour work.
48
- - Installing delta or a Nerd Font. The wizard points at `devstuff install`.
48
+ - Installing a Nerd Font. The wizard points at `devstuff install`. (Delta is now a
49
+ catalog tool and the wizard offers to install it when a delta pager is chosen
50
+ — Open Question 4, resolved; see `docs/specs/fmhy-picks/`.)
49
51
 
50
52
  ---
51
53
 
@@ -138,7 +140,7 @@ effect.
138
140
  | 1 | Should keybindings be configurable? | **Resolved 2026-08-02 — no.** A remapping UI over ~150 bindings is its own wizard. The existing tree is preserved. |
139
141
  | 2 | Should `gui.theme` colours be offered? | **Resolved 2026-08-02 — not in v1.** Fifteen colour-role lists; the starship configurator is where this repo does colour, and lifting its palette model here is a larger change than it looks. |
140
142
  | 3 | Should the type probe run at wizard time rather than authoring time? | **Resolved 2026-08-02 — no.** Each probe is a pty launch of ~2.5 seconds; probing 27 settings would take a minute and would need lazygit installed. Verified once, at authoring time, with the method recorded. |
141
- | 4 | Should the wizard offer to install delta when it is selected but missing? | **Open.** `delta` is not currently in `tools.yaml`; adding it would make the same `install_cmd.install_by_key` offer the starship wizard makes for `nerd-font` possible. |
143
+ | 4 | Should the wizard offer to install delta when it is selected but missing? | **Resolved 2026-10-13:** yes — `delta` is now a catalog tool and the wizard offers to install it through `install_by_key` (see `docs/specs/fmhy-picks/`). |
142
144
  | 5 | Should `default_drift` fail a save or only warn? | **Open — currently a failed check, which asks.** It fires when lazygit changes a default, which is a real signal the model is stale, but it is not a problem with the user's config. |
143
145
 
144
146
  ---
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "devstuff"
3
- version = "2.22.0"
3
+ version = "2.24.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -38,6 +38,41 @@ def _select(prompt: str, choices: list, current: object) -> str:
38
38
  return ui.select(prompt, choices, default=default) or str(current)
39
39
 
40
40
 
41
+ class _DeltaGate:
42
+ """At most one install offer per wizard run (same reasoning as starship's _FontGate).
43
+
44
+ The pager question and the presets can be revisited from the review menu; a
45
+ declined offer should not come back every time, and a second look at a missing
46
+ delta gets the install hint without the prompt.
47
+ """
48
+
49
+ def __init__(self) -> None:
50
+ self._offered = False
51
+
52
+ def check(self, cfg: LazygitConfig) -> None:
53
+ if not cfg.pager or cfg.pager.split()[0] != "delta" or shutil.which("delta"):
54
+ return
55
+ ui.console.print()
56
+ ui.warn("delta is not on your PATH — diffs would fail to render until it is.")
57
+ if self._offered:
58
+ ui.dim(" Install it with: devstuff install delta")
59
+ return
60
+ self._offered = True
61
+
62
+ from dev_setup import registry
63
+ from dev_setup.commands.install_cmd import install_by_key
64
+
65
+ if registry.get("delta") is None: # pragma: no cover — the key is built in
66
+ ui.dim(" Install it with: devstuff install delta")
67
+ return
68
+ if not ui.confirm("Install delta now?", default=True):
69
+ ui.dim(" You can install it later: devstuff install delta")
70
+ return
71
+ if not install_by_key("delta", yes=True) or shutil.which("delta") is None:
72
+ ui.warn("delta still is not on your PATH.")
73
+ ui.dim(" You can install it later: devstuff install delta")
74
+
75
+
41
76
  def _ask_preset(cfg: LazygitConfig, found: detect.Lazygit) -> None:
42
77
  choices = [
43
78
  questionary.Choice(title=preset.label, value=preset.key, description=preset.description)
@@ -83,8 +118,8 @@ def _ask_icons(cfg: LazygitConfig, found: detect.Lazygit) -> None:
83
118
 
84
119
  def _ask_pager(cfg: LazygitConfig) -> None:
85
120
  ui.console.print()
86
- ui.dim(" An external pager renders diffs. delta is the usual choice; it must be")
87
- ui.dim(" installed separately and needs --paging=never so it does not open its own.")
121
+ ui.dim(" An external pager renders diffs. delta is the usual choice (the wizard offers")
122
+ ui.dim(" to install it if it is missing) and needs --paging=never so it does not open its own.")
88
123
  choices = [
89
124
  questionary.Choice(title=label, value=command) for command, label in PAGERS.items()
90
125
  ]
@@ -94,7 +129,7 @@ def _ask_pager(cfg: LazygitConfig) -> None:
94
129
  cfg.pager = chosen
95
130
  if cfg.pager:
96
131
  tool = cfg.pager.split()[0]
97
- if shutil.which(tool) is None:
132
+ if tool != "delta" and shutil.which(tool) is None:
98
133
  ui.warn(f"{tool} is not on your PATH — diffs would fail to render until it is.")
99
134
  cfg.color_arg = "always"
100
135
 
@@ -347,8 +382,10 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
347
382
  _report(found)
348
383
 
349
384
  ui.console.print()
385
+ delta = _DeltaGate()
350
386
  _ask_preset(cfg, found)
351
387
  _ask_icons(cfg, found)
388
+ delta.check(cfg)
352
389
 
353
390
  while True:
354
391
  _show_preview(cfg, found)
@@ -374,10 +411,12 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
374
411
  if action == "preset":
375
412
  _ask_preset(cfg, found)
376
413
  _ask_icons(cfg, found)
414
+ delta.check(cfg)
377
415
  elif action == "icons":
378
416
  _ask_icons(cfg, found)
379
417
  elif action == "pager":
380
418
  _ask_pager(cfg)
419
+ delta.check(cfg)
381
420
  elif action == "appearance":
382
421
  _ask_appearance(cfg)
383
422
  elif action == "git":
@@ -73,6 +73,18 @@ links:
73
73
  category: shell
74
74
  url: https://starship.rs/config/
75
75
 
76
+ tmux-wiki:
77
+ name: tmux Wiki
78
+ description: The official tmux wiki — getting started, FAQ, formats and configuration
79
+ category: shell
80
+ url: https://github.com/tmux/tmux/wiki
81
+
82
+ explainshell:
83
+ name: explainshell
84
+ description: Paste a shell command to see what each part and flag does
85
+ category: shell
86
+ url: https://explainshell.com/
87
+
76
88
  conventional-commits:
77
89
  name: Conventional Commits
78
90
  description: The commit message specification used by commitizen
@@ -103,6 +115,18 @@ links:
103
115
  category: reference
104
116
  url: https://devhints.io/
105
117
 
118
+ devdocs:
119
+ name: DevDocs
120
+ description: API documentation for hundreds of languages and libraries in one searchable, offline-capable site
121
+ category: reference
122
+ url: https://devdocs.io/
123
+
124
+ archwiki:
125
+ name: ArchWiki
126
+ description: In-depth Linux reference for system configuration and tools, useful well beyond Arch
127
+ category: reference
128
+ url: https://wiki.archlinux.org/
129
+
106
130
  awesome-open-source:
107
131
  name: Awesome Open Source
108
132
  description: Curated open source projects browsable by topic and language
@@ -115,6 +139,12 @@ links:
115
139
  category: discovery
116
140
  url: https://fmhy.net/developer-tools
117
141
 
142
+ awesome-selfhosted:
143
+ name: Awesome Selfhosted
144
+ description: Curated index of free self-hostable software
145
+ category: discovery
146
+ url: https://awesome-selfhosted.net/
147
+
118
148
  crontab-guru:
119
149
  name: crontab guru
120
150
  description: Editor for cron schedule expressions that explains in plain English when a schedule runs
@@ -157,12 +187,24 @@ links:
157
187
  category: data
158
188
  url: https://duckdb.org/docs/current/
159
189
 
190
+ druid-docs:
191
+ name: Apache Druid Documentation
192
+ description: Real-time analytics (OLAP) database — design, ingestion and querying
193
+ category: data
194
+ url: https://druid.apache.org/docs/latest/design/
195
+
160
196
  watchtower-docs:
161
197
  name: Watchtower Documentation
162
198
  description: Automates Docker container image updates, with scheduling, registry auth, notifications, and an HTTP API
163
199
  category: containers
164
200
  url: https://watchtower.nickfedor.com/
165
201
 
202
+ homepage-docs:
203
+ name: Homepage
204
+ description: Self-hosted application dashboard configured with YAML or Docker labels
205
+ category: containers
206
+ url: https://gethomepage.dev/
207
+
166
208
  regex101:
167
209
  name: regex101
168
210
  description: Online regex tester, builder, converter, and debugger across PCRE2, JavaScript, Python, Go, Java, .NET, and Rust flavors
@@ -175,6 +217,12 @@ links:
175
217
  category: monitoring
176
218
  url: https://prometheus.io/
177
219
 
220
+ serverbox-docs:
221
+ name: Server Box Documentation
222
+ description: App for monitoring and managing Linux servers over SSH — status, terminal, SFTP, containers
223
+ category: monitoring
224
+ url: https://serverbox.lolli.tech/docs/
225
+
178
226
  cvedetails:
179
227
  name: CVEdetails
180
228
  description: CVE vulnerability database combining CVE records with exploits, EPSS and CISA KEV flags, and search by vendor, product, or date
@@ -186,3 +234,9 @@ links:
186
234
  description: Free and open platform for network and host visibility, honeypots, and log and case management, with a Pro edition
187
235
  category: security
188
236
  url: https://securityonionsolutions.com/software
237
+
238
+ deps-dev:
239
+ name: deps.dev
240
+ description: Open-source package explorer — versions, dependency graphs, advisories and supply-chain signals
241
+ category: security
242
+ url: https://deps.dev/