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.
- {devstuff-2.7.0 → devstuff-2.9.0}/CHANGELOG.md +12 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/CLAUDE.md +14 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/PKG-INFO +43 -2
- {devstuff-2.7.0 → devstuff-2.9.0}/README.md +42 -1
- {devstuff-2.7.0 → devstuff-2.9.0}/pyproject.toml +1 -1
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/approval.py +6 -6
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/loop.py +5 -2
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/session.py +33 -11
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/cli.py +3 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/add_cmd.py +2 -2
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/configure_cmd.py +7 -4
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/docs_cmd.py +1 -1
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/doctor_cmd.py +21 -7
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/functions_cmd.py +12 -8
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/help_cmd.py +39 -10
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/install_cmd.py +1 -1
- devstuff-2.9.0/src/dev_setup/commands/links_cmd.py +141 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/list_cmd.py +17 -16
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/doctor.py +26 -0
- devstuff-2.9.0/src/dev_setup/links.schema.json +50 -0
- devstuff-2.9.0/src/dev_setup/links.yaml +116 -0
- devstuff-2.9.0/src/dev_setup/links_catalog.py +138 -0
- devstuff-2.9.0/src/dev_setup/links_registry.py +86 -0
- devstuff-2.9.0/src/dev_setup/ui.py +223 -0
- devstuff-2.9.0/tests/test_links.py +171 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/uv.lock +1 -1
- devstuff-2.7.0/src/dev_setup/ui.py +0 -128
- {devstuff-2.7.0 → devstuff-2.9.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.claude/skills/run-stuff/smoke.sh +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/codex/review.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.github/workflows/test-installs.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/.gitignore +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/dev/Dockerfile +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/dev/Makefile +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/devstuff +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/github-agent.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/README.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/install.sh +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/bridges.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent_tools.schema.json +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/agent_tools.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/generic.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/tools.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/integration/test_tools.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_lazygit.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_doctor.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_functions.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_generic.py +0 -0
- {devstuff-2.7.0 → devstuff-2.9.0}/tests/test_registry.py +0 -0
- {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.
|
|
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
|
-
|
|
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
|
-
|
|
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` |
|
|
@@ -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=
|
|
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=
|
|
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=
|
|
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=
|
|
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=
|
|
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=
|
|
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
|
-
|
|
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.
|
|
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
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
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 = "[
|
|
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[/]
|
|
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"[
|
|
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"[
|
|
162
|
-
return f"[
|
|
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
|
|
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.
|
|
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" [
|
|
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.
|
|
105
|
-
width =
|
|
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 = "[
|
|
108
|
-
|
|
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: "[
|
|
11
|
-
doctor.WARN: "[
|
|
12
|
-
doctor.FAIL: "[
|
|
10
|
+
doctor.PASS: f"[{ui.GREEN} bold]✔[/]",
|
|
11
|
+
doctor.WARN: f"[{ui.AMBER} bold]⚠[/]",
|
|
12
|
+
doctor.FAIL: f"[{ui.RED} bold]✖[/]",
|
|
13
13
|
}
|
|
14
|
-
|
|
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
|
-
|
|
36
|
-
|
|
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
|
-
|
|
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
|
-
|
|
32
|
-
|
|
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
|
-
|
|
39
|
-
|
|
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
|
-
|
|
30
|
-
|
|
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
|
-
|
|
59
|
-
|
|
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
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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: [
|
|
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", "
|
|
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(
|