RightNow Agent loads Markdown instructions that describe a project's conventions, build commands, architecture, and safety constraints. Rules are added to the session context and apply throughout their directory tree.
Within each directory, RightNow checks these names in order and loads every matching file:
| Agents.md | Claude.md | CLAUDE.md |
| CLAUDE.local.md | AGENT.md | AGENTS.md |
On case-insensitive filesystems, names that resolve to the same file are deduplicated. Top-level Claude-compatible names remain recognized even when machine-wide Claude imports are disabled.
my-repo/
AGENTS.md
src/
AGENTS.md
components/
AGENTS.mdStarting in src/components loads all three files. The components rule has the final word on conflicts because it is deepest.
Use --rules, also available as --append-system-prompt, to add temporary instructions without editing a file.
.\rightnow.ps1 --rules "Always use TypeScript. Prefer functional components."RightNow wraps this text in <human_rules> and appends it to the default system prompt. A system prompt override replaces the default prompt and skips appended rules instead.
Prefer the canonical .rightnow/ project paths. RightNow reads them first and still honors existing .grok/ paths where the guide defines a fallback.
| Preferred path | Legacy behavior |
|---|---|
| .rightnow/config.toml | Reads .grok/config.toml when the corresponding preferred file is absent. |
| .rightnow/skills/ | Reads .grok/skills/ as a fallback. |
| .rightnow/plugins/ | Reads .grok/plugins/ as a fallback. |
| .rightnow/hooks/ | Reads .grok/hooks/ as a fallback. |
| .grok/rules/*.md | Remains an always-scanned project rules directory. |
The shipped profile sets machine-wide Claude and Cursor rule and agent imports to off. Native RightNow rules and recognized top-level project files such as CLAUDE.md still work.
Use the inspect subcommand to list discovered project instructions with their paths and approximate token counts.
rightnow-pager.exe inspect
rightnow-pager.exe inspect --json