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.
- {devstuff-2.7.0 → devstuff-2.8.0}/CHANGELOG.md +6 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/CLAUDE.md +14 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/PKG-INFO +42 -1
- {devstuff-2.7.0 → devstuff-2.8.0}/README.md +41 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/pyproject.toml +1 -1
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/cli.py +3 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/help_cmd.py +3 -0
- devstuff-2.8.0/src/dev_setup/commands/links_cmd.py +141 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/doctor.py +26 -0
- devstuff-2.8.0/src/dev_setup/links.schema.json +50 -0
- devstuff-2.8.0/src/dev_setup/links.yaml +116 -0
- devstuff-2.8.0/src/dev_setup/links_catalog.py +138 -0
- devstuff-2.8.0/src/dev_setup/links_registry.py +86 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/ui.py +16 -3
- devstuff-2.8.0/tests/test_links.py +171 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/uv.lock +1 -1
- {devstuff-2.7.0 → devstuff-2.8.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.claude/skills/run-stuff/smoke.sh +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/codex/review.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.github/workflows/test-installs.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/.gitignore +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/dev/Dockerfile +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/dev/Makefile +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/devstuff +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/github-agent.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/README.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/install.sh +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/approval.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/bridges.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/loop.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/session.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent_tools.schema.json +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/agent_tools.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/add_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/configure_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/docs_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/functions_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/install_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/list_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/generic.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/tools.yaml +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/integration/test_tools.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_catalog.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_lazygit.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_doctor.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_functions.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_generic.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_registry.py +0 -0
- {devstuff-2.7.0 → devstuff-2.8.0}/tests/test_verbose.py +0 -0
|
@@ -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.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` |
|
|
@@ -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
|