# RootCX Claude Code Plugin

> **Business apps, tailored.** Transform natural language into production-ready enterprise software with AI-native development.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blue)](https://claude.ai/code)

Build custom business applications without rigid off-the-shelf software. RootCX generates production-grade tools instantly on a unified, secure foundation with full code-level control.

## Installation

### Quick Start

1. Open Claude Code
2. Add the RootCX marketplace:
   ```
   /plugin marketplace add rootcx/claude-code-plugin
   ```
3. Install the plugin:
   ```
   /plugin install rootcx
   ```

### Manual Installation

```bash
claude --plugin-dir /path/to/claude-code-plugin
```

## Features

- **7 Slash Commands**: `/rootcx:login`, `/rootcx:status`, `/rootcx:init`, `/rootcx:preview`, `/rootcx:push`, `/rootcx:pull`, `/rootcx:open`
- **MCP Tools**: Component search, integration docs, app schemas, permission patterns
- **App Builder Skill**: AI-guided development with Business Design System

## Commands

| Command | Description |
|---------|-------------|
| `/rootcx:login` | Authenticate with RootCX |
| `/rootcx:status` | Check auth and project status |
| `/rootcx:init` | Create a new RootCX app |
| `/rootcx:preview` | Sync and preview your app |
| `/rootcx:push` | Push files to the cloud |
| `/rootcx:pull` | Pull files from the cloud |
| `/rootcx:open` | Open RootCX dashboard |

## MCP Tools

The plugin provides MCP tools for Claude:

- `verify_build` - Validate TypeScript/TSX code
- `search_components` - Search Business Design System components
- `get_component_docs` - Get component documentation
- `list_integrations` - List available integrations
- `get_integration_capabilities` - Get integration details
- `list_installed_apps` - List installed apps in organization
- `get_app_schema` - Get app entity schemas
- `list_organization_roles` - List roles and permissions
- `list_all_permissions` - List registered permissions
- `get_permission_patterns` - Get permission implementation patterns

## Skills

The `rootcx-builder` skill activates automatically when building RootCX apps, providing:

- Business Design System guidance
- Data hooks patterns (useAppCollection)
- Integration usage examples
- Best practices for app structure

## Requirements

- Claude Code CLI
- Node.js 18+
- RootCX account ([Sign up](https://rootcx.com))

## Documentation

- [Getting Started](https://docs.rootcx.com/claude-code/getting-started)
- [API Reference](https://docs.rootcx.com/api)
- [Component Library](https://docs.rootcx.com/components)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT - see [LICENSE](LICENSE)