Global Mode

You can use global mode via Rulesync by enabling --global option. It can also be called as user scope mode.

Currently, supports rules generation for Claude Code, GitHub Copilot, and OpenCode. Import for global files is supported for rules and commands. Command generation in global mode remains Claude Code only.

Create an any name directory. For example, if you prefer ~/.aiglobal, run the following command.
bash
```
mkdir -p ~/.aiglobal
```
Initialize files for global files in the directory.
bash
```
cd ~/.aiglobal
rulesync init
```
Edit ~/.aiglobal/rulesync.jsonc to enable global mode.
jsonc
```
{
  "global": true,
}
```
Edit ~/.aiglobal/.rulesync/rules/overview.md to your preferences.
md
```
---
root: true
---

# The Project Overview

...
```

Generate rules for global settings.

bash

# Run in the `~/.aiglobal` directory
rulesync generate

NOTE

Currently, when in the directory enabled global mode:

rulesync.jsonc only supports global, features, delete and verbose. Features can be set "rules" and "commands". Other parameters are ignored.
Multiple root: true files can target the same tool in project and global modes. Compatible root or plain-Markdown single-file outputs are combined with a blank line between files. Local rules are composed first in lexicographic source file path order, followed by non-overridden .curated/ rules in lexicographic order, so filename prefixes control composition order within each set. Distinct native paths remain separate. Explicitly supported plain-Markdown modular path collisions are combined (fragments whose generated output carries its own frontmatter block stay separate), unsafe collisions involving a source root rule fail, and other exact or case-insensitive modular collisions warn that the last write wins wherever their paths collide.
Only Claude Code is supported for global mode commands.

Global Mode ​

Global Mode