-
Notifications
You must be signed in to change notification settings - Fork 8
feat: establish /cmd convention for all rpg-specific commands #754
Copy link
Copy link
Closed
Labels
enhancementNew feature or requestNew feature or request
Description
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:
- Any diagnostics commands (
\dbaetc.) — check if psql has them; if not, rename to/ \ash(issue feat: TUI Active Session History (/ash command) #753) →/ash(already rpg-specific, not in psql)
Code changes
- Update command dispatch in
src/repl/mod.rsfor any renamed commands - Update help text (
\?output and any/helpequivalent) - 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=rpgstill works (no\commands broken) - Convention documented for contributors (CLAUDE.md or COMMANDS.md)
- README examples updated
- GIFs / screenshots re-recorded via tmux pipeline
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request