b38cfac760
Moves all Mosaic framework runtime files from the separate bootstrap repo into the monorepo as canonical source. The @mosaic/mosaic npm package now ships the complete framework — bin scripts, runtime configs, tools, and templates — enabling standalone installation via npm install. Structure: packages/mosaic/framework/ ├── bin/ 28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.) ├── runtime/ Runtime adapters (claude, codex, opencode, pi, mcp) ├── tools/ Shell tooling (git, prdy, orchestrator, quality, etc.) ├── templates/ Agent and repo templates ├── defaults/ Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.) ├── install.sh Legacy bash installer └── remote-install.sh One-liner remote installer Key files with Pi support and recent fixes: - bin/mosaic: launch_pi() with skills-local loop - bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses - bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find - bin/mosaic-link-runtime-assets: Pi settings.json patching - bin/mosaic-migrate-local-skills: Pi skill roots, symlink find - runtime/pi/RUNTIME.md + mosaic-extension.ts Package ships 251 framework files in the npm tarball (278KB compressed).
67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# Coolify Tool Suite
|
|
|
|
Manage Coolify container deployment platform (projects, services, deployments, environment variables).
|
|
|
|
## Prerequisites
|
|
|
|
- `jq` and `curl` installed
|
|
- Coolify credentials in `~/src/jarvis-brain/credentials.json` (or `$MOSAIC_CREDENTIALS_FILE`)
|
|
- Required fields: `coolify.url`, `coolify.app_token`
|
|
|
|
## Scripts
|
|
|
|
| Script | Purpose |
|
|
| ------------------- | ------------------------------------- |
|
|
| `team-list.sh` | List teams |
|
|
| `project-list.sh` | List projects |
|
|
| `service-list.sh` | List all services |
|
|
| `service-status.sh` | Get service details and status |
|
|
| `deploy.sh` | Trigger service deployment |
|
|
| `env-set.sh` | Set environment variable on a service |
|
|
|
|
## Common Options
|
|
|
|
- `-f json` — JSON output (default: table)
|
|
- `-u uuid` — Service UUID (for service-specific operations)
|
|
- `-h` — Show help
|
|
|
|
## API Reference
|
|
|
|
- Base URL: `http://10.1.1.44:8000`
|
|
- API prefix: `/api/v1/`
|
|
- Auth: Bearer token in `Authorization` header
|
|
- Rate limit: 200 requests per interval
|
|
|
|
## Known Limitations
|
|
|
|
- **FQDN updates on compose sub-apps not supported via API.** Workaround: update directly in Coolify's PostgreSQL DB (`coolify-db` container, `service_applications` table).
|
|
- **Compose must be base64-encoded** in `docker_compose_raw` field when creating services via API.
|
|
- **Don't send `type` with `docker_compose_raw`** — API rejects payloads with both fields.
|
|
|
|
## Coolify Magic Variables
|
|
|
|
Coolify reads special env vars from compose files:
|
|
|
|
- `SERVICE_FQDN_{NAME}_{PORT}` — assigns a domain to a compose service
|
|
- `SERVICE_URL_{NAME}_{PORT}` — internal URL reference
|
|
- Must use list-style env syntax (`- SERVICE_FQDN_API_3001`), NOT dict-style.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# List all projects
|
|
~/.config/mosaic/tools/coolify/project-list.sh
|
|
|
|
# List services as JSON
|
|
~/.config/mosaic/tools/coolify/service-list.sh -f json
|
|
|
|
# Check service status
|
|
~/.config/mosaic/tools/coolify/service-status.sh -u <uuid>
|
|
|
|
# Set an env var
|
|
~/.config/mosaic/tools/coolify/env-set.sh -u <uuid> -k DATABASE_URL -v "postgres://..."
|
|
|
|
# Deploy a service
|
|
~/.config/mosaic/tools/coolify/deploy.sh -u <uuid>
|
|
```
|