devstuff 2.7.0__tar.gz → 2.9.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 (181) hide show
  1. {devstuff-2.7.0 → devstuff-2.9.0}/CHANGELOG.md +12 -0
  2. {devstuff-2.7.0 → devstuff-2.9.0}/CLAUDE.md +14 -0
  3. {devstuff-2.7.0 → devstuff-2.9.0}/PKG-INFO +43 -2
  4. {devstuff-2.7.0 → devstuff-2.9.0}/README.md +42 -1
  5. {devstuff-2.7.0 → devstuff-2.9.0}/pyproject.toml +1 -1
  6. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/approval.py +6 -6
  7. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/loop.py +5 -2
  8. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/session.py +33 -11
  9. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/cli.py +3 -0
  10. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/add_cmd.py +2 -2
  11. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/configure_cmd.py +7 -4
  12. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/docs_cmd.py +1 -1
  13. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/doctor_cmd.py +21 -7
  14. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/functions_cmd.py +12 -8
  15. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/help_cmd.py +39 -10
  16. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/install_cmd.py +1 -1
  17. devstuff-2.9.0/src/dev_setup/commands/links_cmd.py +141 -0
  18. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/list_cmd.py +17 -16
  19. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/doctor.py +26 -0
  20. devstuff-2.9.0/src/dev_setup/links.schema.json +50 -0
  21. devstuff-2.9.0/src/dev_setup/links.yaml +116 -0
  22. devstuff-2.9.0/src/dev_setup/links_catalog.py +138 -0
  23. devstuff-2.9.0/src/dev_setup/links_registry.py +86 -0
  24. devstuff-2.9.0/src/dev_setup/ui.py +223 -0
  25. devstuff-2.9.0/tests/test_links.py +171 -0
  26. {devstuff-2.7.0 → devstuff-2.9.0}/uv.lock +1 -1
  27. devstuff-2.7.0/src/dev_setup/ui.py +0 -128
  28. {devstuff-2.7.0 → devstuff-2.9.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  29. {devstuff-2.7.0 → devstuff-2.9.0}/.claude/skills/run-stuff/smoke.sh +0 -0
  30. {devstuff-2.7.0 → devstuff-2.9.0}/.github/codex/review.md +0 -0
  31. {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/agent.yml +0 -0
  32. {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/bump.yml +0 -0
  33. {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/ci.yml +0 -0
  34. {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/publish.yml +0 -0
  35. {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/test-installs.yml +0 -0
  36. {devstuff-2.7.0 → devstuff-2.9.0}/.gitignore +0 -0
  37. {devstuff-2.7.0 → devstuff-2.9.0}/dev/Dockerfile +0 -0
  38. {devstuff-2.7.0 → devstuff-2.9.0}/dev/Dockerfile.ci +0 -0
  39. {devstuff-2.7.0 → devstuff-2.9.0}/dev/Makefile +0 -0
  40. {devstuff-2.7.0 → devstuff-2.9.0}/dev/docker-compose.yml +0 -0
  41. {devstuff-2.7.0 → devstuff-2.9.0}/devstuff +0 -0
  42. {devstuff-2.7.0 → devstuff-2.9.0}/docs/github-agent.md +0 -0
  43. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/README.md +0 -0
  44. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/development-plan.md +0 -0
  45. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/specifications.md +0 -0
  46. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/stack-decisions.md +0 -0
  47. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/development-plan.md +0 -0
  48. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/specifications.md +0 -0
  49. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  50. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/development-plan.md +0 -0
  51. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/specifications.md +0 -0
  52. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  53. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  54. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/specifications.md +0 -0
  55. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  56. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/development-plan.md +0 -0
  57. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/specifications.md +0 -0
  58. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  59. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/development-plan.md +0 -0
  60. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/specifications.md +0 -0
  61. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  62. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/development-plan.md +0 -0
  63. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/specifications.md +0 -0
  64. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  65. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/development-plan.md +0 -0
  66. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/specifications.md +0 -0
  67. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  68. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  69. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/specifications.md +0 -0
  70. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  71. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  72. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/specifications.md +0 -0
  73. {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  74. {devstuff-2.7.0 → devstuff-2.9.0}/install.sh +0 -0
  75. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/__init__.py +0 -0
  76. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/__main__.py +0 -0
  77. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/__init__.py +0 -0
  78. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/bridges.py +0 -0
  79. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/catalog.py +0 -0
  80. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/completion.py +0 -0
  81. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/config.py +0 -0
  82. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/ollama.py +0 -0
  83. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/preflight.py +0 -0
  84. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/primitives.py +0 -0
  85. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/registry.py +0 -0
  86. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/sandbox.py +0 -0
  87. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/transcript.py +0 -0
  88. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/wizard.py +0 -0
  89. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent_tools.schema.json +0 -0
  90. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent_tools.yaml +0 -0
  91. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/base.py +0 -0
  92. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/catalog.py +0 -0
  93. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/__init__.py +0 -0
  94. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  95. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  96. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  97. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  98. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/run_cmd.py +0 -0
  99. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  100. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/update_cmd.py +0 -0
  101. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/__init__.py +0 -0
  102. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  103. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  104. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/model.py +0 -0
  105. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/render.py +0 -0
  106. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  107. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  108. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  109. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/detect.py +0 -0
  110. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/model.py +0 -0
  111. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/preview.py +0 -0
  112. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/render.py +0 -0
  113. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  114. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  115. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  116. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  117. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  118. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  119. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  120. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  121. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/detect.py +0 -0
  122. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/model.py +0 -0
  123. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/render.py +0 -0
  124. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/validate.py +0 -0
  125. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  126. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  127. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  128. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  129. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  130. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  131. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
  132. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  133. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  134. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/model.py +0 -0
  135. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/render.py +0 -0
  136. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  137. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  138. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  139. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  140. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  141. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  142. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/model.py +0 -0
  143. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/preview.py +0 -0
  144. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/render.py +0 -0
  145. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  146. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/function_runner.py +0 -0
  147. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions.schema.json +0 -0
  148. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions.yaml +0 -0
  149. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions_catalog.py +0 -0
  150. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions_registry.py +0 -0
  151. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/generic.py +0 -0
  152. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/registry.py +0 -0
  153. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/tools.yaml +0 -0
  154. {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/verbose.py +0 -0
  155. {devstuff-2.7.0 → devstuff-2.9.0}/tests/__init__.py +0 -0
  156. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/__init__.py +0 -0
  157. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/conftest.py +0 -0
  158. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_agent_smoke.py +0 -0
  159. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_agent_tui.py +0 -0
  160. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_commitizen_config.py +0 -0
  161. {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_tools.py +0 -0
  162. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent.py +0 -0
  163. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_completion.py +0 -0
  164. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_loop.py +0 -0
  165. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_sandbox.py +0 -0
  166. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_tools.py +0 -0
  167. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_wizard.py +0 -0
  168. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_catalog.py +0 -0
  169. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_ansible.py +0 -0
  170. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_bat.py +0 -0
  171. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_commitizen.py +0 -0
  172. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_docker.py +0 -0
  173. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_lazygit.py +0 -0
  174. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_precommit.py +0 -0
  175. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_reptyr.py +0 -0
  176. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_starship.py +0 -0
  177. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_doctor.py +0 -0
  178. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_functions.py +0 -0
  179. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_generic.py +0 -0
  180. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_registry.py +0 -0
  181. {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_verbose.py +0 -0
@@ -1,3 +1,15 @@
1
+ ## v2.9.0 (2026-10-10)
2
+
3
+ ### Features
4
+
5
+ - **ui**: modernize terminal UI with cohesive violet-cyan theme
6
+
7
+ ## v2.8.0 (2026-10-10)
8
+
9
+ ### Features
10
+
11
+ - **links**: add `devstuff links` section for browsing, searching, and opening tool links
12
+
1
13
  ## v2.7.0 (2026-10-07)
2
14
 
3
15
  ### 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.9.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 | — |
@@ -928,7 +930,7 @@ devstuff agent --print "which node tools do I have?" # one-shot, non-interacti
928
930
  ```
929
931
  you ❯ create a python project called xyz-project with a hello world main.py
930
932
 
931
- ↳ run_command(command='mkdir xyz-project')
933
+ ▸ run_command(command='mkdir xyz-project')
932
934
 
933
935
  ╭─ run in ./xyz-project ──────────────────────╮
934
936
  │ mkdir xyz-project │
@@ -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 | — |
@@ -901,7 +903,7 @@ devstuff agent --print "which node tools do I have?" # one-shot, non-interacti
901
903
  ```
902
904
  you ❯ create a python project called xyz-project with a hello world main.py
903
905
 
904
- ↳ run_command(command='mkdir xyz-project')
906
+ ▸ run_command(command='mkdir xyz-project')
905
907
 
906
908
  ╭─ run in ./xyz-project ──────────────────────╮
907
909
  │ mkdir xyz-project │
@@ -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.9.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -21,7 +21,7 @@ def _write_file_preview(args: dict[str, Any], ws: Workspace) -> Panel:
21
21
  except SandboxError:
22
22
  # The sandbox will reject this before it runs; show the raw request rather
23
23
  # than crashing the prompt.
24
- return Panel(str(args.get("path", "")), title="write_file", border_style="yellow")
24
+ return Panel(str(args.get("path", "")), title="write_file", border_style=ui.AMBER)
25
25
 
26
26
  new = args.get("content", "")
27
27
  old = path.read_text(encoding="utf-8", errors="replace") if path.exists() else ""
@@ -29,7 +29,7 @@ def _write_file_preview(args: dict[str, Any], ws: Workspace) -> Panel:
29
29
 
30
30
  if not path.exists():
31
31
  body = Syntax(new, "text", theme="monokai", line_numbers=False, word_wrap=True)
32
- return Panel(body, title=f"create {label}", border_style="green")
32
+ return Panel(body, title=f"create {label}", border_style=ui.GREEN)
33
33
 
34
34
  diff = "".join(
35
35
  difflib.unified_diff(
@@ -41,11 +41,11 @@ def _write_file_preview(args: dict[str, Any], ws: Workspace) -> Panel:
41
41
  )
42
42
  )
43
43
  if not diff:
44
- return Panel("(no change)", title=f"write {label}", border_style="dim")
44
+ return Panel("(no change)", title=f"write {label}", border_style=ui.BORDER)
45
45
  return Panel(
46
46
  Syntax(diff, "diff", theme="monokai", line_numbers=False),
47
47
  title=f"edit {label}",
48
- border_style="yellow",
48
+ border_style=ui.AMBER,
49
49
  )
50
50
 
51
51
 
@@ -59,11 +59,11 @@ def preview(tool: AgentTool, args: dict[str, Any], ws: Workspace) -> Panel:
59
59
  return Panel(
60
60
  Syntax(str(args.get("command", "")), "bash", theme="monokai", line_numbers=False),
61
61
  title=f"run in {ws.display(ws.cwd)}",
62
- border_style="yellow",
62
+ border_style=ui.AMBER,
63
63
  )
64
64
 
65
65
  rendered = "\n".join(f"{k}: {v}" for k, v in args.items()) or "(no arguments)"
66
- return Panel(rendered, title=tool.key, border_style="yellow")
66
+ return Panel(rendered, title=tool.key, border_style=ui.AMBER)
67
67
 
68
68
 
69
69
  class ApprovalPolicy:
@@ -67,7 +67,8 @@ def execute(session, call: ToolCall) -> ToolOutcome:
67
67
  call.name, False, "the user declined this action. Ask what they would prefer."
68
68
  )
69
69
  else:
70
- ui.dim(f"↳ {call.name}({', '.join(f'{k}={v!r}' for k, v in args.items())[:120]})")
70
+ preview = ", ".join(f"{k}={v!r}" for k, v in args.items())[:120]
71
+ ui.console.print(f" [{ui.CYAN}]▸[/] [{ui.GRAY}]{call.name}({preview})[/]")
71
72
 
72
73
  try:
73
74
  output = _dispatch(session, tool, args)
@@ -122,7 +123,9 @@ def run_turn(session, user_text: str) -> Message | None:
122
123
  }
123
124
  )
124
125
  if not outcome.ok:
125
- ui.dim(f" {outcome.content.splitlines()[0][:120]}")
126
+ ui.console.print(
127
+ f" [{ui.AMBER}]▸[/] [{ui.GRAY}]{outcome.content.splitlines()[0][:120]}[/]"
128
+ )
126
129
 
127
130
  ui.warn(f"Stopped after {session.config.max_iterations} tool calls without a final answer.")
128
131
  ui.dim("Ask again with a narrower request, or /reset to start over.")
@@ -91,16 +91,19 @@ def render(reply: Message | None) -> None:
91
91
  return
92
92
  if reply.content.strip():
93
93
  ui.console.print()
94
- ui.console.print(Markdown(reply.content.strip()))
94
+ ui.console.print(ui.gutter(Markdown(reply.content.strip())))
95
95
  ui.console.print()
96
96
 
97
97
 
98
98
  def _print_banner(session: AgentSession) -> None:
99
99
  ui.section("devstuff agent")
100
- ui.dim(f"model {session.model}")
101
- ui.dim(f"host {session.client.host}")
102
- ui.dim(f"workspace {session.workspace.root}")
103
- ui.dim(f"tools {len(session.tools)} available")
100
+ for key, value in (
101
+ ("model", session.model),
102
+ ("host", session.client.host),
103
+ ("workspace", str(session.workspace.root)),
104
+ ("tools", f"{len(session.tools)} available"),
105
+ ):
106
+ ui.console.print(f" [{ui.PURPLE}]{key:<10}[/] [{ui.GRAY}]{value}[/]")
104
107
  if session.policy.yolo:
105
108
  ui.console.print()
106
109
  ui.warn("--yolo: mutating tools run without confirmation (the denylist still applies).")
@@ -121,7 +124,7 @@ def _print_slash_help() -> None:
121
124
 
122
125
  def _print_tools(session: AgentSession) -> None:
123
126
  for key, tool in sorted(session.tools.items()):
124
- marker = "[yellow]![/]" if tool.mutating else " "
127
+ marker = f"[{ui.AMBER}]![/]" if tool.mutating else " "
125
128
  ui.console.print(f" {marker} [bold cyan]{key:<18}[/] [dim]{tool.description[:70]}[/]")
126
129
  ui.console.print()
127
130
  ui.dim("! = mutating, asks for confirmation before running")
@@ -151,15 +154,15 @@ def _summarise(message: dict[str, Any]) -> str | None:
151
154
  if role == "system":
152
155
  return None
153
156
  if role == "user":
154
- return f"[bold]you[/] {str(message.get('content', ''))[:80]}"
157
+ return f"[{ui.PURPLE} bold]you[/] {str(message.get('content', ''))[:80]}"
155
158
  if role == "tool":
156
159
  first = str(message.get("content", "")).splitlines()[:1]
157
- return f"[dim]tool[/] {message.get('tool_name', '?')} → {(first[0] if first else '')[:60]}"
160
+ return f"[{ui.GRAY}]tool[/] {message.get('tool_name', '?')} → {(first[0] if first else '')[:60]}"
158
161
  calls = message.get("tool_calls") or []
159
162
  if calls:
160
163
  names = ", ".join(c["function"]["name"] for c in calls)
161
- return f"[cyan]agent[/] calls {names}"
162
- return f"[cyan]agent[/] {str(message.get('content', ''))[:80]}"
164
+ return f"[{ui.CYAN}]agent[/] calls {names}"
165
+ return f"[{ui.CYAN}]agent[/] {str(message.get('content', ''))[:80]}"
163
166
 
164
167
 
165
168
  def _print_history(session: AgentSession) -> None:
@@ -282,6 +285,22 @@ def _continuation(width: int, line_number: int, is_soft_wrap: bool) -> str:
282
285
  return " " * max(0, width - 2) + "› "
283
286
 
284
287
 
288
+ def _prompt_style():
289
+ """prompt_toolkit theme: violet prompt glyph, dark-violet completion menu."""
290
+ from prompt_toolkit.styles import Style as PTStyle
291
+
292
+ return PTStyle.from_dict({
293
+ "prompt": f"{ui.PURPLE} bold",
294
+ "completion-menu": "bg:#26223B #DDD6FE",
295
+ "completion-menu.completion": "bg:#26223B #DDD6FE",
296
+ "completion-menu.completion.current": f"bg:{ui.VIOLET} #FFFFFF bold",
297
+ "completion-menu.meta.completion": f"bg:#26223B {ui.GRAY}",
298
+ "completion-menu.meta.completion.current": "bg:#7C3AED #DDD6FE",
299
+ "scrollbar.background": "bg:#26223B",
300
+ "scrollbar.button": "bg:#4B4568",
301
+ })
302
+
303
+
285
304
  def build_prompt_session(session: AgentSession, **overrides):
286
305
  """Split out from run_repl so the input behaviour can be driven by tests with a
287
306
  pipe input rather than only exercised by hand."""
@@ -297,6 +316,7 @@ def build_prompt_session(session: AgentSession, **overrides):
297
316
  "multiline": True,
298
317
  "key_bindings": _key_bindings(),
299
318
  "prompt_continuation": _continuation,
319
+ "style": _prompt_style(),
300
320
  }
301
321
  kwargs.update(overrides)
302
322
  return PromptSession(**kwargs)
@@ -308,9 +328,11 @@ def run_repl(session: AgentSession) -> None:
308
328
 
309
329
  _print_banner(session)
310
330
 
331
+ from prompt_toolkit.formatted_text import HTML
332
+
311
333
  while True:
312
334
  try:
313
- line = prompt_session.prompt("you ❯ ").strip()
335
+ line = prompt_session.prompt(HTML("<prompt>you ❯</prompt> ")).strip()
314
336
  except KeyboardInterrupt:
315
337
  continue # Ctrl-C clears the current line, like a shell
316
338
  except EOFError:
@@ -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
 
@@ -124,11 +124,11 @@ def add_cmd() -> None:
124
124
  )
125
125
 
126
126
  ui.console.print()
127
- ui.console.print("[bold]Summary[/]")
127
+ ui.heading("Summary")
128
128
  for k, v in kwargs.items():
129
129
  if v:
130
130
  display = _truncate_script(v) if k.endswith("_script") else v
131
- ui.console.print(f" [dim]{k:<18}[/] {display}")
131
+ ui.console.print(f" [{ui.PURPLE}]{k:<18}[/] {display}")
132
132
  ui.console.print()
133
133
 
134
134
  if not ui.confirm("Save this package?"):
@@ -101,11 +101,14 @@ def _is_installed(key: str) -> bool:
101
101
 
102
102
  def _print_list() -> None:
103
103
  ui.console.print()
104
- ui.console.print(" [bold]CONFIGURABLE TOOLS[/]")
105
- width = max(len(s.key) for s in configure.CONFIGURATORS.values()) + 2
104
+ tbl = ui.table(title="[bold]configurable tools[/]")
105
+ tbl.add_column("", width=2, justify="center")
106
+ tbl.add_column("Tool", style="bold cyan", no_wrap=True)
107
+ tbl.add_column("Description", ratio=1)
106
108
  for spec in configure.CONFIGURATORS.values():
107
- mark = "[green]✔[/]" if _is_installed(spec.key) else "[dim]·[/]"
108
- ui.console.print(f" {mark} [bold cyan]{spec.key:<{width}}[/] {spec.description}")
109
+ mark = f"[{ui.GREEN}]●[/]" if _is_installed(spec.key) else f"[{ui.GRAY}]○[/]"
110
+ tbl.add_row(mark, spec.key, spec.description)
111
+ ui.console.print(tbl)
109
112
  ui.console.print()
110
113
  ui.dim(" devstuff configure <tool>")
111
114
  ui.console.print()
@@ -25,7 +25,7 @@ def docs_cmd(package: str) -> None:
25
25
  sys.exit(1)
26
26
 
27
27
  ui.console.print(f"\n [bold]{tool.name}[/] docs")
28
- ui.console.print(f" [cyan]{tool.docs_url}[/]\n")
28
+ ui.console.print(f" [cyan underline link={tool.docs_url}]{tool.docs_url}[/]\n")
29
29
 
30
30
  opened = webbrowser.open(tool.docs_url)
31
31
  if opened:
@@ -7,11 +7,12 @@ import click
7
7
  from dev_setup import doctor, ui
8
8
 
9
9
  _STATUS_ICON = {
10
- doctor.PASS: "[green bold]✔[/]",
11
- doctor.WARN: "[yellow bold]⚠[/]",
12
- doctor.FAIL: "[red bold]✖[/]",
10
+ doctor.PASS: f"[{ui.GREEN} bold]✔[/]",
11
+ doctor.WARN: f"[{ui.AMBER} bold]⚠[/]",
12
+ doctor.FAIL: f"[{ui.RED} bold]✖[/]",
13
13
  }
14
- _STATUS_LABEL = {doctor.PASS: "pass", doctor.WARN: "warn", doctor.FAIL: "FAIL"}
14
+ # pass needs no text label — the icon carries it. warn/fail get one for scanability.
15
+ _STATUS_LABEL = {doctor.WARN: ui.AMBER, doctor.FAIL: ui.RED}
15
16
 
16
17
 
17
18
  @click.command("doctor")
@@ -32,8 +33,11 @@ def doctor_cmd(auto_fix: bool, check_only: bool) -> None:
32
33
  fixable: list[doctor.CheckResult] = []
33
34
  for r in results:
34
35
  icon = _STATUS_ICON.get(r.status, "[dim]?[/]")
35
- label = _STATUS_LABEL.get(r.status, r.status)
36
- ui.console.print(f" {icon} [bold]{r.name}[/] [dim]({label})[/] {r.message}")
36
+ line = f" {icon} [bold]{r.name}[/] {r.message}"
37
+ color = _STATUS_LABEL.get(r.status)
38
+ if color:
39
+ line += f" [{color} bold]{r.status.upper()}[/]"
40
+ ui.console.print(line)
37
41
  if r.detail:
38
42
  ui.dim(f" {r.detail}")
39
43
  if r.status != doctor.PASS and r.fix is not None:
@@ -42,9 +46,19 @@ def doctor_cmd(auto_fix: bool, check_only: bool) -> None:
42
46
  passed = sum(1 for r in results if r.status == doctor.PASS)
43
47
  warned = sum(1 for r in results if r.status == doctor.WARN)
44
48
  failed = sum(1 for r in results if r.status == doctor.FAIL)
49
+
50
+ def _count(n: int, color: str, word: str) -> str:
51
+ style = color if n else ui.GRAY
52
+ return f"[{style}]{n} {word}[/]"
53
+
45
54
  ui.console.print()
46
55
  ui.console.print(
47
- f" [dim]{passed} passed, {warned} warning(s), {failed} failure(s)[/]"
56
+ " "
57
+ + " · ".join([
58
+ _count(passed, ui.GREEN, "passed"),
59
+ _count(warned, ui.AMBER, "warnings"),
60
+ _count(failed, ui.RED, "failed"),
61
+ ])
48
62
  )
49
63
 
50
64
  if check_only or not fixable:
@@ -26,17 +26,21 @@ def list_cmd() -> None:
26
26
  for f in fns:
27
27
  by_cat.setdefault(f.category, []).append(f)
28
28
 
29
- key_width = max((len(f.key) for f in fns), default=12) + 2
30
29
  for cat in sorted(by_cat, key=lambda c: (c == "custom", c)):
31
- ui.console.print(f"\n [bold]{cat.upper()}[/]")
32
- for f in sorted(by_cat[cat], key=lambda f: f.key):
30
+ entries = sorted(by_cat[cat], key=lambda f: f.key)
31
+ tbl = ui.table(
32
+ title=f"[bold]{cat}[/] [{ui.GRAY}]{len(entries)} function(s)[/]"
33
+ )
34
+ tbl.add_column("Function", style="bold cyan", no_wrap=True)
35
+ tbl.add_column("Type", style=ui.CYAN, no_wrap=True)
36
+ tbl.add_column("Args", style=ui.GRAY, no_wrap=True)
37
+ tbl.add_column("Description", ratio=1)
38
+ for f in entries:
33
39
  mode = f.type if f.type == "script" else f"{f.type} ({f.register})"
34
- ui.console.print(
35
- f" [bold cyan]{f.key:<{key_width}}[/] [dim]{mode:<22}[/] {f.description}"
36
- )
37
40
  params = " ".join(f"<{p.name}>" for p in f.params)
38
- if params:
39
- ui.dim(f" args: {params}")
41
+ tbl.add_row(f.key, mode, params, f.description)
42
+ ui.console.print(tbl)
43
+ ui.console.print()
40
44
 
41
45
 
42
46
  @functions_cmd.command("enable")
@@ -1,6 +1,18 @@
1
+ from rich.columns import Columns
2
+ from rich.text import Text
3
+
1
4
  from dev_setup import ui
2
5
  from dev_setup.catalog import USER_CATALOG_PATH
3
6
 
7
+ _CATEGORY_DESC = {
8
+ "core": "Always-installed tools (Docker, NVM, uv)",
9
+ "tools": "Optional utilities (lazygit, htop, bat)",
10
+ "ai-tools": "AI coding agents and assistants",
11
+ "customization": "Prompt and shell customization",
12
+ "languages": "Programming language runtimes",
13
+ "custom": "User-added packages",
14
+ }
15
+
4
16
 
5
17
  def print_help() -> None:
6
18
  ui.print_banner()
@@ -21,14 +33,20 @@ def print_help() -> None:
21
33
  ("docs", "<package>", "Open documentation in browser"),
22
34
  ("run", "<function> [args...]", "Run a function/script"),
23
35
  ("functions", "<list|enable|disable|path>", "Manage functions/scripts"),
36
+ ("links", "[list|search|open|path]", "Browse, search, and open tool links"),
24
37
  ("skills", "add", "Append GitHub skills to claude/codex/pi"),
25
38
  ("agent", "[--setup] [--dir] [--model]", "Chat with a local tool-using model"),
26
39
  ("version", "", "Show version"),
27
40
  ]
41
+ tbl = ui.table(bordered=False, show_header=False)
42
+ tbl.add_column("cmd", style="bold cyan", no_wrap=True)
43
+ tbl.add_column("args", style=ui.GRAY, no_wrap=True)
44
+ tbl.add_column("desc", ratio=1)
28
45
  for cmd, args, desc in rows:
29
- ui.console.print(
30
- f" [bold cyan]{cmd:<10}[/] [dim]{args:<40}[/] {desc}"
31
- )
46
+ # args goes in as Text: strings like "[category]" are valid Rich markup
47
+ # tags and would be silently swallowed from a plain str cell.
48
+ tbl.add_row(f" {cmd}", Text(args), desc)
49
+ ui.console.print(tbl)
32
50
 
33
51
  ui.console.print()
34
52
  ui.console.print("[bold]EXAMPLES[/]")
@@ -50,20 +68,31 @@ def print_help() -> None:
50
68
  "devstuff catalog export",
51
69
  "devstuff functions list",
52
70
  "devstuff functions enable ssh-agent-key",
71
+ "devstuff links search docker",
72
+ "devstuff links open uv-docs",
53
73
  "devstuff agent",
54
74
  "devstuff agent --setup",
55
75
  'devstuff agent --print "what node tools are available?"',
56
76
  "ssh-agent-key ~/.ssh/id_ed25519",
57
77
  ]
58
- for ex in examples:
59
- ui.console.print(f" [dim]$[/] [green]{ex}[/]")
78
+ items = [
79
+ Text.assemble((" $ ", ui.GRAY), (ex, "green")) for ex in examples
80
+ ]
81
+ ui.console.print(Columns(items, column_first=True, padding=(0, 3)))
82
+
83
+ from dev_setup import registry
60
84
 
61
85
  ui.console.print()
62
86
  ui.console.print("[bold]CATEGORIES[/]")
63
- ui.console.print(" [cyan]core[/] Always-installed tools (Docker, NVM, uv)")
64
- ui.console.print(" [cyan]tools[/] Optional utilities (PHP, Starship, htop)")
65
- ui.console.print(" [cyan]languages[/] Programming language runtimes")
66
- ui.console.print(" [cyan]custom[/] User-added packages\n")
87
+ _ORDER = {"core": 0, "tools": 1, "custom": 999}
88
+ cats = sorted(
89
+ {t.category for t in registry.all_tools()},
90
+ key=lambda c: (_ORDER.get(c, 500), c),
91
+ )
92
+ for cat in cats:
93
+ desc = _CATEGORY_DESC.get(cat, "")
94
+ ui.console.print(f" [cyan]{cat:<14}[/] [{ui.GRAY}]{desc}[/]")
67
95
 
96
+ ui.console.print()
68
97
  ui.console.print("[bold]CONFIG[/]")
69
- ui.console.print(f" User catalog: [dim]{USER_CATALOG_PATH}[/]\n")
98
+ ui.console.print(f" User catalog: [{ui.GRAY}]{USER_CATALOG_PATH}[/]\n")
@@ -106,7 +106,7 @@ def _install_interactive() -> None:
106
106
  else:
107
107
  disabled = None
108
108
  title = [
109
- ("class:check", "✔ " if is_inst else " "),
109
+ ("class:check", "● " if is_inst else " "),
110
110
  ("class:text", f"{t.key:<{key_width}}{desc}"),
111
111
  ]
112
112
  choices.append(questionary.Choice(