AI Resource Manager
Manage AI resources via aimgr. Resources live in ~/.local/share/ai-config/repo/ and are symlinked to projects.
⚠️ Safety Rules
Ask user approval before ANY mutating command. Read-only commands are safe.
| Mutating (ask first) |
Read-only (safe) |
install, uninstall, init, repair, clean |
list, verify |
repo add, repo sync, repo remove, repo apply-manifest |
repo list, repo describe, repo info, repo show-manifest |
repo repair, repo rebuild, repo drop, repo prune |
repo verify, repo add --dry-run |
Use Cases
UC1 — Install / Uninstall: Install, verify, repair resources in a project. Covers install, uninstall, list, verify, repair, clean, init, ai.package.yaml.
→ references/install-uninstall.md
Project repair/cleanup semantics to follow in guidance:
aimgr clean empties owned resource directories (no confirmation flags)aimgr repair reconciles owned directories to ai.package.yamlaimgr clean && aimgr repair replaces old repair --reset --force workflowsrepair --dry-run previews actions; --prune-package is separate manifest cleanup- Declared resources removed manually are reinstalled on
repair until manifest is updated
UC2 — Manage Repository: Add sources, inspect or apply ai.repo.yaml, sync, remove, validate, maintain the global repo. Covers all repo subcommands.
→ references/manage-repository.md
UC3 — Discover & Recommend: Scan project context, match against available resources, recommend relevant ones.
→ references/discover-resources.md
Troubleshooting
| Issue |
Fix |
| Skills not loading |
Restart AI tool |
aimgr not found |
mise use -g github:dynatrace-oss/ai-config-manager or go install github.com/dynatrace-oss/ai-config-manager/v3/cmd/aimgr@latest |
| Resource not found |
aimgr repo sync |
| Broken symlinks |
aimgr repair or aimgr repo repair |
Details in install-uninstall.md and manage-repository.md.
Resources
📚 Run aimgr [command] --help for command syntax.
| Tool |
Skills |
Commands |
Agents |
| Claude Code |
✅ |
✅ |
✅ |
| OpenCode |
✅ |
✅ |
✅ |
| GitHub Copilot |
✅ |
❌ |
❌ |
| Windsurf |
✅ |
❌ |
❌ |
1---2name: ai-resource-manager3description: Manage AI resources (skills, commands, agents) using aimgr CLI. Use when user asks to: (1) Install/uninstall resources, (2) Manage repository, (3) Discover/recommend resources for a project, (4) Troubleshoot aimgr issues.4---56# AI Resource Manager78Manage AI resources via `aimgr`. Resources live in `~/.local/share/ai-config/repo/` and are symlinked to projects.910## ⚠️ Safety Rules1112**Ask user approval before ANY mutating command.** Read-only commands are safe.1314| Mutating (ask first) | Read-only (safe) |15|---|---|16| `install`, `uninstall`, `init`, `repair`, `clean` | `list`, `verify` |17| `repo add`, `repo sync`, `repo remove`, `repo apply-manifest` | `repo list`, `repo describe`, `repo info`, `repo show-manifest` |18| `repo repair`, `repo rebuild`, `repo drop`, `repo prune` | `repo verify`, `repo add --dry-run` |1920## Use Cases2122**UC1 — Install / Uninstall:** Install, verify, repair resources in a project. Covers `install`, `uninstall`, `list`, `verify`, `repair`, `clean`, `init`, `ai.package.yaml`.23→ [references/install-uninstall.md](references/install-uninstall.md)2425Project repair/cleanup semantics to follow in guidance:2627- `aimgr clean` empties owned resource directories (no confirmation flags)28- `aimgr repair` reconciles owned directories to `ai.package.yaml`29- `aimgr clean && aimgr repair` replaces old `repair --reset --force` workflows30- `repair --dry-run` previews actions; `--prune-package` is separate manifest cleanup31- Declared resources removed manually are reinstalled on `repair` until manifest is updated3233**UC2 — Manage Repository:** Add sources, inspect or apply `ai.repo.yaml`, sync, remove, validate, maintain the global repo. Covers all `repo` subcommands.34→ [references/manage-repository.md](references/manage-repository.md)3536**UC3 — Discover & Recommend:** Scan project context, match against available resources, recommend relevant ones.37→ [references/discover-resources.md](references/discover-resources.md)3839## Troubleshooting4041| Issue | Fix |42|-------|-----|43| Skills not loading | Restart AI tool |44| `aimgr` not found | `mise use -g github:dynatrace-oss/ai-config-manager` or `go install github.com/dynatrace-oss/ai-config-manager/v3/cmd/aimgr@latest` |45| Resource not found | `aimgr repo sync` |46| Broken symlinks | `aimgr repair` or `aimgr repo repair` |4748Details in [install-uninstall.md](references/install-uninstall.md) and [manage-repository.md](references/manage-repository.md).4950## Resources5152📚 Run `aimgr [command] --help` for command syntax.5354| Tool | Skills | Commands | Agents |55|------|--------|----------|--------|56| Claude Code | ✅ | ✅ | ✅ |57| OpenCode | ✅ | ✅ | ✅ |58| GitHub Copilot | ✅ | ❌ | ❌ |59| Windsurf | ✅ | ❌ | ❌ |6061- Repo: <https://github.com/dynatrace-oss/ai-config-manager>62- Issues: <https://github.com/dynatrace-oss/ai-config-manager/issues>
dynatrace-oss