Commands are user-initiated actions invoked via /command syntax or equivalent natural language.

/plan

Syntax: /plan Description: Enters plan mode for discussing approaches without making changes. Behavior: Maestro asks questions and discusses strategies. No file proposals or code changes are made. Read-only tools remain available (View Files, Search, etc.). Plan mode ends when implementation is requested. Example:
/plan
"How should we architect the caching layer?"

/forget

Syntax: /forget Description: Selectively removes dialog turns from session memory. Behavior: An interactive UI appears showing memory breakdown by turn. Selecting turns or ranges and confirming removes them permanently. Capacity is freed immediately. File iterations and clone records are not affected. Example:
/forget
[Select turns 5-15 → Confirm → Capacity freed]

/compact

Syntax: /compact Description: Compresses old dialog into summaries. Behavior: Old dialog is analyzed and replaced with compressed summaries. Key decisions, architectural choices, and validation results are preserved. Step-by-step implementation details, debugging iterations, and exploratory dead ends are compressed. Token usage is reduced while important context is retained. Example:
/compact
[Old dialog summarized, key decisions preserved, capacity reduced]

/synopsis

Syntax: /synopsis Description: Generates a comprehensive session overview document. Behavior: Maestro produces a markdown document covering: what was accomplished, key decisions made, technical approaches taken, current state, and suggested next steps. Example:
/synopsis
[Maestro generates session overview markdown]

/hidefiles

Syntax: /hidefiles Description: Hides specific file iterations from view. Behavior: An interactive table appears showing all file iterations. Selected iterations are hidden from Maestro’s context. Hidden files do not consume capacity. They can be unhidden later. Iteration history is preserved. Example:
/hidefiles
[Select auth.py iterations 0-13 → Hide → Capacity reduced]

/refresh

Syntax: /refresh Description: Resets file view to the latest iteration of each file. Behavior: All old file iterations are hidden. Only the most recent version of each file remains visible. Iteration history is preserved and old iterations can still be restored. Example:
/refresh
[All files show latest iteration only, capacity reduced]

/download-all

Syntax: /download-all Description: Downloads all session files as a zip archive. Behavior: A zip archive containing all source code, configuration, documentation, and test files is generated and downloaded via the browser. .gitignore patterns are respected. Build artifacts, dependencies, temporary files, and binary artifacts are excluded. Example:
/download-all
[Browser downloads zip archive of all session files]

/download-new

Syntax: /download-new Description: Downloads only new or modified files as a zip archive. Behavior: A zip archive containing files created or changed during the session is generated. Directory structure is preserved. Extracting at the project root places files in their correct locations. Example:
/download-new
[Browser downloads zip of changed files with preserved directory structure]

/download-recent

Syntax: /download-recent Description: Downloads the 5 most recently modified files. Behavior: The 5 most recently modified files are downloaded individually (not zipped) via the browser. Example:
/download-recent
[Browser downloads 5 individual files]

/clone

Syntax: /clone Description: Clones a Git repository into the session. Behavior: An interactive flow opens. Steps: select private (authenticated) or public repository, choose from available repositories or enter URL, select branch/commit hash/default. After cloning, files are immediately available in the session and synced to the sandbox. Clone records persist across memory clearing. Capabilities: Private repositories (with GitHub authentication), specific branches or commits, pull request URLs (format: github.com/owner/repo/pull/123), multiple clones of same repository. Maximum repository size: ~10GB. Overwrite behavior: Cloning an already-cloned repository detects changed files, creates new iterations for changes, and preserves existing iteration history. Example:
/clone
[Select private → Choose backend-api → Select develop branch → Clone completes]

/create

Syntax: /create Description: Creates a new GitHub repository. Behavior: An interactive flow opens. Steps: enter repository name and description, select visibility (public/private, default: private), choose gitignore template, choose license template, select organization or personal account. Auto-clone is enabled by default. If session files exist matching the repository name, existing files are pushed as initial commit instead of using templates. Example:
/create
[Enter "my-project" → Select MIT license → Python gitignore → Repository created and cloned]

/pr

Syntax: /pr Description: Creates or updates a GitHub pull request. Behavior: An interactive flow opens. Steps: configure base branch and feature branch name, select files to include via interactive table, provide title and description, review diff, confirm and push. For updates, the operation is a full synchronization: files deselected during update revert to base branch state on the remote. Example:
/pr
[Configure main → feature/auth → Select files → "Add JWT auth" → Confirm → PR created]

/secrets

Syntax: /secrets Description: Manages secret activation for the current session. Behavior: An interactive table appears showing all registered secrets with active/inactive status. Toggling switches activates or deactivates secrets. Activated secrets become environment variables in the sandbox. Changes take effect immediately. Secrets are session-scoped and isolated. Example:
/secrets
[Toggle AWS_ACCESS_KEY_ID to active → Confirm → Available as environment variable]

/reset-sandbox

Syntax: /reset-sandbox Description: Forces a sandbox reset. Behavior: A confirmation prompt appears. After confirmation, the sandbox is terminated completely. A fresh sandbox is created on the next command. Session files are preserved. Running processes are terminated. Previously installed packages and environment variables are cleared. Example:
/reset-sandbox
[Confirm → Sandbox terminated → Fresh sandbox on next command]

/settings

Syntax: /settings Description: Opens session-level settings. Behavior: A settings interface appears. Configurable options include model selection (default, Sonnet, Opus, Haiku), sandbox persistence (extends auto-termination to 24 hours), and session behavior preferences. Changes apply to the current session. Example:
/settings
[Select model → Choose Opus → Changes apply to session]

/skills

Syntax: /skills Description: Manages skills for the current session. Behavior: A list of available skills appears with descriptions and enable/disable controls. Enabled skills apply automatically when relevant to current work. Multiple skills can be active simultaneously. Example:
/skills
[Enable "React Best Practices" skill → Active for session]

/tools

Syntax: /tools Description: Displays and manages available tools. Behavior: All tools are displayed organized by category with descriptions and schemas. Individual tools can be enabled or disabled for the session. Example:
/tools
[View all tools → Disable image generation tools → Changes apply to session]

/topup

Syntax: /topup Description: Initiates credit purchase. Behavior: Current credit balance is displayed with a “Top Up Credits” button. Clicking redirects to Stripe checkout. After selecting a credit amount and completing purchase, credits are added immediately. Example:
/topup
[View balance: 50 credits → Top Up → Select 500 credits → Purchase → Balance: 550]