Sypha AI Docs
Features

Auto-Launch Configuration

Automatically start tasks when opening a workspace with Sypha.

Auto-Launch Configuration

Auto-Launch Configuration allows you to automatically start a Sypha task when opening a workspace. This is useful for testing prompts across multiple models or projects effortlessly.

How It Works

When you open a workspace, Sypha checks for a launchConfig.json file. If found, it:

  1. Switches to the specified Provider Profile.
  2. Changes to the specified Mode.
  3. Launches a task with your predefined Prompt.

Configuration

  1. Create a .sypha directory in your workspace root.
  2. Create a launchConfig.json file inside .sypha.

JSON Format

{
  "prompt": "Your task description here",
  "profile": "Profile Name (optional)",
  "mode": "mode-name (optional)"
}
  • prompt: (Required) The task message sent when the workspace opens.
  • profile: (Optional) Must match an existing API Configuration Profile.
  • mode: (Optional) e.g., code, architect, ask, debug.

File Location

your-workspace/
└── .sypha/
    └── launchConfig.json

Behavior

  • Auto-launch triggers ~500ms after the extension activates.
  • The sidebar receives focus automatically.
  • Profile and Mode changes are applied before the prompt is sent.

On this page