appshot-cli 1.0.0 → 1.0.1

package/README.md

@@ -232,23 +232,23 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 | Tool | Description |
 |------|-------------|
-| `appshot.projectInfo` | Get project metadata (devices, languages, config) |
-| `appshot.init` | Initialize new project structure |
-| `appshot.build` | Generate final screenshots |
-| `appshot.frame` | Apply device frames only (transparent background) |
-| `appshot.captions` | Read/write caption text, auto-generate from filenames |
-| `appshot.gradients` | List/apply gradient presets |
-| `appshot.backgrounds` | Configure background images |
-| `appshot.fonts` | List/validate available fonts |
-| `appshot.config` | Modify device-specific settings |
-| `appshot.validate` | Check App Store compliance |
-| `appshot.specs` | View App Store specifications |
-| `appshot.doctor` | Run system diagnostics |
-| `appshot.presets` | Manage App Store presets |
-| `appshot.localize` | AI-powered caption translation |
-| `appshot.languages` | Discover available translations |
-| `appshot.export` | Export for Fastlane |
-| `appshot.clean` | Remove generated files |
+| `appshot_projectInfo` | Get project metadata (devices, languages, config) |
+| `appshot_init` | Initialize new project structure |
+| `appshot_build` | Generate final screenshots |
+| `appshot_frame` | Apply device frames only (transparent background) |
+| `appshot_captions` | Read/write caption text, auto-generate from filenames |
+| `appshot_gradients` | List/apply gradient presets |
+| `appshot_backgrounds` | Configure background images |
+| `appshot_fonts` | List/validate available fonts |
+| `appshot_config` | Modify device-specific settings |
+| `appshot_validate` | Check App Store compliance |
+| `appshot_specs` | View App Store specifications |
+| `appshot_doctor` | Run system diagnostics |
+| `appshot_presets` | Manage App Store presets |
+| `appshot_localize` | AI-powered caption translation |
+| `appshot_languages` | Discover available translations |
+| `appshot_export` | Export for Fastlane |
+| `appshot_clean` | Remove generated files |
 
 ### Example: Agent Workflow
 
@@ -1991,11 +1991,11 @@ appshot mcp
 
 **Tools exposed:**
 
-- `appshot.projectInfo` – Returns `appshot.json` metadata (devices, languages, templates).
-- `appshot.doctor` – Runs diagnostics and returns console output.
-- `appshot.build` – Wraps `appshot build` with options for devices, languages, and rendering flags.
-- `appshot.frame` – Batch frames screenshots (including `--frame-tone neutral` support).
-- `appshot.export` – Runs the Fastlane export pipeline.
+- `appshot_projectInfo` – Returns `appshot_json` metadata (devices, languages, templates).
+- `appshot_doctor` – Runs diagnostics and returns console output.
+- `appshot_build` – Wraps `appshot build` with options for devices, languages, and rendering flags.
+- `appshot_frame` – Batch frames screenshots (including `--frame-tone neutral` support).
+- `appshot_export` – Runs the Fastlane export pipeline.
 
 The server uses the stdio transport, so you can register it in Anthropic Desktop by pointing at `appshot mcp` (working directory = your Appshot project). The same entry point works for any MCP-compatible agent or automation.
 
@@ -3081,7 +3081,7 @@ For security vulnerabilities, please see [SECURITY.md](SECURITY.md).
 ### NPM Package
 
 - 📦 [appshot-cli on NPM](https://www.npmjs.com/package/appshot-cli)
-- 🔄 Latest version: 1.0.0
+- 🔄 Latest version: 1.0.1
 
 ---
 

package/dist/mcp/server.js

@@ -147,7 +147,7 @@ function registerProjectInfoTool(server) {
     const inputSchema = z.object({
         configPath: z.string().optional().describe('Path to appshot.json config file')
     });
-    server.registerTool('appshot.projectInfo', {
+    server.registerTool('appshot_projectInfo', {
         title: 'Read project configuration',
         description: 'Loads appshot.json and returns device + language metadata',
         inputSchema,
@@ -183,7 +183,7 @@ function registerProjectInfoTool(server) {
     });
 }
 function registerDoctorTool(server) {
-    server.registerTool('appshot.doctor', {
+    server.registerTool('appshot_doctor', {
         title: 'Run doctor checks',
         description: 'Runs appshot doctor to validate the current project'
     }, async () => {
@@ -211,7 +211,7 @@ function registerBuildTool(server) {
         verbose: z.boolean().optional().describe('Show detailed output'),
         concurrency: z.number().int().positive().optional().describe('Number of parallel builds')
     });
-    server.registerTool('appshot.build', {
+    server.registerTool('appshot_build', {
         title: 'Run appshot build',
         description: 'Generates screenshots for the configured devices and languages',
         inputSchema
@@ -249,7 +249,7 @@ function registerFrameTool(server) {
         verbose: z.boolean().optional().describe('Show detailed output'),
         frameTone: z.enum(['original', 'neutral']).optional().describe('Frame color tone')
     });
-    server.registerTool('appshot.frame', {
+    server.registerTool('appshot_frame', {
         title: 'Apply device frames',
         description: 'Wraps the frame CLI for MCP clients',
         inputSchema
@@ -277,7 +277,7 @@ function registerExportTool(server) {
         json: z.boolean().optional().describe('Output as JSON'),
         configPath: z.string().optional().describe('Path to appshot.json config file')
     });
-    server.registerTool('appshot.export', {
+    server.registerTool('appshot_export', {
         title: 'Export screenshots',
         description: 'Runs appshot export fastlane with optional filters',
         inputSchema
@@ -292,7 +292,7 @@ function registerInitTool(server) {
         force: z.boolean().optional().describe('Overwrite existing configuration files'),
         projectDir: z.string().optional().describe('Directory to initialize the project in')
     });
-    server.registerTool('appshot.init', {
+    server.registerTool('appshot_init', {
         title: 'Initialize project',
         description: 'Scaffold a new appshot project with default configuration',
         inputSchema
@@ -310,7 +310,7 @@ function registerSpecsTool(server) {
         device: z.string().optional().describe('Filter by device type: iphone, ipad, mac, watch, appletv, visionpro'),
         required: z.boolean().optional().describe('Show only required App Store presets')
     });
-    server.registerTool('appshot.specs', {
+    server.registerTool('appshot_specs', {
         title: 'App Store specifications',
         description: 'Get Apple App Store screenshot requirements and specifications (returns JSON)',
         inputSchema
@@ -325,7 +325,7 @@ function registerValidateTool(server) {
         strict: z.boolean().optional().describe('Validate against required presets only'),
         fix: z.boolean().optional().describe('Suggest fixes for invalid screenshots')
     });
-    server.registerTool('appshot.validate', {
+    server.registerTool('appshot_validate', {
         title: 'Validate screenshots',
         description: 'Validate screenshots against App Store requirements (returns JSON)',
         inputSchema
@@ -343,7 +343,7 @@ function registerCleanTool(server) {
         keepHistory: z.boolean().optional().describe('Keep history when using --all'),
         configPath: z.string().optional().describe('Path to appshot config file or project directory')
     });
-    server.registerTool('appshot.clean', {
+    server.registerTool('appshot_clean', {
         title: 'Clean generated files',
         description: 'Remove generated screenshots and optionally clear caches (auto-confirms)',
         inputSchema
@@ -368,7 +368,7 @@ function registerLocalizeTool(server) {
         sourceLanguage: z.string().optional().describe('Source language code (default: en)'),
         overwrite: z.boolean().optional().describe('Overwrite existing translations')
     });
-    server.registerTool('appshot.localize', {
+    server.registerTool('appshot_localize', {
         title: 'Batch translate captions',
         description: 'Translate captions to multiple languages using AI. Requires OPENAI_API_KEY environment variable.',
         inputSchema
@@ -386,7 +386,7 @@ function registerPresetsTool(server) {
         generate: z.array(z.string()).optional().describe('Generate config for specific preset IDs'),
         outputFile: z.string().optional().describe('Output file for generated config')
     });
-    server.registerTool('appshot.presets', {
+    server.registerTool('appshot_presets', {
         title: 'List presets',
         description: 'List available App Store presets and generate configuration (returns JSON)',
         inputSchema
@@ -401,7 +401,7 @@ function registerLanguagesTool(server) {
         device: z.string().optional().describe('Specific device to check (iphone/ipad/mac/watch), or omit for all devices'),
         configPath: z.string().optional().describe('Path to appshot config file or project directory')
     });
-    server.registerTool('appshot.languages', {
+    server.registerTool('appshot_languages', {
         title: 'Discover available languages',
         description: 'Scans caption files to discover which languages have translations available',
         inputSchema
@@ -458,7 +458,7 @@ function registerConfigTool(server) {
         marginTop: z.number().optional().describe('Top margin for caption box'),
         marginBottom: z.number().optional().describe('Bottom margin for caption box')
     });
-    server.registerTool('appshot.config', {
+    server.registerTool('appshot_config', {
         title: 'Update device configuration',
         description: 'Modifies device-specific settings in the appshot config file',
         inputSchema
@@ -570,7 +570,7 @@ function registerCaptionsTool(server) {
         captions: z.string().optional().describe('JSON object of filename:caption pairs for bulk-set (e.g., {"file1.png": "Caption 1", "file2.png": "Caption 2"})'),
         overwrite: z.boolean().optional().describe('Overwrite existing captions (for auto action, default: false)')
     });
-    server.registerTool('appshot.captions', {
+    server.registerTool('appshot_captions', {
         title: 'Manage captions',
         description: 'Read and write caption text for screenshots',
         inputSchema
@@ -845,7 +845,7 @@ function registerGradientsTool(server) {
         category: z.enum(['warm', 'cool', 'vibrant', 'subtle', 'monochrome', 'brand']).optional().describe('Filter by category (for list action)'),
         preset: z.string().optional().describe('Preset ID to apply (required for apply action)')
     });
-    server.registerTool('appshot.gradients', {
+    server.registerTool('appshot_gradients', {
         title: 'Manage gradients',
         description: 'List available gradient presets and apply them to config',
         inputSchema
@@ -948,7 +948,7 @@ function registerBackgroundsTool(server) {
         image: z.string().optional().describe('Path to background image (for set action)'),
         fit: z.enum(['cover', 'contain', 'fill', 'scale-down']).optional().describe('Background fit mode (for set action)')
     });
-    server.registerTool('appshot.backgrounds', {
+    server.registerTool('appshot_backgrounds', {
         title: 'Manage backgrounds',
         description: 'Configure background images for screenshots',
         inputSchema
@@ -1081,7 +1081,7 @@ function registerFontsTool(server) {
         action: z.enum(['list', 'validate', 'embedded']).describe('Action to perform'),
         font: z.string().optional().describe('Font name to validate (required for validate action)')
     });
-    server.registerTool('appshot.fonts', {
+    server.registerTool('appshot_fonts', {
         title: 'Manage fonts',
         description: 'List available fonts and check font availability',
         inputSchema
@@ -1112,7 +1112,7 @@ function registerTemplateTool(server) {
         dryRun: z.boolean().optional().describe('Preview changes without applying'),
         projectDir: z.string().optional().describe('Project directory to apply template to')
     });
-    server.registerTool('appshot.template', {
+    server.registerTool('appshot_template', {
         title: 'Apply template',
         description: 'Apply professional screenshot templates for quick App Store setup',
         inputSchema
@@ -1133,7 +1133,7 @@ function registerQuickstartTool(server) {
         force: z.boolean().optional().describe('Overwrite existing configuration'),
         projectDir: z.string().optional().describe('Directory to initialize the project in')
     });
-    server.registerTool('appshot.quickstart', {
+    server.registerTool('appshot_quickstart', {
         title: 'Quickstart',
         description: 'Get started with App Store screenshots in seconds - initializes project, applies template, sets up captions',
         inputSchema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appshot-cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Generate App Store–ready screenshots with frames, gradients, and captions",
   "bin": {
     "appshot": "bin/appshot.js"

package/skill/SKILL.md

@@ -13,29 +13,29 @@ AppShot generates App Store-ready screenshots with device frames, gradient backg
 
 | Tool | Purpose |
 |------|---------|
-| `appshot.init` | Initialize new project structure |
-| `appshot.captions` | Read/write/auto-generate caption text |
-| `appshot.gradients` | List/apply gradient presets |
-| `appshot.backgrounds` | Configure background images |
-| `appshot.fonts` | List/validate available fonts |
-| `appshot.config` | Modify device-specific settings |
-| `appshot.build` | Generate final screenshots |
-| `appshot.validate` | Check App Store compliance |
-| `appshot.specs` | View App Store specifications |
-| `appshot.doctor` | System diagnostics |
-| `appshot.presets` | App Store preset configurations |
-| `appshot.localize` | AI-powered caption translation |
-| `appshot.languages` | Discover available translations |
-| `appshot.frame` | Apply device frames only |
-| `appshot.export` | Export for Fastlane |
-| `appshot.clean` | Remove generated files |
+| `appshot_init` | Initialize new project structure |
+| `appshot_captions` | Read/write/auto-generate caption text |
+| `appshot_gradients` | List/apply gradient presets |
+| `appshot_backgrounds` | Configure background images |
+| `appshot_fonts` | List/validate available fonts |
+| `appshot_config` | Modify device-specific settings |
+| `appshot_build` | Generate final screenshots |
+| `appshot_validate` | Check App Store compliance |
+| `appshot_specs` | View App Store specifications |
+| `appshot_doctor` | System diagnostics |
+| `appshot_presets` | App Store preset configurations |
+| `appshot_localize` | AI-powered caption translation |
+| `appshot_languages` | Discover available translations |
+| `appshot_frame` | Apply device frames only |
+| `appshot_export` | Export for Fastlane |
+| `appshot_clean` | Remove generated files |
 
 ## Project Workflow
 
 ### 1. Initialize Project
 
 ```
-appshot.init with force: true
+appshot_init with force: true
 ```
 
 Creates the project structure:
@@ -59,131 +59,131 @@ final/                   # Generated output
 
 List existing captions:
 ```
-appshot.captions with device: "iphone", action: "list"
+appshot_captions with device: "iphone", action: "list"
 ```
 
 Set a caption:
 ```
-appshot.captions with device: "iphone", action: "set", filename: "home.png", caption: "Welcome Home", language: "en"
+appshot_captions with device: "iphone", action: "set", filename: "home.png", caption: "Welcome Home", language: "en"
 ```
 
 Auto-generate captions from filenames:
 ```
-appshot.captions with device: "iphone", action: "auto"
+appshot_captions with device: "iphone", action: "auto"
 ```
 This converts filenames like `home-screen.png` → "Home Screen"
 
 Bulk set multiple captions:
 ```
-appshot.captions with device: "iphone", action: "bulk-set", captions: "{\"home.png\": \"Welcome\", \"settings.png\": \"Settings\"}"
+appshot_captions with device: "iphone", action: "bulk-set", captions: "{\"home.png\": \"Welcome\", \"settings.png\": \"Settings\"}"
 ```
 
 Add translations:
 ```
-appshot.captions with device: "iphone", action: "set", filename: "home.png", caption: "Bienvenido", language: "es"
+appshot_captions with device: "iphone", action: "set", filename: "home.png", caption: "Bienvenido", language: "es"
 ```
 
 ### 3. Apply Styling
 
 List gradient presets:
 ```
-appshot.gradients with action: "list"
+appshot_gradients with action: "list"
 ```
 
 Apply a gradient:
 ```
-appshot.gradients with action: "apply", preset: "ocean"
+appshot_gradients with action: "apply", preset: "ocean"
 ```
 
 Set background image:
 ```
-appshot.backgrounds with action: "set", image: "./bg.jpg", fit: "cover"
+appshot_backgrounds with action: "set", image: "./bg.jpg", fit: "cover"
 ```
 
 Configure device settings:
 ```
-appshot.config with device: "iphone", frameScale: 0.85, captionPosition: "above"
+appshot_config with device: "iphone", frameScale: 0.85, captionPosition: "above"
 ```
 
 ### 4. Build Screenshots
 
 Build all devices and languages:
 ```
-appshot.build
+appshot_build
 ```
 
 Build specific devices:
 ```
-appshot.build with devices: ["iphone", "ipad"]
+appshot_build with devices: ["iphone", "ipad"]
 ```
 
 Build with App Store presets:
 ```
-appshot.build with presets: ["iphone-6-9", "ipad-13"]
+appshot_build with presets: ["iphone-6-9", "ipad-13"]
 ```
 
 ### 5. Frame Only (No Background)
 
 Apply device frames without gradients or captions:
 ```
-appshot.frame with input: "./screenshots/iphone"
+appshot_frame with input: "./screenshots/iphone"
 ```
 
 Frame with output directory:
 ```
-appshot.frame with input: "./screenshots/iphone", outputDir: "./framed"
+appshot_frame with input: "./screenshots/iphone", outputDir: "./framed"
 ```
 
 Frame recursively:
 ```
-appshot.frame with input: "./screenshots", recursive: true
+appshot_frame with input: "./screenshots", recursive: true
 ```
 
 Preview what would be framed:
 ```
-appshot.frame with input: "./screenshots/iphone", dryRun: true
+appshot_frame with input: "./screenshots/iphone", dryRun: true
 ```
 
 ### 6. Validate
 
 Check App Store compliance:
 ```
-appshot.validate
+appshot_validate
 ```
 
 ## Common Scenarios
 
 ### New iPhone-Only Project
 
-1. `appshot.init` with `force: true`
+1. `appshot_init` with `force: true`
 2. User adds screenshots to `screenshots/iphone/`
-3. `appshot.captions` - set captions for each screenshot
-4. `appshot.gradients` - apply preferred gradient
-5. `appshot.build` with `devices: ["iphone"]`
+3. `appshot_captions` - set captions for each screenshot
+4. `appshot_gradients` - apply preferred gradient
+5. `appshot_build` with `devices: ["iphone"]`
 
 ### Multi-Language App Store Submission
 
-1. `appshot.init` with `force: true`
-2. `appshot.captions` - add English captions
-3. `appshot.localize` with `languages: ["es", "fr", "de", "ja"]`
-4. `appshot.build` with `languages: ["en", "es", "fr", "de", "ja"]`
-5. `appshot.validate`
+1. `appshot_init` with `force: true`
+2. `appshot_captions` - add English captions
+3. `appshot_localize` with `languages: ["es", "fr", "de", "ja"]`
+4. `appshot_build` with `languages: ["en", "es", "fr", "de", "ja"]`
+5. `appshot_validate`
 
 ### Quick Styling Update
 
-1. `appshot.gradients` with `action: "list"` to see options
-2. `appshot.gradients` with `action: "apply", preset: "sunset"`
-3. `appshot.build`
+1. `appshot_gradients` with `action: "list"` to see options
+2. `appshot_gradients` with `action: "apply", preset: "sunset"`
+3. `appshot_build`
 
 ### Quick Auto-Caption Project
 
 When filenames are descriptive (e.g., `home-screen.png`, `settings_page.png`):
 
-1. `appshot.init` with `force: true`
+1. `appshot_init` with `force: true`
 2. User adds screenshots to `screenshots/iphone/`
-3. `appshot.captions` with `device: "iphone", action: "auto"`
-4. `appshot.gradients` with `action: "apply", preset: "ocean"`
-5. `appshot.build` with `devices: ["iphone"]`
+3. `appshot_captions` with `device: "iphone", action: "auto"`
+4. `appshot_gradients` with `action: "apply", preset: "ocean"`
+5. `appshot_build` with `devices: ["iphone"]`
 
 Captions are auto-generated from filenames (hyphens/underscores become spaces, title case applied).
 
@@ -191,7 +191,7 @@ Captions are auto-generated from filenames (hyphens/underscores become spaces, t
 
 For quick device mockups without backgrounds or captions:
 
-1. `appshot.frame` with `input: "./screenshots/iphone", outputDir: "./framed"`
+1. `appshot_frame` with `input: "./screenshots/iphone", outputDir: "./framed"`
 
 Output has transparent background - perfect for presentations, design comps, or overlaying on custom backgrounds.
 

package/skill/references/fonts.md

@@ -41,15 +41,15 @@
 
 List embedded fonts:
 ```
-appshot.fonts with action: "embedded"
+appshot_fonts with action: "embedded"
 ```
 
 Validate a font:
 ```
-appshot.fonts with action: "validate", font: "Inter"
+appshot_fonts with action: "validate", font: "Inter"
 ```
 
 Configure font in project:
 ```
-appshot.config with device: "iphone", font: "Montserrat Bold"
+appshot_config with device: "iphone", font: "Montserrat Bold"
 ```

package/skill/references/gradients.md

@@ -60,10 +60,10 @@
 
 To apply a gradient:
 ```
-appshot.gradients with action: "apply", preset: "<id>"
+appshot_gradients with action: "apply", preset: "<id>"
 ```
 
 To list gradients by category:
 ```
-appshot.gradients with action: "list", category: "warm"
+appshot_gradients with action: "list", category: "warm"
 ```

package/skill/references/templates.md

@@ -27,7 +27,7 @@
 - **Best for:** Consumer apps, social apps, general-purpose
 
 ```
-appshot.template with template: "modern"
+appshot_template with template: "modern"
 ```
 
 ---
@@ -42,7 +42,7 @@ appshot.template with template: "modern"
 - **Best for:** Health apps, wellness, lifestyle
 
 ```
-appshot.template with template: "minimal"
+appshot_template with template: "minimal"
 ```
 
 ---
@@ -57,7 +57,7 @@ appshot.template with template: "minimal"
 - **Best for:** Finance apps, security, premium features
 
 ```
-appshot.template with template: "bold"
+appshot_template with template: "bold"
 ```
 
 ---
@@ -72,7 +72,7 @@ appshot.template with template: "bold"
 - **Best for:** Developer tools, CLI apps, open source projects
 
 ```
-appshot.template with template: "nerdy"
+appshot_template with template: "nerdy"
 ```
 
 **Note:** Place a grid/terminal background image at `screenshots/iphone/background.png` for best results.
@@ -89,7 +89,7 @@ appshot.template with template: "nerdy"
 - **Best for:** Luxury apps, premium services, professional tools
 
 ```
-appshot.template with template: "elegant"
+appshot_template with template: "elegant"
 ```
 
 ---
@@ -104,7 +104,7 @@ appshot.template with template: "elegant"
 - **Best for:** Apps with strong visual branding, custom marketing assets
 
 ```
-appshot.template with template: "showcase"
+appshot_template with template: "showcase"
 ```
 
 **Tip:** Add your branded background to `screenshots/iphone/background.png`
@@ -121,7 +121,7 @@ appshot.template with template: "showcase"
 - **Best for:** Games, kids apps, entertainment, social
 
 ```
-appshot.template with template: "playful"
+appshot_template with template: "playful"
 ```
 
 ---
@@ -136,7 +136,7 @@ appshot.template with template: "playful"
 - **Best for:** Business apps, B2B, enterprise, productivity
 
 ```
-appshot.template with template: "corporate"
+appshot_template with template: "corporate"
 ```
 
 ---
@@ -145,13 +145,13 @@ appshot.template with template: "corporate"
 
 ```
 # Apply a template
-appshot.template with template: "nerdy"
+appshot_template with template: "nerdy"
 
 # Preview without applying
-appshot.template with preview: "modern"
+appshot_template with preview: "modern"
 
 # List all templates
-appshot.template with list: true
+appshot_template with list: true
 ```
 
 ## Customizing After Template
@@ -160,11 +160,11 @@ Templates set a starting point. Customize further with:
 
 ```
 # Change gradient
-appshot.gradients with action: "apply", preset: "sunset"
+appshot_gradients with action: "apply", preset: "sunset"
 
 # Adjust device positioning
-appshot.config with device: "iphone", frameScale: 0.85, framePosition: 30
+appshot_config with device: "iphone", frameScale: 0.85, framePosition: 30
 
 # Change caption position
-appshot.config with device: "iphone", captionPosition: "below"
+appshot_config with device: "iphone", captionPosition: "below"
 ```

package/skill/references/troubleshooting.md

@@ -1,6 +1,6 @@
 # Troubleshooting Guide
 
-Common issues and solutions when using appshot.
+Common issues and solutions when using appshot_
 
 ---
 
@@ -12,7 +12,7 @@ Common issues and solutions when using appshot.
 
 **Solution:**
 ```
-appshot.init with force: true
+appshot_init with force: true
 ```
 
 ### "Input directory not found"
@@ -38,13 +38,13 @@ appshot.init with force: true
 **Solutions:**
 ```
 # Check current captions
-appshot.captions with device: "iphone", action: "list"
+appshot_captions with device: "iphone", action: "list"
 
 # Auto-generate from filenames
-appshot.captions with device: "iphone", action: "auto"
+appshot_captions with device: "iphone", action: "auto"
 
 # Set manually
-appshot.captions with device: "iphone", action: "set", filename: "screen.png", caption: "My Caption"
+appshot_captions with device: "iphone", action: "set", filename: "screen.png", caption: "My Caption"
 ```
 
 ### Caption text cut off
@@ -55,7 +55,7 @@ appshot.captions with device: "iphone", action: "set", filename: "screen.png", c
 1. Use shorter text (2-3 words ideal)
 2. Adjust caption box settings:
 ```
-appshot.config with device: "iphone", captionPosition: "above"
+appshot_config with device: "iphone", captionPosition: "above"
 ```
 
 ### Wrong font displaying
@@ -65,10 +65,10 @@ appshot.config with device: "iphone", captionPosition: "above"
 **Solution:**
 ```
 # Check font availability
-appshot.fonts with action: "validate", font: "SF Pro Display"
+appshot_fonts with action: "validate", font: "SF Pro Display"
 
 # List embedded fonts (always available)
-appshot.fonts with action: "embedded"
+appshot_fonts with action: "embedded"
 ```
 
 **Embedded fonts:** Inter, Poppins, Montserrat, DM Sans, Roboto, Open Sans, Lato, Work Sans, JetBrains Mono, Fira Code
@@ -109,7 +109,7 @@ appshot.fonts with action: "embedded"
 **Solutions:**
 ```
 # Run diagnostics
-appshot.doctor
+appshot_doctor
 ```
 
 ### "Failed to load screenshot"
@@ -126,13 +126,13 @@ appshot.doctor
 **Solutions:**
 ```
 # Reduce concurrency on low-memory systems
-appshot.build with concurrency: 2
+appshot_build with concurrency: 2
 
 # Build specific devices only
-appshot.build with devices: ["iphone"]
+appshot_build with devices: ["iphone"]
 
 # Use preview mode for testing
-appshot.build with preview: true
+appshot_build with preview: true
 ```
 
 ---
@@ -148,17 +148,17 @@ appshot.build with preview: true
 **Solutions:**
 ```
 # Set background explicitly
-appshot.backgrounds with action: "set", image: "./bg.png", fit: "cover"
+appshot_backgrounds with action: "set", image: "./bg.png", fit: "cover"
 
 # Or use auto-detect (looks for background.png in device folders)
-appshot.build with autoBackground: true
+appshot_build with autoBackground: true
 ```
 
 ### Background looks stretched/cropped
 
 **Solution:** Change fit mode:
 ```
-appshot.backgrounds with action: "set", image: "./bg.png", fit: "contain"
+appshot_backgrounds with action: "set", image: "./bg.png", fit: "contain"
 ```
 
 Fit modes:
@@ -178,10 +178,10 @@ Fit modes:
 **Solution:**
 ```
 # Check required specs
-appshot.specs with device: "iphone", required: true
+appshot_specs with device: "iphone", required: true
 
 # Use presets for correct sizing
-appshot.build with presets: ["iphone-6-9", "ipad-13"]
+appshot_build with presets: ["iphone-6-9", "ipad-13"]
 ```
 
 ### Missing required sizes
@@ -199,7 +199,7 @@ appshot.build with presets: ["iphone-6-9", "ipad-13"]
 **Solution:**
 ```
 # Run doctor to check system
-appshot.doctor
+appshot_doctor
 
 # Reinstall if needed (in terminal)
 npm rebuild sharp
@@ -217,7 +217,7 @@ npm rebuild sharp
 
 Run the doctor command to check all systems:
 ```
-appshot.doctor
+appshot_doctor
 ```
 
 This checks: