diff --git a/IDEAS.md b/IDEAS.md index 3d5e11f..bf7a356 100644 --- a/IDEAS.md +++ b/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 ` 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 ` -Change the current working directory. - -### `/ls` or `/dir` -List files in the current directory (alias for ListDir). - -## Model/Config Commands - -### `/model ` -Change the AI model being used. - -### `/endpoint ` -Change the API endpoint. +## Configuration ### `/config` -Show or edit configuration settings. +Show or modify settings. Subcommands: +- `/config model ` - Change AI model +- `/config endpoint ` - Change API endpoint +- `/config debug ` - Toggle debug mode -## File Operations +## Conversation Management -### `/save ` -Save the current conversation to a file. +### `/save [filename]` +Save current conversation to a file (JSON or markdown format). ### `/load ` Load a previous conversation from a file. ### `/export ` -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 ` -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 ` -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 [commands...]` +Create and execute multi-step command sequences. ### `/alias ` -Create custom command aliases. +Create custom command shortcuts. -### `/macro ` -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.