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.

Built-in Maestro Commands

Maestro provides built-in slash commands that are handled internally (not sent to the AI agent):
CommandDescription
/historyGenerate a synopsis of recent work and add to the History panel
/wizardStart the planning wizard for Auto Run documents
/skillsList available Claude Code skills for this project (Claude Code only)
The /wizard command can take optional natural language input: /wizard add user authentication feature to provide initial context.

Skills Enumeration

The /skills command displays all Claude Code skills available in your project. Skills are extensions that provide domain-specific knowledge and capabilities to Claude Code.
Skills enumeration showing project skills with name, token count, and description
Skills are loaded from:
  • Project skills: .claude/skills/<skill-name>/skill.md in your project directory
  • User skills: ~/.claude/skills/<skill-name>/skill.md for personal skills
Each skill is displayed with its name, approximate token count, and description. This command is only available when using Claude Code as your AI provider.
The /skills command is a Maestro feature that reads skill files directly—it doesn’t invoke Claude Code’s native /skills command (which requires an interactive terminal).

Custom AI Commands

Create your own slash commands in Settings → 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:

Conductor Variables

VariableDescription
{{CONDUCTOR_PROFILE}}Your “About Me” profile from Settings → General. Tells agents about your background, preferences, and communication style.

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, factory-droid)

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 (5-digit padded: 00001, 00002, etc.)

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:
CommandDescription
/speckit.helpLearn how to use spec-kit with Maestro
/speckit.constitutionCreate or update the project constitution
/speckit.specifyCreate or update feature specification
/speckit.clarifyIdentify underspecified areas and ask clarification questions
/speckit.planExecute implementation planning workflow
/speckit.tasksGenerate actionable, dependency-ordered tasks
/speckit.analyzeCross-artifact consistency and quality analysis
/speckit.checklistGenerate custom checklist for feature
/speckit.taskstoissuesConvert tasks to GitHub issues
/speckit.implementExecute tasks using Maestro Auto Run with worktree support
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.helpLearn how to use OpenSpec with Maestro
/openspec.proposalCreate a change proposal with specs, tasks, and optional design docs
/openspec.applyImplement an approved change proposal by executing tasks
/openspec.archiveArchive a completed change after deployment
/openspec.implementConvert OpenSpec tasks to Maestro Auto Run documents
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 commands are sent via the system/init event when Claude Code starts and 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
/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.