# FeltDB Development Workspace

This directory contains the development workspace configuration for your FeltDB project.

## workspace.json

**Purpose:** Durable pairing identity for your project's development workspace.

**Contents:**
- `workspaceId` — Unique identifier for this workspace (format: `ws_*`)
- `projectId` — Your project name
- `version` — Configuration version

**Usage:**
- Committed to version control (this is your project's identity)
- Used by CLI, IDE, agents, and browser extensions to discover the workspace
- DO NOT edit manually unless you know what you're doing

**Discovery:**
When any FeltDB tool (VS Code, Claude agent, CLI, browser extension) opens your project, it reads this file to automatically connect to the correct workspace.

## Runtime Files (not committed)

- `pairing.json` — Short-lived pairing token for browser discovery (gitignored)
- `state.json` — Local workspace state (gitignored)
- `*.log` — Development logs (gitignored)

## Commands

```bash
# Check workspace status
npm run feltdb:status

# Or use the CLI directly
feltdb workspace status

# Launch development environment (includes workspace authority)
npm run dev
```

## Development Workspace Architecture

```
Your Project
    ↓
.feltdb/workspace.json  (pairing identity)
    ↓
feltdb dev (workspace authority)
    ↓
Browser, IDE, Agent clients
```

All tools automatically discover your workspace using `workspace.json` and connect to the local development environment started by `npm run dev`.

## Learn More

- [Development Workspaces Documentation](https://github.com/rkendel1/feltdb/blob/main/packages/core/docs/development-workspaces.md)
- [FeltDB Documentation](https://github.com/rkendel1/feltdb)