@isolatedtech/cli

CLI for publishing macOS apps to isolated.tech with Sparkle auto-updates.

Designed to be AI-agent friendly with structured JSON output and zero-config operation.

Installation

npm install -g @isolatedtech/cli

Quick Start

# 1. Authenticate (opens browser, enter code shown)
isolated login

# 2. Register your app (auto-detects Xcode project)
isolated init

# 3. Build your app, then publish
isolated publish

Commands

Discovery

isolated doctor   # Diagnose what's needed to publish
isolated status   # Show current project and auth status

Authentication

isolated login    # Authenticate with isolated.tech
isolated logout   # Sign out
isolated whoami   # Show current user

App Management

isolated init              # Register app (auto-detects project)
isolated apps list         # List your registered apps
isolated apps versions     # List versions for an app

Publishing

isolated publish           # Publish a release (auto-detects everything)
isolated publish --dry-run # Preview without uploading

Blog Posts

Create and manage blog posts for your apps.

# List all blog posts
isolated blog list

# List posts for a specific app
isolated blog list --app healthmd

# Create a blog post from a markdown file
isolated blog create --app healthmd --title "Introducing Health Insights" --file post.md

# Create and publish immediately
isolated blog create --app healthmd --title "New Feature" --body "..." --publish

# Publish a draft
isolated blog publish <post-id>

# Update a post
isolated blog update <post-id> --title "New Title" --file updated.md

# Delete a post
isolated blog delete <post-id>

Alerting (ntfy.sh)

Push notifications to your phone when errors occur in your apps.

# Configure your ntfy.sh topic
isolated ntfy setup my-secret-topic

# Test it works
isolated ntfy test

# Send custom notifications
isolated ntfy send "Deployment complete!" --title "🚀 Success"

# Generate alerting code for your project
isolated ntfy init                    # Auto-detect project type
isolated ntfy init --type cloudflare  # Cloudflare Workers
isolated ntfy init --type swift       # iOS/macOS apps

JSON Output (for AI Agents)

All commands support --json for structured output:

isolated doctor --json

{
  "ready": true,
  "authenticated": true,
  "project": {
    "detected": true,
    "name": "MyApp",
    "version": "1.2.3",
    "build": "45"
  },
  "release": {
    "ready": true,
    "zipFile": "MyApp-v1.2.3-macOS.zip"
  }
}

Errors include actionable fixes:

{
  "success": false,
  "error": "not_authenticated",
  "message": "Not logged in",
  "fix": "Run: isolated login"
}

Zero-Config Operation

The CLI auto-detects:

• Xcode project - finds .xcodeproj or .xcworkspace
• Version & build - reads from Xcode via agvtool
• App slug - derives from bundle ID or project name
• Release zip - finds most recent *-macOS.zip
• Changelog - extracts from CHANGELOG.md
• Signing key - uses Sparkle tools or Keychain

Environment Variables

ISOLATED_API_KEY    # API key (for CI, overrides login)
ISOLATED_API_URL    # API URL (default: https://isolated.tech)

License

MIT