devstuff 2.7.0__tar.gz → 2.8.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 (180) hide show
  1. {devstuff-2.7.0 → devstuff-2.8.0}/CHANGELOG.md +6 -0
  2. {devstuff-2.7.0 → devstuff-2.8.0}/CLAUDE.md +14 -0
  3. {devstuff-2.7.0 → devstuff-2.8.0}/PKG-INFO +42 -1
  4. {devstuff-2.7.0 → devstuff-2.8.0}/README.md +41 -0
  5. {devstuff-2.7.0 → devstuff-2.8.0}/pyproject.toml +1 -1
  6. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/cli.py +3 -0
  7. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/help_cmd.py +3 -0
  8. devstuff-2.8.0/src/dev_setup/commands/links_cmd.py +141 -0
  9. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/doctor.py +26 -0
  10. devstuff-2.8.0/src/dev_setup/links.schema.json +50 -0
  11. devstuff-2.8.0/src/dev_setup/links.yaml +116 -0
  12. devstuff-2.8.0/src/dev_setup/links_catalog.py +138 -0
  13. devstuff-2.8.0/src/dev_setup/links_registry.py +86 -0
  14. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/ui.py +16 -3
  15. devstuff-2.8.0/tests/test_links.py +171 -0
  16. {devstuff-2.7.0 → devstuff-2.8.0}/uv.lock +1 -1
  17. {devstuff-2.7.0 → devstuff-2.8.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  18. {devstuff-2.7.0 → devstuff-2.8.0}/.claude/skills/run-stuff/smoke.sh +0 -0
  19. {devstuff-2.7.0 → devstuff-2.8.0}/.github/codex/review.md +0 -0
  20. {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/agent.yml +0 -0
  21. {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/bump.yml +0 -0
  22. {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/ci.yml +0 -0
  23. {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/publish.yml +0 -0
  24. {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/test-installs.yml +0 -0
  25. {devstuff-2.7.0 → devstuff-2.8.0}/.gitignore +0 -0
  26. {devstuff-2.7.0 → devstuff-2.8.0}/dev/Dockerfile +0 -0
  27. {devstuff-2.7.0 → devstuff-2.8.0}/dev/Dockerfile.ci +0 -0
  28. {devstuff-2.7.0 → devstuff-2.8.0}/dev/Makefile +0 -0
  29. {devstuff-2.7.0 → devstuff-2.8.0}/dev/docker-compose.yml +0 -0
  30. {devstuff-2.7.0 → devstuff-2.8.0}/devstuff +0 -0
  31. {devstuff-2.7.0 → devstuff-2.8.0}/docs/github-agent.md +0 -0
  32. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/README.md +0 -0
  33. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/development-plan.md +0 -0
  34. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/specifications.md +0 -0
  35. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/stack-decisions.md +0 -0
  36. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/development-plan.md +0 -0
  37. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/specifications.md +0 -0
  38. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  39. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/development-plan.md +0 -0
  40. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/specifications.md +0 -0
  41. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  42. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  43. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/specifications.md +0 -0
  44. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  45. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/development-plan.md +0 -0
  46. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/specifications.md +0 -0
  47. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  48. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/development-plan.md +0 -0
  49. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/specifications.md +0 -0
  50. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  51. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/development-plan.md +0 -0
  52. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/specifications.md +0 -0
  53. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  54. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/development-plan.md +0 -0
  55. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/specifications.md +0 -0
  56. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  57. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  58. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/specifications.md +0 -0
  59. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  60. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  61. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/specifications.md +0 -0
  62. {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  63. {devstuff-2.7.0 → devstuff-2.8.0}/install.sh +0 -0
  64. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/__init__.py +0 -0
  65. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/__main__.py +0 -0
  66. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/__init__.py +0 -0
  67. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/approval.py +0 -0
  68. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/bridges.py +0 -0
  69. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/catalog.py +0 -0
  70. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/completion.py +0 -0
  71. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/config.py +0 -0
  72. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/loop.py +0 -0
  73. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/ollama.py +0 -0
  74. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/preflight.py +0 -0
  75. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/primitives.py +0 -0
  76. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/registry.py +0 -0
  77. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/sandbox.py +0 -0
  78. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/session.py +0 -0
  79. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/transcript.py +0 -0
  80. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/wizard.py +0 -0
  81. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent_tools.schema.json +0 -0
  82. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent_tools.yaml +0 -0
  83. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/base.py +0 -0
  84. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/catalog.py +0 -0
  85. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/__init__.py +0 -0
  86. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/add_cmd.py +0 -0
  87. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  88. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  89. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/configure_cmd.py +0 -0
  90. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  91. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/docs_cmd.py +0 -0
  92. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
  93. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/functions_cmd.py +0 -0
  94. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/install_cmd.py +0 -0
  95. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/list_cmd.py +0 -0
  96. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  97. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/run_cmd.py +0 -0
  98. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  99. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/update_cmd.py +0 -0
  100. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/__init__.py +0 -0
  101. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  102. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  103. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/model.py +0 -0
  104. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/render.py +0 -0
  105. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  106. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  107. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  108. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/detect.py +0 -0
  109. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/model.py +0 -0
  110. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/preview.py +0 -0
  111. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/render.py +0 -0
  112. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  113. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  114. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  115. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  116. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  117. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  118. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  119. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  120. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/detect.py +0 -0
  121. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/model.py +0 -0
  122. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/render.py +0 -0
  123. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/validate.py +0 -0
  124. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  125. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  126. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  127. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  128. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  129. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  130. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
  131. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  132. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  133. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/model.py +0 -0
  134. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/render.py +0 -0
  135. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  136. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  137. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  138. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  139. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  140. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  141. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/model.py +0 -0
  142. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/preview.py +0 -0
  143. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/render.py +0 -0
  144. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  145. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/function_runner.py +0 -0
  146. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions.schema.json +0 -0
  147. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions.yaml +0 -0
  148. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions_catalog.py +0 -0
  149. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions_registry.py +0 -0
  150. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/generic.py +0 -0
  151. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/registry.py +0 -0
  152. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/tools.yaml +0 -0
  153. {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/verbose.py +0 -0
  154. {devstuff-2.7.0 → devstuff-2.8.0}/tests/__init__.py +0 -0
  155. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/__init__.py +0 -0
  156. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/conftest.py +0 -0
  157. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_agent_smoke.py +0 -0
  158. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_agent_tui.py +0 -0
  159. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_commitizen_config.py +0 -0
  160. {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_tools.py +0 -0
  161. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent.py +0 -0
  162. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_completion.py +0 -0
  163. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_loop.py +0 -0
  164. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_sandbox.py +0 -0
  165. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_tools.py +0 -0
  166. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_wizard.py +0 -0
  167. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_catalog.py +0 -0
  168. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_ansible.py +0 -0
  169. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_bat.py +0 -0
  170. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_commitizen.py +0 -0
  171. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_docker.py +0 -0
  172. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_lazygit.py +0 -0
  173. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_precommit.py +0 -0
  174. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_reptyr.py +0 -0
  175. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_starship.py +0 -0
  176. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_doctor.py +0 -0
  177. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_functions.py +0 -0
  178. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_generic.py +0 -0
  179. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_registry.py +0 -0
  180. {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_verbose.py +0 -0
@@ -1,3 +1,9 @@
1
+ ## v2.8.0 (2026-10-10)
2
+
3
+ ### Features
4
+
5
+ - **links**: add `devstuff links` section for browsing, searching, and opening tool links
6
+
1
7
  ## v2.7.0 (2026-10-07)
2
8
 
3
9
  ### Features
@@ -61,6 +61,7 @@ src/dev_setup/
61
61
  ├── registry.py # Loads the effective catalog into a live in-memory Tool registry
62
62
  ├── generic.py # GenericTool — the ONE engine that implements every install type
63
63
  ├── tools.yaml # Bundled built-in catalog (core/tools/languages categories)
64
+ ├── links.yaml # Bundled link catalog (+ links_catalog.py / links_registry.py / links.schema.json)
64
65
  ├── ui.py # Rich console + questionary wrappers (spinners, prompts, styled output)
65
66
  ├── verbose.py # Process-wide -v/-vv level + the stderr logger built on it
66
67
  ├── configure/ # Per-tool setup wizards (see "Configurators" below)
@@ -179,6 +180,19 @@ installing PHP packages via Composer as their own first-class type (analogous to
179
180
 
180
181
  ## Functions/scripts (a separate subsystem from tools)
181
182
 
183
+ ## Links (`devstuff links`) — a fourth, deliberately tiny catalog
184
+
185
+ `links.yaml` + `links_catalog.py` + `links_registry.py` + `commands/links_cmd.py` follow the
186
+ functions pattern (bundled → user override, validated at load) for bookmarks to other tools' sites.
187
+ `links list|search|open|path`, plus a type-to-filter picker on a bare `devstuff links` in a TTY.
188
+ `links.schema.json` is hand-maintained for editors and checked against `SUPPORTED_FIELDS` by a test.
189
+ - **`url` is restricted to `http(s)` in `validate_catalog`.** The URL goes to `webbrowser.open` from a
190
+ user-editable file; `file:`/`javascript:`/custom handlers would let a catalog launch local programs.
191
+ - **`search` matches title and description only, not the key**, terms ANDed, title hits ranked first.
192
+ It is a pure function in `links_registry` so it is tested without a terminal.
193
+ - **"No matches" exits 0; "could not open a browser" exits 1** — same found-nothing vs. could-not-act
194
+ split as `run_cmd`. `open` always prints the URL first, since over SSH there is no browser to find.
195
+
182
196
  `src/dev_setup/functions.yaml` + `functions_catalog.py` + `functions_registry.py` +
183
197
  `function_runner.py` are a parallel, independent catalog/registry from tools — functions
184
198
  aren't installed/removed, they're invoked (`devstuff run <key>`), so they get their own
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: devstuff
3
- Version: 2.7.0
3
+ Version: 2.8.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>
@@ -99,6 +99,8 @@ The checks cover:
99
99
  | `user-tools-catalog` | user `tools.yaml` (if present) is valid | — |
100
100
  | `bundled-functions-catalog` | bundled `functions.yaml` loads and validates | — |
101
101
  | `user-functions-catalog` | user `functions.yaml` (if present) is valid | — |
102
+ | `bundled-links-catalog` | bundled `links.yaml` loads and validates | — |
103
+ | `user-links-catalog` | user `links.yaml` (if present) is valid | — |
102
104
  | `bundled-agent-catalog` | bundled `agent_tools.yaml` loads and validates | — |
103
105
  | `user-agent-catalog` | user `agent_tools.yaml` (if present) is valid | — |
104
106
  | `registry` | effective catalog builds into tool objects; `is_installed()` probes don't crash | — |
@@ -1275,6 +1277,45 @@ Optional utilities you may want on some machines.
1275
1277
  | `ansible` | Ansible | Automation engine for configuration management and app deployment (`devstuff configure ansible`) | `ansible --help` |
1276
1278
  | `ansible-vault` | Ansible Vault | Encrypt and manage secrets within Ansible projects (bundled with Ansible) | `ansible-vault --help` |
1277
1279
  | `aws` | AWS CLI | Amazon Web Services CLI v2 | `aws help` |
1280
+ ## Links
1281
+
1282
+ A catalog of bookmarks to other tools' sites and docs — `devstuff links` lists them, searches
1283
+ them, and opens one in your browser. Same bundled + user precedence merge as the other
1284
+ catalogs (`~/.config/devstuff/links.yaml` overrides matching keys and appends new ones).
1285
+
1286
+ ```bash
1287
+ devstuff links # interactive picker: type to filter, Enter to open
1288
+ devstuff links list [category] # all links, grouped by category
1289
+ devstuff links search docker images # title + description, case-insensitive, every word must match
1290
+ devstuff links open uv-docs # open in your browser (alias: devstuff link ...)
1291
+ devstuff links path # print ~/.config/devstuff/links.yaml
1292
+ ```
1293
+
1294
+ `search` matches the title and description only (title matches rank first) and exits 0 when
1295
+ nothing matches. `open` prints the URL as well, so over SSH — where there is no browser on the
1296
+ machine devstuff runs on — you still get a clickable link; in that case it exits non-zero.
1297
+
1298
+ ```yaml
1299
+ version: 1
1300
+ links:
1301
+ my-wiki:
1302
+ name: Team Wiki
1303
+ description: Runbooks and onboarding notes
1304
+ category: work # optional, defaults to "custom"
1305
+ url: https://wiki.example.com
1306
+ ```
1307
+
1308
+ | Field | Required | Description |
1309
+ |-------|----------|-------------|
1310
+ | `url` | yes | Absolute `http(s)` URL. Other schemes (`file:`, `javascript:`, …) are rejected at load time. |
1311
+ | `name` | no | Title shown in listings and matched by `search`. Defaults to the key. |
1312
+ | `description` | no | Shown in listings and matched by `search`. |
1313
+ | `category` | no | Grouping label for `list`. Defaults to `custom`. |
1314
+
1315
+ `src/dev_setup/links.schema.json` documents these fields for editor tooling.
1316
+
1317
+ ---
1318
+
1278
1319
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1279
1320
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1280
1321
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
@@ -72,6 +72,8 @@ The checks cover:
72
72
  | `user-tools-catalog` | user `tools.yaml` (if present) is valid | — |
73
73
  | `bundled-functions-catalog` | bundled `functions.yaml` loads and validates | — |
74
74
  | `user-functions-catalog` | user `functions.yaml` (if present) is valid | — |
75
+ | `bundled-links-catalog` | bundled `links.yaml` loads and validates | — |
76
+ | `user-links-catalog` | user `links.yaml` (if present) is valid | — |
75
77
  | `bundled-agent-catalog` | bundled `agent_tools.yaml` loads and validates | — |
76
78
  | `user-agent-catalog` | user `agent_tools.yaml` (if present) is valid | — |
77
79
  | `registry` | effective catalog builds into tool objects; `is_installed()` probes don't crash | — |
@@ -1248,6 +1250,45 @@ Optional utilities you may want on some machines.
1248
1250
  | `ansible` | Ansible | Automation engine for configuration management and app deployment (`devstuff configure ansible`) | `ansible --help` |
1249
1251
  | `ansible-vault` | Ansible Vault | Encrypt and manage secrets within Ansible projects (bundled with Ansible) | `ansible-vault --help` |
1250
1252
  | `aws` | AWS CLI | Amazon Web Services CLI v2 | `aws help` |
1253
+ ## Links
1254
+
1255
+ A catalog of bookmarks to other tools' sites and docs — `devstuff links` lists them, searches
1256
+ them, and opens one in your browser. Same bundled + user precedence merge as the other
1257
+ catalogs (`~/.config/devstuff/links.yaml` overrides matching keys and appends new ones).
1258
+
1259
+ ```bash
1260
+ devstuff links # interactive picker: type to filter, Enter to open
1261
+ devstuff links list [category] # all links, grouped by category
1262
+ devstuff links search docker images # title + description, case-insensitive, every word must match
1263
+ devstuff links open uv-docs # open in your browser (alias: devstuff link ...)
1264
+ devstuff links path # print ~/.config/devstuff/links.yaml
1265
+ ```
1266
+
1267
+ `search` matches the title and description only (title matches rank first) and exits 0 when
1268
+ nothing matches. `open` prints the URL as well, so over SSH — where there is no browser on the
1269
+ machine devstuff runs on — you still get a clickable link; in that case it exits non-zero.
1270
+
1271
+ ```yaml
1272
+ version: 1
1273
+ links:
1274
+ my-wiki:
1275
+ name: Team Wiki
1276
+ description: Runbooks and onboarding notes
1277
+ category: work # optional, defaults to "custom"
1278
+ url: https://wiki.example.com
1279
+ ```
1280
+
1281
+ | Field | Required | Description |
1282
+ |-------|----------|-------------|
1283
+ | `url` | yes | Absolute `http(s)` URL. Other schemes (`file:`, `javascript:`, …) are rejected at load time. |
1284
+ | `name` | no | Title shown in listings and matched by `search`. Defaults to the key. |
1285
+ | `description` | no | Shown in listings and matched by `search`. |
1286
+ | `category` | no | Grouping label for `list`. Defaults to `custom`. |
1287
+
1288
+ `src/dev_setup/links.schema.json` documents these fields for editor tooling.
1289
+
1290
+ ---
1291
+
1251
1292
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1252
1293
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1253
1294
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "devstuff"
3
- version = "2.7.0"
3
+ version = "2.8.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -31,6 +31,7 @@ def _register_commands() -> None:
31
31
  from dev_setup.commands.doctor_cmd import doctor_cmd
32
32
  from dev_setup.commands.functions_cmd import functions_cmd
33
33
  from dev_setup.commands.install_cmd import install_cmd
34
+ from dev_setup.commands.links_cmd import links_cmd
34
35
  from dev_setup.commands.list_cmd import list_cmd
35
36
  from dev_setup.commands.remove_cmd import remove_cmd
36
37
  from dev_setup.commands.run_cmd import run_cmd
@@ -52,6 +53,8 @@ def _register_commands() -> None:
52
53
  cli.add_command(catalog_cmd, "catalog")
53
54
  cli.add_command(run_cmd, "run")
54
55
  cli.add_command(functions_cmd, "functions")
56
+ cli.add_command(links_cmd, "links")
57
+ cli.add_command(links_cmd, "link")
55
58
  cli.add_command(skills_cmd, "skills")
56
59
  cli.add_command(agent_cmd, "agent")
57
60
 
@@ -21,6 +21,7 @@ def print_help() -> None:
21
21
  ("docs", "<package>", "Open documentation in browser"),
22
22
  ("run", "<function> [args...]", "Run a function/script"),
23
23
  ("functions", "<list|enable|disable|path>", "Manage functions/scripts"),
24
+ ("links", "[list|search|open|path]", "Browse, search, and open tool links"),
24
25
  ("skills", "add", "Append GitHub skills to claude/codex/pi"),
25
26
  ("agent", "[--setup] [--dir] [--model]", "Chat with a local tool-using model"),
26
27
  ("version", "", "Show version"),
@@ -50,6 +51,8 @@ def print_help() -> None:
50
51
  "devstuff catalog export",
51
52
  "devstuff functions list",
52
53
  "devstuff functions enable ssh-agent-key",
54
+ "devstuff links search docker",
55
+ "devstuff links open uv-docs",
53
56
  "devstuff agent",
54
57
  "devstuff agent --setup",
55
58
  'devstuff agent --print "what node tools are available?"',
@@ -0,0 +1,141 @@
1
+ from __future__ import annotations
2
+
3
+ import sys
4
+ import webbrowser
5
+
6
+ import click
7
+ import questionary
8
+ from rich.markup import escape
9
+
10
+ from dev_setup import links_registry, ui
11
+ from dev_setup.links_catalog import USER_CATALOG_PATH
12
+ from dev_setup.links_registry import LinkDef
13
+
14
+
15
+ @click.group("links", invoke_without_command=True)
16
+ @click.pass_context
17
+ def links_cmd(ctx: click.Context) -> None:
18
+ """Browse, search, and open links to other tools' sites and docs."""
19
+ if ctx.invoked_subcommand is not None:
20
+ return
21
+ # A bare `devstuff links` is the "access the section" entry point: a type-to-filter
22
+ # picker when there is a terminal to drive it, the plain listing otherwise.
23
+ if sys.stdin.isatty() and sys.stdout.isatty():
24
+ _pick_and_open()
25
+ else:
26
+ ctx.invoke(list_cmd)
27
+
28
+
29
+ def _print_groups(links: list[LinkDef]) -> None:
30
+ by_cat: dict[str, list[LinkDef]] = {}
31
+ for link in links:
32
+ by_cat.setdefault(link.category, []).append(link)
33
+
34
+ key_width = max(len(link.key) for link in links) + 2
35
+ for cat in sorted(by_cat, key=lambda c: (c == "custom", c)):
36
+ ui.console.print(f"\n [bold]{cat.upper()}[/]")
37
+ for link in sorted(by_cat[cat], key=lambda link: link.key):
38
+ _print_row(link, key_width)
39
+ ui.console.print()
40
+
41
+
42
+ def _print_row(link: LinkDef, key_width: int, *, show_category: bool = False) -> None:
43
+ ui.console.print(f" [bold cyan]{link.key:<{key_width}}[/] {link.name}")
44
+ detail = link.description
45
+ if show_category:
46
+ detail = f"{detail} [{link.category}]" if detail else f"[{link.category}]"
47
+ if detail:
48
+ # escape(): "[category]" and any bracketed description text are valid Rich markup
49
+ ui.console.print(f" {'':<{key_width}} [dim]{escape(detail)}[/]")
50
+
51
+
52
+ @links_cmd.command("list")
53
+ @click.argument("category", required=False)
54
+ def list_cmd(category: str | None) -> None:
55
+ """List links, grouped by category."""
56
+ links = links_registry.all_links()
57
+ if category:
58
+ links = [link for link in links if link.category == category]
59
+ if not links:
60
+ ui.info("No links match." if category else "No links defined.")
61
+ return
62
+ _print_groups(links)
63
+ ui.dim("Open one with: devstuff links open <key>")
64
+
65
+
66
+ @links_cmd.command("search")
67
+ @click.argument("query", nargs=-1, required=True)
68
+ def search_cmd(query: tuple[str, ...]) -> None:
69
+ """Search links by title and description. Every word must match."""
70
+ text = " ".join(query)
71
+ matches = links_registry.search(text)
72
+ # "Found nothing" is a correct answer, so it exits 0 — non-zero is for failures.
73
+ if not matches:
74
+ ui.info(f"No links match '{text}'.")
75
+ return
76
+ ui.console.print(f"\n [bold]{len(matches)} match(es)[/] [dim]for '{escape(text)}'[/]")
77
+ key_width = max(len(link.key) for link in matches) + 2
78
+ for link in matches: # keep search rank order rather than re-sorting by key
79
+ _print_row(link, key_width, show_category=True)
80
+ ui.console.print()
81
+ ui.dim("Open one with: devstuff links open <key>")
82
+
83
+
84
+ @links_cmd.command("open")
85
+ @click.argument("key")
86
+ def open_cmd(key: str) -> None:
87
+ """Open a link in your browser."""
88
+ link = links_registry.get(key)
89
+ if link is None:
90
+ ui.error(f"Unknown link: '{key}'")
91
+ suggestions = [m.key for m in links_registry.search(key)][:5]
92
+ if suggestions:
93
+ ui.dim(f"Did you mean: {', '.join(suggestions)}")
94
+ ui.dim("See all links with: devstuff links list")
95
+ sys.exit(1)
96
+ _open(link)
97
+
98
+
99
+ @links_cmd.command("path")
100
+ def path_cmd() -> None:
101
+ """Print the path to the user links catalog."""
102
+ click.echo(str(USER_CATALOG_PATH))
103
+
104
+
105
+ def _open(link: LinkDef) -> None:
106
+ ui.console.print(f"\n [bold]{link.name}[/]")
107
+ if link.description:
108
+ ui.console.print(f" [dim]{escape(link.description)}[/]")
109
+ ui.console.print(f" [cyan underline link={link.url}]{link.url}[/]\n")
110
+
111
+ # webbrowser.open acts on the machine devstuff runs on: over SSH there is no browser
112
+ # to find, so the URL above is the fallback (terminals make it clickable).
113
+ if webbrowser.open(link.url):
114
+ ui.success("Opened in browser.")
115
+ else:
116
+ ui.warn("Could not open a browser — copy the URL above to open it manually.")
117
+ sys.exit(1)
118
+
119
+
120
+ def _pick_and_open() -> None:
121
+ links = sorted(
122
+ links_registry.all_links(),
123
+ key=lambda link: (link.category == "custom", link.category, link.key),
124
+ )
125
+ if not links:
126
+ ui.info("No links defined.")
127
+ return
128
+
129
+ ui.section("Links")
130
+ ui.dim("Type to filter, Enter to open.")
131
+ choices = [
132
+ questionary.Choice(
133
+ title=f"{link.name} · {link.category} · {link.description}",
134
+ value=link.key,
135
+ )
136
+ for link in links
137
+ ]
138
+ key = ui.select("Open which link?", choices, searchable=True)
139
+ link = links_registry.get(key)
140
+ if link is not None:
141
+ _open(link)
@@ -150,6 +150,30 @@ def check_user_functions_catalog() -> CheckResult:
150
150
  )
151
151
 
152
152
 
153
+ def check_bundled_links_catalog() -> CheckResult:
154
+ """Bundled links.yaml loads and validates."""
155
+ from dev_setup import links_catalog as lc
156
+
157
+ try:
158
+ links = lc.load_bundled_catalog()
159
+ except lc.CatalogError as exc:
160
+ return CheckResult("bundled-links-catalog", FAIL, f"Bundled links.yaml invalid: {exc}")
161
+ return CheckResult("bundled-links-catalog", PASS, f"Bundled links.yaml valid ({len(links)} links)")
162
+
163
+
164
+ def check_user_links_catalog() -> CheckResult:
165
+ """User links.yaml (if present) loads and validates."""
166
+ from dev_setup import links_catalog as lc
167
+
168
+ if not lc.USER_CATALOG_PATH.exists():
169
+ return CheckResult("user-links-catalog", PASS, "No user links.yaml")
170
+ try:
171
+ links = lc.read_user_catalog()
172
+ except lc.CatalogError as exc:
173
+ return CheckResult("user-links-catalog", FAIL, f"User links.yaml invalid: {exc}")
174
+ return CheckResult("user-links-catalog", PASS, f"User links.yaml valid ({len(links)} links)")
175
+
176
+
153
177
  def check_bundled_agent_catalog() -> CheckResult:
154
178
  """Bundled agent_tools.yaml loads and validates."""
155
179
  from dev_setup.agent import catalog as ac
@@ -284,6 +308,8 @@ ALL_CHECKS: list[Callable[[], CheckResult]] = [
284
308
  check_user_tools_catalog,
285
309
  check_bundled_functions_catalog,
286
310
  check_user_functions_catalog,
311
+ check_bundled_links_catalog,
312
+ check_user_links_catalog,
287
313
  check_bundled_agent_catalog,
288
314
  check_user_agent_catalog,
289
315
  check_registry_loads,
@@ -0,0 +1,50 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://github.com/thesawdawg/dev-setup-py/links.schema.json",
4
+ "title": "devstuff links catalog",
5
+ "description": "Schema for links.yaml (bundled at src/dev_setup/links.yaml, user overrides at ~/.config/devstuff/links.yaml). Defines bookmarks to other tools' sites and docs, listed, searched, and opened via `devstuff links`. Mirrors the validation in links_catalog.py — keep both in sync.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["version", "links"],
9
+ "properties": {
10
+ "version": {
11
+ "const": 1,
12
+ "description": "Catalog schema version. Currently always 1."
13
+ },
14
+ "links": {
15
+ "type": "object",
16
+ "description": "Map of link key -> link definition.",
17
+ "propertyNames": {
18
+ "pattern": "^[a-z0-9][a-z0-9_-]*$",
19
+ "description": "Lowercase letters, digits, hyphens, underscores; must start with a letter or digit."
20
+ },
21
+ "additionalProperties": { "$ref": "#/definitions/link" }
22
+ }
23
+ },
24
+ "definitions": {
25
+ "link": {
26
+ "type": "object",
27
+ "additionalProperties": false,
28
+ "required": ["url"],
29
+ "properties": {
30
+ "name": {
31
+ "type": "string",
32
+ "description": "Title shown in listings and matched by `links search`. Defaults to the catalog key."
33
+ },
34
+ "description": {
35
+ "type": "string",
36
+ "description": "Short description shown in listings and matched by `links search`. Defaults to an empty string."
37
+ },
38
+ "category": {
39
+ "type": "string",
40
+ "description": "Freeform grouping label used by `links list`. Defaults to 'custom'."
41
+ },
42
+ "url": {
43
+ "type": "string",
44
+ "pattern": "^https?://[^/\\s]+",
45
+ "description": "Absolute http(s) URL opened in the browser. Other schemes (file:, javascript:, ...) are rejected."
46
+ }
47
+ }
48
+ }
49
+ }
50
+ }
@@ -0,0 +1,116 @@
1
+ # yaml-language-server: $schema=./links.schema.json
2
+ version: 1
3
+ links:
4
+ devstuff-repo:
5
+ name: devstuff Repository
6
+ description: Source code, issues, and releases for devstuff
7
+ category: devstuff
8
+ url: https://github.com/thesawdawg/dev-setup-py
9
+
10
+ devstuff-pypi:
11
+ name: devstuff on PyPI
12
+ description: Published releases of the devstuff package
13
+ category: devstuff
14
+ url: https://pypi.org/project/devstuff/
15
+
16
+ uv-docs:
17
+ name: uv Documentation
18
+ description: Python package and project manager, tool installs, and Python provisioning
19
+ category: python
20
+ url: https://docs.astral.sh/uv/
21
+
22
+ ruff-docs:
23
+ name: Ruff Documentation
24
+ description: Python linter and formatter rules and configuration
25
+ category: python
26
+ url: https://docs.astral.sh/ruff/
27
+
28
+ pypi:
29
+ name: PyPI
30
+ description: Search the Python Package Index
31
+ category: python
32
+ url: https://pypi.org/
33
+
34
+ npm-registry:
35
+ name: npm
36
+ description: Search the npm package registry for Node.js packages
37
+ category: node
38
+ url: https://www.npmjs.com/
39
+
40
+ nvm-repo:
41
+ name: nvm Repository
42
+ description: Node Version Manager install instructions and usage
43
+ category: node
44
+ url: https://github.com/nvm-sh/nvm
45
+
46
+ docker-docs:
47
+ name: Docker Documentation
48
+ description: Docker Engine, Compose, and CLI reference
49
+ category: containers
50
+ url: https://docs.docker.com/
51
+
52
+ docker-hub:
53
+ name: Docker Hub
54
+ description: Search public container images
55
+ category: containers
56
+ url: https://hub.docker.com/
57
+
58
+ ollama-library:
59
+ name: Ollama Model Library
60
+ description: Browse local LLM models that can be pulled with ollama
61
+ category: ai
62
+ url: https://ollama.com/library
63
+
64
+ claude-code-docs:
65
+ name: Claude Code Documentation
66
+ description: Anthropic's agentic coding CLI, settings, hooks, and MCP servers
67
+ category: ai
68
+ url: https://docs.claude.com/en/docs/claude-code/overview
69
+
70
+ starship-docs:
71
+ name: Starship Documentation
72
+ description: Cross-shell prompt configuration and module reference
73
+ category: shell
74
+ url: https://starship.rs/config/
75
+
76
+ conventional-commits:
77
+ name: Conventional Commits
78
+ description: The commit message specification used by commitizen
79
+ category: git
80
+ url: https://www.conventionalcommits.org/
81
+
82
+ github-cli-manual:
83
+ name: GitHub CLI Manual
84
+ description: Reference for the gh command line tool
85
+ category: git
86
+ url: https://cli.github.com/manual/
87
+
88
+ devtoys:
89
+ name: DevToys
90
+ description: Offline developer utilities — converters, encoders, formatters, and generators
91
+ category: utilities
92
+ url: https://devtoys.app/
93
+
94
+ linux-command-library:
95
+ name: Linux Command Library
96
+ description: Searchable reference of Linux commands with examples and cheat sheets
97
+ category: reference
98
+ url: https://linuxcommandlibrary.com/
99
+
100
+ devhints:
101
+ name: Devhints
102
+ description: Community cheatsheets for languages, tools, and frameworks
103
+ category: reference
104
+ url: https://devhints.io/
105
+
106
+ awesome-open-source:
107
+ name: Awesome Open Source
108
+ description: Curated open source projects browsable by topic and language
109
+ category: discovery
110
+ url: https://awesomeopensource.com/
111
+
112
+ fmhy-developer-tools:
113
+ name: FMHY Developer Tools
114
+ description: Curated list of free developer tools, editors, hosting, and resources
115
+ category: discovery
116
+ url: https://fmhy.net/developer-tools