Skip to content

feat: establish /cmd convention for all rpg-specific commands #754

@NikolayS

Description

@NikolayS

Summary

Establish a clear command namespace convention:

  • \ = psql-compatible commands only (anything psql has: \d, \l, \dt, \copy, \s, etc.)
  • / = everything rpg adds on top (AI, monitoring, diagnostics, all rpg-specific extensions)

Motivation

The current split is ambiguous — some rpg-specific commands use \ which blurs the boundary. The new convention makes it immediately clear to users:

"If psql has it, it's \. If it's rpg-specific, it's /."

This also keeps alias psql=rpg working perfectly since psql users only type \ commands.

Changes required

Command renames

Audit all rpg-specific commands and move any that aren't in psql to the / namespace. Known cases:

Code changes

  • Update command dispatch in src/repl/mod.rs for any renamed commands
  • Update help text (\? output and any /help equivalent)
  • Update CHANGELOG
  • Update README if commands are documented there

Documentation & assets

  • Add a note in CLAUDE.md or a COMMANDS.md explaining the convention so it's enforced going forward
  • Update all examples in README.md that reference renamed commands
  • Re-record any GIFs/screenshots that show old command names (recording is automated via tmux pipeline)
  • Update any inline code comments referencing renamed commands

Acceptance criteria

  • All rpg-specific commands use / prefix
  • All psql-compatible commands keep \ prefix
  • Help text reflects the new convention
  • alias psql=rpg still works (no \ commands broken)
  • Convention documented for contributors (CLAUDE.md or COMMANDS.md)
  • README examples updated
  • GIFs / screenshots re-recorded via tmux pipeline

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions