Running runegraft with no args drops you into a shell that feels like a real tool, not a demo prompt.
Why use the shell?
- Tab + fuzzy completion for commands, subcommands, and options.
- Persistent history so your shortcuts stick between sessions.
- Built-ins you expect:
help, exit, history, alias, source, cd, pwd, and ! for running system commands.
- Scripts via
source to automate repetitive workflows.
Typical session
Aliases are great for long option sets. Pair them with source ./team-setup.rg to script team defaults.
Making your shell the default
If you want runegraft to open the shell when no arguments are provided, wire your root handler to return cli.shell():
Troubleshooting commands
Use history show to replay recent commands, and tap ! to run system commands without leaving the REPL. The shell echoes validation errors with the same helpful formatting as one-shot mode, so you can iterate quickly. 
