Skip to content

Prompts Command Documentation

Overview

The prompts command allows users to access and manage user prompts that can be used with AI email drafting and management. Prompts provide standardized templates for different types of email interactions and help maintain consistency in AI-assisted email composition.

Usage

bash
mailos prompts [prompt-name] [flags]

Flags

  • --account string - Email account to use
  • -i, --interactive - Force interactive mode (default behavior, kept for compatibility)
  • --list - Show static list of available prompts (non-interactive)

Features

Prompt Management

  • Interactive prompt selection with user-friendly interface
  • List all available prompts with descriptions
  • Copy prompts directly to clipboard for easy use
  • Access embedded user prompts from the user-prompts/ directory

Prompt Selection

  • Interactive selection menu with descriptions
  • Direct access by prompt name
  • List view for browsing available prompts
  • Automatic clipboard integration for immediate use

Clipboard Integration

  • Automatically copies selected prompts to clipboard
  • Works with system clipboard for easy pasting
  • Provides user feedback when content is copied

Examples

List all available prompts

bash
mailos prompts --list

Interactive prompt selection

bash
mailos prompts
# or
mailos prompts --interactive

Get specific prompt by name

bash
mailos prompts email-drafting

Use with specific account

bash
mailos prompts --account [email protected]

Prompt Structure

User prompts are stored as Markdown files in the user-prompts/ directory and contain:

  • Descriptive content for the prompt
  • Instructions for AI assistants
  • Context-specific guidelines
  • Best practices for email composition

Integration

The prompts system integrates with:

  • AI email drafting functionality
  • Email management commands
  • Interactive email composition
  • Multi-account email management

Available Prompts

Prompts are automatically discovered from the embedded user-prompts/ directory. Each .md file represents a separate prompt that can be accessed by its filename (without extension).

The system provides user-friendly descriptions by reading the first non-header line from each prompt file, making it easy to understand what each prompt is designed for.

Released under the MIT License.