Imported from yunaamelia/vps-rdp-workstation (roles/ai-devtools/AGENTS.md). Install upstream with npx skills add yunaamelia/vps-rdp-workstation --skill ai-devtools. Copyright stays with the author.

ROLE: ai-devtools

Purpose: AI-assisted development tools for code generation and CLI enhancements. Phase: 14-15

TASKS

main.yml: Installs aider and shell-gpt from pip, configures API keys via environment.
uninstall.yml: Removes aider and shell-gpt packages, cleans pip cache.

VARIABLES

vps_ai_devtools_install: Boolean to enable/disable installation (default: true).
vps_ai_devtools_aider_install: Install aider CLI for AI pair programming (default: true).
vps_ai_devtools_shell_gpt_install: Install shell-gpt for bash/zsh assistance (default: true).
vps_ai_devtools_api_key: OpenAI or provider API key (from env or secrets file).

DEPENDENCIES

development (Python pip must be available)
Common (for base system packages)

ANTI-PATTERNS

Hardcoding API keys in playbooks — always use environment variables or vault.
Installing without checking if pip/python3 is available.
Not documenting that users must set API_KEY environment variable for functionality.

Root Guidelines

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install ai-devtools and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

ai-devtools

About

ROLE: ai-devtools

TASKS

VARIABLES

DEPENDENCIES

ANTI-PATTERNS

Use it

Install ai-devtools and it becomes one more candidate the router can pick - when it fits.

Manifest

Reviews