open-index/open-npm huggingface dataset:
npm package: @loracle-js/cli
Description: Loracle CLI - Publish your design system to Loracle
Author: Loracle
Latest version: 1.0.2

# Loracle CLI

Publishes your Storybook to Loracle so your AI tools always have up-to-date component context.

<a href="https://www.npmjs.com/package/@loracle-js/cli">
  <img src="https://badgen.net/npm/v/@loracle-js/cli" alt="Published on npm">
</a>

## Documentation

👉 Read the [Loracle CLI docs](https://getloracle.com/docs/cli)

## Requirements

- Node.js 18+
- Storybook 7+
- A Loracle API key — get one at [getloracle.com](https://getloracle.com)

## Usage

```sh
npx @loracle-js/cli publish <storybook-url> --version <semver>
```

**Example:**

```sh
LORACLE_API_KEY=your_api_key npx @loracle-js/cli publish https://storybook.example.com --version 1.2.0
```

### Options

| Option | Description |
|---|---|
| `-v, --version` | Semantic version for this build (required) |
| `--dry-run` | Validate without uploading |

### Environment variables

| Variable | Description |
|---|---|
| `LORACLE_API_KEY` | Your Loracle API key (required) |

## CI

### GitHub Actions

```yaml
- name: Install Playwright browsers
  run: npx playwright install chromium --with-deps

- name: Publish to Loracle
  run: npx @loracle-js/cli publish ${{ vars.STORYBOOK_URL }} --version ${{ github.ref_name }}
  env:
    LORACLE_API_KEY: ${{ secrets.LORACLE_API_KEY }}
```

### GitHub Actions (official Playwright image)

```yaml
container:
  image: mcr.microsoft.com/playwright:latest

steps:
  - name: Publish to Loracle
    run: npx @loracle-js/cli publish ${{ vars.STORYBOOK_URL }} --version ${{ github.ref_name }}
    env:
      LORACLE_API_KEY: ${{ secrets.LORACLE_API_KEY }}
```
npm package: @loracle-js/storybook-addon
Description: AI-powered component development inside Storybook
Author: Loracle
Latest version: 0.1.1

# @loracle/storybook-addon

AI-powered component development inside Storybook. Chat with AI to iterate on your components without leaving Storybook.

## Installation

```bash
npx storybook@latest add @loracle/storybook-addon
```

Or install manually:

```bash
npm install @loracle/storybook-addon
```

Then add it to your `.storybook/main.ts`:

```ts
const config: StorybookConfig = {
  addons: [
    "@loracle/storybook-addon",
    // ... other addons
  ],
};

export default config;
```

## Provider Configuration

Create `.storybook/opencode.json` to configure your AI provider:

```json
{
  "provider": "anthropic",
  "model": "claude-sonnet-4-6"
}
```

Supported providers: `anthropic`, `openai`, `google`, `amazon-bedrock`.

If no config file is present, the addon auto-detects providers configured via [OpenCode](https://opencode.ai).

## Requirements

- Storybook 8.0+ or 9.0+
- Node.js 18+

## How It Works

The addon adds a panel to Storybook where you can chat with AI about the currently selected story. The AI can read and modify your component source code, with full undo/revert support.

## Links

- [Documentation](https://docs.getloracle.com)
- [Website](https://getloracle.com)
- [Report Issues](https://github.com/getloracle/loracle/issues)

## License

Apache-2.0