# Openloomi Setup

> OpenLoomi first-use setup and readiness guidance for skill-only agent runtimes. Use when OpenLoomi is not yet installed, the local API is not reachable, the session/token is missing, or the user needs a manual install and launch walkthrough before using OpenLoomi skills.

- Skill: `melandlabs/openloomi-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add melandlabs/openloomi-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/melandlabs/openloomi-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Integrations & APIs
- Author: melandlabs (https://skillmd.com/u/melandlabs)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/melandlabs/openloomi-setup

---


# OpenLoomi Setup

Use this skill first when OpenLoomi readiness is unknown.

Keep it lightweight and manual-first:

- If OpenLoomi Desktop is not installed, point the user to the official
  Getting Started docs.
- If the desktop app is installed but not running, tell the user to open it.
- If the local API is not reachable, ask the user to retry after launch.
- If the token/session is missing, ask the user to complete sign-in or guest
  session setup inside OpenLoomi.

## Check Readiness

Run the bundled status script when you need a quick local check:

```bash
node "$SKILL_DIR/scripts/openloomi-setup.cjs" status
```

The script reports:

- whether OpenLoomi Desktop looks installed
- whether the local API responds on `3414` or `3515`
- whether `~/.openloomi/token` exists
- what the next manual step should be

## Output Contract

Treat `ready: true` as the handoff point to the other OpenLoomi skills:

- `openloomi-memory`
- `openloomi-connectors`
- `openloomi-loop`
- `openloomi-api`

If `ready` is false, surface the returned `nextAction` and the official
Getting Started link instead of guessing.

## Official Install Path

If the desktop app is missing, direct the user to:

- `https://openloomi.ai/docs/getting-started`
- `https://github.com/melandlabs/openloomi/releases`