61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# @mosaicstack/mosaic
|
|
|
|
CLI package for the Mosaic self-hosted AI agent platform.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
mosaic wizard # First-run setup wizard
|
|
mosaic gateway install # Install the gateway daemon
|
|
mosaic config show # View current configuration
|
|
mosaic config hooks list # Manage Claude hooks
|
|
```
|
|
|
|
## Headless / CI Installation
|
|
|
|
Set `MOSAIC_ASSUME_YES=1` (or ensure stdin is not a TTY) to skip all interactive prompts. The following environment variables control the install:
|
|
|
|
### Gateway configuration (`mosaic gateway install`)
|
|
|
|
| Variable | Default | Required |
|
|
| -------------------------- | ----------------------- | ------------------ |
|
|
| `MOSAIC_STORAGE_TIER` | `local` | No |
|
|
| `MOSAIC_GATEWAY_PORT` | `14242` | No |
|
|
| `MOSAIC_DATABASE_URL` | _(none)_ | Yes if tier=`team` |
|
|
| `MOSAIC_VALKEY_URL` | _(none)_ | Yes if tier=`team` |
|
|
| `MOSAIC_ANTHROPIC_API_KEY` | _(none)_ | No |
|
|
| `MOSAIC_CORS_ORIGIN` | `http://localhost:3000` | No |
|
|
|
|
### Admin user bootstrap
|
|
|
|
| Variable | Default | Required |
|
|
| ----------------------- | -------- | -------------- |
|
|
| `MOSAIC_ADMIN_NAME` | _(none)_ | Yes (headless) |
|
|
| `MOSAIC_ADMIN_EMAIL` | _(none)_ | Yes (headless) |
|
|
| `MOSAIC_ADMIN_PASSWORD` | _(none)_ | Yes (headless) |
|
|
|
|
`MOSAIC_ADMIN_PASSWORD` must be at least 8 characters. In headless mode a missing or too-short password causes a non-zero exit.
|
|
|
|
### Example: Docker / CI install
|
|
|
|
```bash
|
|
export MOSAIC_ASSUME_YES=1
|
|
export MOSAIC_ADMIN_NAME="Admin"
|
|
export MOSAIC_ADMIN_EMAIL="admin@example.com"
|
|
export MOSAIC_ADMIN_PASSWORD="securepass123"
|
|
|
|
mosaic gateway install
|
|
```
|
|
|
|
## Hooks management
|
|
|
|
After running `mosaic wizard`, Claude hooks are installed in `~/.claude/hooks-config.json`.
|
|
|
|
```bash
|
|
mosaic config hooks list # Show all hooks and enabled/disabled status
|
|
mosaic config hooks disable PostToolUse # Disable a hook (reversible)
|
|
mosaic config hooks enable PostToolUse # Re-enable a disabled hook
|
|
```
|
|
|
|
Set `CLAUDE_HOME` to override the default `~/.claude` directory.
|