AI Resource Manager (ARM)

What is ARM?

ARM is a dependency manager for AI packages, designed to treat them as code dependencies. You can install packages as rulesets, promptsets, or other resource types. ARM introduces semantic versioning, reproducible installs, and straightforward distribution to your AI tools.

Seamlessly connect to Git repositories such as awesome-cursorrules or your team's private collections. Install and manage versioned AI resources across projects, and keep everything in sync with your source of truth.

Why ARM?

Managing AI resources for coding assistants is cumbersome:

Manual duplication: Copying resources disconnects them from updates and the original source
Hidden breaking changes: Updates may unexpectedly alter your AI's behavior
Poor scalability: Coordinating AI resources across multiple projects becomes chaotic
Incompatible formats: Frequent manual conversions between different tool formats. (Obligatory we need a new standard xkcd link)

ARM solves these problems with a modern dependency manager approach.

Key Features of ARM

Consistent, versioned installs using semantic versioning (except for git based registry without semver tags, which gets a little funky)
Reliable, reproducible environments through manifest and lock files (similar to npm's package.json and package-lock.json)
Backwards compatibility with existing repositories like awesome-cursorrules - use them immediately without conversion
Write once, deploy everywhere - compile ARM resource schemas to any tool format (Cursor, Copilot, Amazon Q, Markdown)
Priority-based rule composition for layering multiple rulesets with clear conflict resolution (your team's standards > internet best practices)
Flexible registry support for managing AI resources from Git, GitLab, and Cloudsmith
Automated update workflow: easily check for updates and apply them across projects (nice)

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/jomadu/ai-resource-manager/main/scripts/install.sh | bash

Install Specific Version

curl -fsSL https://raw.githubusercontent.com/jomadu/ai-resource-manager/main/scripts/install.sh | bash -s v1.0.0

Manual Installation

Download the latest release from GitHub
Extract and move the binary to your PATH
Run arm help to verify installation

Verify Installation

arm version
arm help

Upgrading from v2? See the migration guide for breaking changes and upgrade steps. TL;DR: Sorry, nuke and pave. We made some poor design choices in v1 and v2. Honestly, we've probably made them in v3 too, but hey, better is the enemy of good.

Uninstall

curl -fsSL https://raw.githubusercontent.com/jomadu/ai-resource-manager/main/scripts/uninstall.sh | bash

Quick Start

Resource Types

Packages can be installed as:

Rulesets - Collections of AI rules with priority-based conflict resolution
Promptsets - Collections of AI prompts for reusable templates

Setup

Add Git registry:

arm add registry git --url https://github.com/jomadu/ai-rules-manager-sample-git-registry ai-rules

Add GitLab registry:

arm add registry gitlab --url https://gitlab.example.com --project-id 123 my-gitlab

Add Cloudsmith registry:

arm add registry cloudsmith --owner myorg --repo ai-rules my-cloudsmith

Configure sinks (output destinations):

# Cursor
arm add sink --tool cursor cursor-rules .cursor/rules
arm add sink --tool cursor cursor-commands .cursor/commands
GitHub Copilot
arm add sink --tool copilot copilot-rules .github/copilot
Amazon Q
arm add sink --tool amazonq q-rules .amazonq/rules
Kiro CLI
arm add sink --tool kiro kiro-steering .kiro/steering
arm add sink --tool kiro kiro-prompts .kiro/prompts

Install ruleset:

arm install ruleset ai-rules/clean-code-ruleset cursor-rules

Install promptset:

arm install promptset ai-rules/code-review-promptset cursor-commands

Install to multiple tools:

arm install ruleset ai-rules/clean-code-ruleset cursor-rules copilot-rules q-rules

Install with priority (higher priority rules take precedence):

# Install team rules with high priority arm install ruleset --priority 200 ai-rules/team-standards cursor-rules
Install general rules with default priority (100)
arm install ruleset ai-rules/clean-code-ruleset cursor-rules

Install specific files from a ruleset (useful for git-based registries):

# Only install TypeScript-related rules arm install ruleset --include "*/typescript-.yml" ai-rules/language-rules cursor-rules
Install security rules but exclude experimental ones
arm install ruleset --include "security//.yml" --exclude "/experimental/*" ai-rules/security-ruleset cursor-rules
Install only specific prompt files
arm install promptset --include "review//.yml" --include "refactor//.yml" ai-rules/code-review-promptset cursor-commands

Compile local ARM resource files to tool-specific formats:

# Compile a single ruleset file arm compile ruleset my-rules.yml --tool cursor --output .cursor/rules/
Compile all YAML files in a directory
arm compile ruleset ./rules/ --tool copilot --output .github/copilot/ --recursive
Compile with namespace for organization
arm compile ruleset ./rules/ --tool cursor --output .cursor/rules/ --namespace my-team