Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 17 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,44 @@
# rules
# 📋 rules

> **tl;dr:** `npm i -g rules-cli` then `rules add starter/nextjs-rules`
> **tl;dr:** `npm i -g rules-cli` then `rules add starter/nextjs-rules`

`rules` is a CLI built for managing rules across any AI developer tool. Rules are markdown files that encode workflows, preferences, tech stack details, and more in plain natural language so you can get better help from LLMs.
`rules` is a CLI built for managing rules across any AI developer tool. Rules are markdown files that encode workflows, preferences, tech stack details, and more in plain natural language so you can get better help from LLMs. 🤖✨

## Install `rules`
## 📦 Install `rules`

The `rules` CLI can be installed using NPM:

```bash
npm i -g rules-cli
```

## Add rules
## Add rules

To download rules to your repository you can use `rules add`. For example:

```bash
rules add starter/nextjs-rules
```

This will add them to your project in a local `.rules` folder.
This will add them to your project in a local `.rules` folder. 📁

You can also download from GitHub rather than the rules registry:
You can also download from GitHub rather than the rules registry: 🐙

```bash
rules add gh:continuedev/rules-template
```

## Render rules
## 🎨 Render rules

To use rules with your AI code assistant of choice, you can "render" them to the necessary format and location using `rules render`. For example,

```bash
rules render cursor
```

will copy all of the `.rules/` into a `.cursor/rules/` folder. `rules` currently supports the following formats: cursor, continue, windsurf, claude, copilot, codex, cline, cody, and amp.
will copy all of the `.rules/` into a `.cursor/rules/` folder. `rules` currently supports the following formats: cursor, continue, windsurf, claude, copilot, codex, cline, cody, and amp. 🔧

## Publish rules
## 🚀 Publish rules

To make your rules available to others, you can publish using `rules publish`:

Expand All @@ -47,14 +47,14 @@ rules login
rules publish
```

This would make your rule available to download with `rules add <name-of-rules>`.
This would make your rule available to download with `rules add <name-of-rules>`. 📤

The command automatically determines the slug from your `rules.json` file. To make sure you have a `rules.json` file in your current directory, use `rules init`.
The command automatically determines the slug from your `rules.json` file. To make sure you have a `rules.json` file in your current directory, use `rules init`. ⚙️

## Helping users use your rules
## 🤝 Helping users use your rules

If you are building a developer tool and want to optimize how AI IDEs work with your tool, `rules` makes it easy to give your users the best experience.
If you are building a developer tool and want to optimize how AI IDEs work with your tool, `rules` makes it easy to give your users the best experience. 💫

1. Make your account on the [registry](https://hub.continue.dev/signup) and create an organization
2. [Publish your rules](index.md#publish-rules)
3. Mention the corresponding `rules add <name-of-rules>` command in your documentation
1. 🔐 Make your account on the [registry](https://hub.continue.dev/signup) and create an organization
2. 📢 [Publish your rules](index.md#publish-rules)
3. 📝 Mention the corresponding `rules add <name-of-rules>` command in your documentation