Refactor command ideas by consolidating basic commands, structuring configuration, and introducing advanced safety and Git integration features.

IDEAS.md

@@ -1,85 +1,81 @@
 # Command Ideas for AnchorCli
 
-## Basic Commands
+## Session & Help
 
 ### `/help`
-Display a list of available commands and their descriptions.
+Show available commands, version info, and tool capabilities. Combines `/help`, `/version`, `/about`, and `/tools`.
 
 ### `/clear`
-Clear the terminal screen.
+Clear the terminal screen and optionally reset conversation with `/clear --reset`.
 
 ### `/history`
-Show the current chat history.
+Show the current chat history. Use `/history <n>` to show last N messages.
 
-### `/reset`
-Clear the conversation history and start fresh.
+## Navigation
 
-### `/status`
-Show current settings (model, endpoint, working directory).
+### `/cd [path]`
+Change directory. With no argument, shows current working directory (combines `/cwd`, `/pwd`, `/cd`).
 
-## Navigation Commands
+### `/ls`
+List files in current directory (alias for ListDir tool).
 
-### `/cwd` or `/pwd`
-Show current working directory.
-
-### `/cd <path>`
-Change the current working directory.
-
-### `/ls` or `/dir`
-List files in the current directory (alias for ListDir).
-
-## Model/Config Commands
-
-### `/model <name>`
-Change the AI model being used.
-
-### `/endpoint <url>`
-Change the API endpoint.
+## Configuration
 
 ### `/config`
-Show or edit configuration settings.
+Show or modify settings. Subcommands:
+- `/config model <name>` - Change AI model
+- `/config endpoint <url>` - Change API endpoint
+- `/config debug <on|off>` - Toggle debug mode
 
-## File Operations
+## Conversation Management
 
-### `/save <filename>`
-Save the current conversation to a file.
+### `/save [filename]`
+Save current conversation to a file (JSON or markdown format).
 
 ### `/load <filename>`
 Load a previous conversation from a file.
 
 ### `/export <filename>`
-Export chat history in a different format (JSON, markdown).
+Export chat history in a specific format (JSON, markdown, plain text).
 
-## Utility Commands
-
-### `/version`
-Show AnchorCli version information.
-
-### `/about`
-Show information about the tool.
-
-### `/tools`
-List available AI tools and their capabilities.
-
-### `/debug`
-Toggle debug mode for more verbose output.
-
-## Advanced Ideas
+## Advanced Features
 
 ### `/undo`
-Undo the last file edit (would require edit history tracking).
+Undo the last file edit (requires edit history tracking).
 
-### `/diff <file>`
-Show differences between current and original file state.
+### `/diff [file]`
+Show differences between current and original file state. With no argument, shows all pending changes.
 
 ### `/search <pattern>`
-Quick file search across the project.
+Quick file/content search across the project.
 
 ### `/stats`
-Show statistics (files edited, commands run, etc.).
+Show session statistics (files edited, tokens used, commands run, estimated costs).
+
+### `/macro <name> [commands...]`
+Create and execute multi-step command sequences.
 
 ### `/alias <name> <command>`
-Create custom command aliases.
+Create custom command shortcuts.
 
-### `/macro <name>`
-Create and run multi-step macros.
+## Safety & Integration
+
+### `--dry-run` / Read-only Mode
+Run Anchor without mutating any files. Shows what *would* happen (edits, deletes, renames) without applying changes. Perfect for reviewing AI suggestions before committing.
+
+### Git Integration
+Seamless version control integration:
+- Auto-create a branch per session (`anchor session --git-branch`)
+- Auto-commit after successful edits with descriptive messages
+- Show git diff before/after operations
+- Revert to pre-session state if something goes wrong
+
+### Mutation Rate Limits
+Prevent runaway AI from trashing a project:
+- Configurable max file edits per conversation turn
+- Hard cap on delete/rename operations without confirmation
+- Cooldown period after N rapid mutations
+- Warning when approaching limits
+
+### File Type Restrictions
+Config to block edits on sensitive patterns (`*.config`, `*.sql`, `*.production.*`, etc.). Requires explicit override flag.