> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enagrams.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workstream_start

> Create a workstream and its shared git branch

## Overview

A workstream is a scoped unit of work mapped 1:1 to a git branch named `ena/<slug>`. Starting a workstream tells every other agent in the workspace that this feature is in flight, and enables symbol-level coordination with anyone who joins it.

When any agent is on a branch matching `ena/<slug>`, Enagrams puts the session in coordinated mode automatically.

## Parameters

| Parameter     | Type   | Required | Description                                   |
| ------------- | ------ | -------- | --------------------------------------------- |
| `title`       | string | Yes      | Short title for the workstream                |
| `slug`        | string | No       | Explicit slug (derived from title if omitted) |
| `description` | string | No       | Longer description                            |
| `base_branch` | string | No       | Git base branch (default `main`)              |
| `visibility`  | string | No       | `team` (default) or `private`                 |
| `session_id`  | string | No       | Your current session id                       |

## Response

Returns the created workstream including `slug` and `branch` (`ena/<slug>`). Check out the branch locally and keep working.

## Example

```json theme={null}
{
  "tool": "workstream_start",
  "arguments": {
    "title": "Stripe subscription upgrades",
    "description": "Let existing subscribers change plans mid-cycle with proration.",
    "base_branch": "main"
  }
}
```

See [workstreams](/concepts/workstreams) for the full lifecycle.