---
name: local
description: "Passthrough connector to a local directory — copies source files into the filesystem mount point."
version: "0.1.0"
entry: ./driver.ts
fields:
  - key: source
    label: "Source directory path"
    required: true
    sensitive: false
keywords:
  - local
  - filesystem
  - directory
  - bind
---

## Local Connector

Projects a local directory into the session filesystem mount point by copying
its contents. If the source and target paths are identical (or target is inside
source), the copy step is skipped and the directory is used in place.

### Configuration

```yaml
connectors:
  - id: my-files
    driver: local
    access: read-write
    mount:
      source: ./path/to/directory
```

### Behavior

- **mount**: Copies the source directory into `targetDir` recursively.
- **unmount**: No-op (does not delete the mount directory).
- **sync**: Re-copies from source to target.
- **watch**: Uses chokidar filesystem watcher on the mount path.