Sync to Cloud

View as Markdown

Optionally sync your local YAML tests, templates, and functions to Shiplight Cloud for scheduled runs, team collaboration, and automatic locator self-updates. This requires a Shiplight Cloud subscription.

Setup

You need a SHIPLIGHT_API_TOKEN to use cloud features. Get your token from app.shiplight.ai/settings/api-tokens and add it to your .env file:

SHIPLIGHT_API_TOKEN=your-token-here

Reconnect the MCP server (/mcp in Claude Code) to activate cloud tools.

Using /cloud

The /cloud slash command guides your AI agent through cloud operations. Just describe what you want:

/cloud sync all my local tests to the cloud

/cloud run login.test.yaml on staging environment

/cloud show me the latest test results

Your agent uses the Shiplight MCP tools (save_test_case, get_test_case, save_template, save_function, etc.) to handle the sync automatically.

What Gets Synced

Local artifact	Cloud equivalent	ID tracking
*.test.yaml	Test case	test_case_id field in YAML
templates/*.yaml	Reusable template	template_id field in YAML
helpers/*.ts exports	Test function	@function_id JSDoc tag

After syncing, the agent adds the cloud ID to your local file so future syncs update the existing cloud resource instead of creating duplicates.

Cloud Benefits

• Scheduled runs — run tests on a schedule without local infrastructure
• Locator self-updates — when an AI self-heal succeeds, the cloud automatically updates the cached locator for future runs
• Team collaboration — share tests, results, and environments across your team
• Test accounts — manage login credentials and browser sessions centrally
• Environments — configure different base URLs and variables per environment (staging, production, etc.)