# Openloomi

OpenLoomi entrypoint for skill-only agent runtimes without a plugin mechanism.

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

## Install

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

## Description

OpenLoomi entrypoint for skill-only agent runtimes without a plugin mechanism. Use when the user mentions OpenLoomi or Loomi, wants first-use setup guidance, wants to use local OpenLoomi memory, connectors, Loop, knowledge base, RAG search, or asks how to install OpenLoomi skills in runtimes such as WorkBuddy or other skill-capable agents.

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

# OpenLoomi Skills Entrypoint

Use this skill as the front door for OpenLoomi in agents that can load
skills but do not support OpenLoomi plugins.

OpenLoomi remains the runtime owner. The desktop app owns memory storage,
connector credentials, Loop execution, model/provider settings, local API
routes, and secret handling. Skills only explain how to route work into that
local runtime.

## First Step

When readiness is unknown, start with `openloomi-setup`. It guides the user
through installing or opening OpenLoomi Desktop, confirming the local API, and
finishing the session/token setup. Do not ask the user to paste API keys,
OAuth tokens, connector secrets, or OpenLoomi auth tokens into chat.

## Route Requests

Use the narrow OpenLoomi skill that matches the task:

| User intent | Use |
| --- | --- |
| First-use setup, install guidance, readiness checks | `openloomi-setup` |
| Search memory, knowledge base, documents, insights | `openloomi-memory` |
| Connect platforms, list accounts, check connector status, send replies | `openloomi-connectors` |
| Use third-party OAuth apps such as Slack, Gmail, GitHub, Notion, Linear, or Jira | `composio`, paired with `openloomi-connectors` |
| Inspect Loop state, run a tick, manage decisions, preferences, channels, or rules | `openloomi-loop` |
| List active Goals or inspect ordered Goal progress | `openloomi-goals` |
| Answer backend route, local API, auth, RAG, integrations, or workspace questions | `openloomi-api` |
| Explain OpenLoomi concepts, product capabilities, or user workflows | `openloomi-feature-guide` |

## Common Flows

Use these examples to route common requests without reimplementing OpenLoomi
logic in the agent:

The rest: https://github.com/melandlabs/openloomi/blob/HEAD/skills/openloomi/SKILL.md
