# Openloomi Install

OpenLoomi install & first-use setup helper for Codex.

- Repository: https://github.com/melandlabs/openloomi (1038 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-09-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add melandlabs/openloomi --skill openloomi-install -g -a claude-code -y`
Codex: `npx skills add melandlabs/openloomi --skill openloomi-install -g -a codex -y`
Cursor: `npx skills add melandlabs/openloomi --skill openloomi-install -g -a cursor -y`
Gemini CLI: `npx skills add melandlabs/openloomi --skill openloomi-install -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add melandlabs/openloomi`

## Description

OpenLoomi install & first-use setup helper for Codex. Use when the user wants to install OpenLoomi, configure it, or troubleshoot `INSTALL_REQUIRED` / `SOURCE_FOUND_APP_NOT_BUILT` / `SESSION_INITIALIZATION_REQUIRED` after running setup-status. Triggers: install openloomi, configure openloomi, setup openloomi, openloomi not installed, openloomi not finalized, install_required, install missing, guest session.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OpenLoomi Install Sub-skill

This sub-skill is auto-loaded when the user wants to install or fix OpenLoomi
on their machine. It composes `loomi-bridge` operations and never downloads
or executes anything outside the plugin's own scripts.

## Quick workflow

1. **Always run `setup` (and the loopback checks below) outside the Codex
   sandbox**, the install + launch path needs writes to `/Applications`,
   desktop GUI launch, and `http://localhost:3414`. Default `read-only` /
   `workspace-write` modes will silently fail. Ask the user to drop
   `sandbox=workspace-write` (or move to `danger-full-access`) before
   invoking the bridge.
2. `node "$SKILL_DIR/../../scripts/loomi-bridge.mjs" setup-status`
3. Based on `nextAction` / `reason`:

The rest: https://github.com/melandlabs/openloomi/blob/HEAD/plugins/codex/skills/openloomi-install/SKILL.md