@karedo-hq/agents

Centralized agent skills, rules, and commands for our engineering team. Install shared configurations for AI-powered IDEs like Cursor, Claude Code, and more.

Installation

# Using pnpm
pnpm dlx @karedo-hq/agents install --target cursor

# Or install globally
pnpm add -g @karedo-hq/agents
agents install --target cursor

Usage

Install Configurations

Install agent configurations to your current project:

agents install --target <ide>

Options:

• -t, --target <ide> - Target IDE (required). Currently supported: cursor
• -f, --force - Overwrite existing files without prompting

Examples:

# Install Cursor configurations
agents install --target cursor

# Force overwrite existing files
agents install --target cursor --force

Updating

When rules or commands are updated, developers can get the latest version:

# Get latest from npm
pnpm dlx @karedo-hq/agents@latest install --target cursor --force

# Or directly from GitHub (always pulls latest main)
pnpm dlx github:karedo-hq/agents install --target cursor --force

The --force flag overwrites existing files with the new versions.

Supported Targets

| Target | Description | Output Directory | | -------- | ---------------------------------------- | ---------------- | | cursor | Cursor IDE rules and commands | .cursor/ |

What Gets Installed

Rules

Rules provide guidelines and best practices for your codebase:

• TypeScript - General TypeScript coding standards
• API (Backend)
  • Controllers, DTOs, Services
  • MongoDB schemas, NestJS patterns
  • Email templates, Tiptap templates
• Web (Frontend)
  • Next.js guidelines, API layer patterns
  • Page creation, table implementation
  • Responsive dialog/drawer patterns

Commands

Commands are reusable workflows for common tasks:

• commit - Commit current work with conventional commits
• create-pr - Create a pull request with proper formatting
• deslop - Remove AI-generated code slop
• release - Automate the release process

Development

# Install dependencies
pnpm install

# Build
pnpm build

# Watch mode
pnpm dev

# Type check
pnpm typecheck

Adding New Rules or Commands

1. Add your rule file to rules/ (use .mdc extension for Cursor compatibility)
2. Add your command file to commands/ (use .md extension)
3. Bump version in package.json
4. Commit and push to GitHub
5. Publish: pnpm publish --access public

Adding New IDE Targets

1. Create a new handler in src/targets/<ide-name>.ts
2. Register it in src/targets/index.ts
3. Implement the install function that maps rules/ and commands/ to the IDE's expected location

License

MIT