Skip to main content
Maestro includes an extensible slash command system with autocomplete. Type / in the input area to open the autocomplete menu, use arrow keys to navigate, and press Tab or Enter to select.

Custom AI Commands

Create your own slash commands in Settings > Custom AI Commands. Each command has a trigger (e.g., /deploy) and a prompt that gets sent to the AI agent. Commands support template variables that are automatically substituted at runtime:

Agent Variables

VariableDescription
{{AGENT_NAME}}Agent name
{{AGENT_PATH}}Agent home directory path (full path to project)
{{AGENT_GROUP}}Agent’s group name (if grouped)
{{AGENT_SESSION_ID}}Agent session ID (for conversation continuity)
{{TAB_NAME}}Custom tab name (alias: SESSION_NAME)
{{TOOL_TYPE}}Agent type (claude-code, codex, opencode)

Path Variables

VariableDescription
{{CWD}}Current working directory
{{AUTORUN_FOLDER}}Auto Run documents folder path

Auto Run Variables

VariableDescription
{{DOCUMENT_NAME}}Current Auto Run document name (without .md)
{{DOCUMENT_PATH}}Full path to current Auto Run document
{{LOOP_NUMBER}}Current loop iteration (starts at 1)

Date/Time Variables

VariableDescription
{{DATE}}Current date (YYYY-MM-DD)
{{TIME}}Current time (HH:MM:SS)
{{DATETIME}}Full datetime (YYYY-MM-DD HH:MM:SS)
{{TIMESTAMP}}Unix timestamp in milliseconds
{{DATE_SHORT}}Short date (MM/DD/YY)
{{TIME_SHORT}}Short time (HH:MM)
{{YEAR}}Current year (YYYY)
{{MONTH}}Current month (01-12)
{{DAY}}Current day (01-31)
{{WEEKDAY}}Day of week (Monday, Tuesday, etc.)

Git & Context Variables

VariableDescription
{{GIT_BRANCH}}Current git branch name (requires git repo)
{{IS_GIT_REPO}}”true” or “false”
{{CONTEXT_USAGE}}Current context window usage percentage
Example: A custom /standup command with prompt:
It's {{WEEKDAY}}, {{DATE}}. I'm on branch {{GIT_BRANCH}} at {{AGENT_PATH}}.
Summarize what I worked on yesterday and suggest priorities for today.

Spec-Kit Commands

Maestro bundles GitHub’s spec-kit methodology for structured feature development. Commands include /speckit.constitution, /speckit.specify, /speckit.clarify, /speckit.plan, /speckit.tasks, and /speckit.implement. See Spec-Kit Commands for the complete workflow guide.

OpenSpec Commands

Maestro bundles OpenSpec for spec-driven change management. These commands help you propose, implement, and archive changes systematically:
CommandDescription
/openspec.proposalCreate a change proposal with spec deltas before writing code
/openspec.applyImplement an approved proposal by following the tasks
/openspec.archiveArchive completed changes after deployment
/openspec.implementGenerate Auto Run documents from a proposal (Maestro-specific)
/openspec.helpGet help with OpenSpec workflow and concepts
See OpenSpec Commands for the complete workflow guide and directory structure.

Agent Native Commands

When using Claude Code, Maestro automatically discovers and displays the agent’s native slash commands in the autocomplete menu. These appear with a “Claude Code command” label to distinguish them from Maestro’s custom commands.

Supported in Batch Mode

Claude Code runs in batch/print mode within Maestro, which means only certain native commands work. The following commands are supported:
CommandDescription
/compactCompact conversation history to reduce context usage
/contextManage conversation context
/costShow token usage and cost for the session
/initInitialize a CLAUDE.md file in the project
/pr-commentsAddress PR review comments
/release-notesGenerate release notes
/reviewRequest a code review
/security-reviewPerform a security review
Additionally, any custom commands from Claude Code plugins/skills (e.g., /commit, /pdf, /docx) are fully supported and will appear in the autocomplete menu.

Not Supported in Batch Mode

The following Claude Code commands are interactive-only and don’t work through Maestro:
CommandReason
/mcpMCP server management requires interactive TUI
/helpHelp display is interactive
/clearConversation clearing is handled differently in batch mode
/configConfiguration requires interactive prompts
/modelModel switching mid-session requires TUI
/permissionsPermission management is interactive
/memoryMemory/CLAUDE.md editing requires TUI
/rewindConversation rewind requires interactive selection
/vimVim mode is a TUI feature
/doctorDiagnostics run as a separate CLI command
/login / /logoutAuthentication is interactive
/bugBug reporting requires interactive input
For commands like /mcp or /config, use the Claude Code CLI directly in a terminal: claude mcp or claude config.