Openloomi Loop

What it does

When your agent uses it

• Force-refresh connector health
• Schedule / cancel decision actions
• Tune preferences
• Extend Loop with user-defined decision types

Example prompts

• “openloomi loop”
• “loop tick”
• “loop schedule”
• “/openloomi-loop”

Requirements

• Pre-approved tools (allowed-tools): Bash(curl *), Bash(jq *), Bash(cat ~/.openloomi/token *), Bash(base64 -d *), Bash(ls ~/.openloomi/loop/*)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Confirm the refresh actually fired. Every fetchedAt should
2. 2Summarize. One line per connector: gmail ✅ / `slack ❌
3. 3Surface lastError verbatim when something is still red. Do
4. 4The refreshed snapshot is now the cache. Subsequent

What it can do on your machine

Read from SKILL.md and the folder at commit 2aca101. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(curl *)
  • Bash(jq *)
  • Bash(cat ~/.openloomi/token *)
  • Bash(base64 -d *)
  • Bash(ls ~/.openloomi/loop/*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • curl
  • jq
  • pnpm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • openloomi.ai

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openloomi Loop loads about 3.8k tokens when it runs. Until then it costs about 228 tokens; SKILL.md has 1,188 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~228

When it runs · the whole SKILL.md, loaded when a task matches

~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from melandlabs/openloomi at commit 2aca101, republished under its Apache-2.0 licence (© melandlabs). 1,188 words, ~3,828 tokens.

name

openloomi-loop

description

openloomi's Loop — the proactive execution brain that runs inside the OpenLoomi desktop app. Use this skill to inspect state, force-refresh connector health, run a tick, schedule / cancel decision actions, tune preferences, and extend Loop with user-defined decision types, Composio-backed signal channels, or deterministic classifier rules. Triggers: 'openloomi loop', 'loop tick', 'loop schedule', 'loop inbox', 'loop run', 'loop refresh', 'refresh connectors', 'force refresh connectors', 'check connections', 'check loop connectors', 'connector health', 'proactive decisions', 'signal → decision → execute', 'pull signals', 'decision queue', 'register loop type', 'add loop decision type', 'register custom channel', 'add composio channel', 'add loop rule', 'register classifier rule', 'force loop type', 'dry-run loop rule', 'list my loop extensions', 'remove loop type', 'delete loop channel'

allowed-tools

Bash(curl *), Bash(jq *), Bash(cat ~/.openloomi/token *), Bash(base64 -d *), Bash(ls ~/.openloomi/loop/*)

TOKEN=$(cat ~/.openloomi/token | base64 -d)

BASE="http://localhost:3414"   # or http://localhost:3515
TOKEN=$(cat ~/.openloomi/token | base64 -d)

# Dashboard snapshot
curl -sS "$BASE/api/loop/state" -H "Authorization: Bearer $TOKEN" | jq .

# Run one tick
curl -sS -X POST "$BASE/api/loop/tick" -H "Authorization: Bearer $TOKEN"

# List pending decisions
curl -sS "$BASE/api/loop/decisions?status=pending" \
  -H "Authorization: Bearer $TOKEN" | jq .

# Read a single decision / card
curl -sS "$BASE/api/loop/decision/dec_xxx" -H "Authorization: Bearer $TOKEN"
curl -sS "$BASE/api/loop/card/dec_xxx"      -H "Authorization: Bearer $TOKEN"

# Run a decision (returns action_id; cron fires it ~30s later)
curl -sS -X POST "$BASE/api/loop/action/schedule" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"decision_id":"dec_xxx","action":"run"}'

# Cancel before it fires
curl -sS -X DELETE "$BASE/api/loop/action/<action_id>" \
  -H "Authorization: Bearer $TOKEN"

# Force a brief / wrap card now
curl -sS -X POST "$BASE/api/loop/brief" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"force":true}'

# Tune preferences (intervalSec, briefTime, timezone, ...)
curl -sS -X PUT "$BASE/api/loop/preferences" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"intervalSec":300,"briefTime":"08:30","wrapTime":"22:30","timezone":"Asia/Shanghai"}'

# Refresh connector probes
curl -sS "$BASE/api/loop/connectors?refresh=1" -H "Authorization: Bearer $TOKEN"

# Register a custom decision type
curl -sS -X PUT "$BASE/api/loop/types" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"id":"birthday_wish","label":"Birthday wish","icon":"ri-cake-2-line","actionKind":"email_reply"}'

# Register a Composio-backed channel
curl -sS -X PUT "$BASE/api/loop/channels" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"id":"stripe_charges","label":"Stripe charges","toolkit":"stripe","toolSlug":"STRIPE_LIST_CHARGES","pollIntervalSec":900,"signalType":"stripe_charge"}'

# Register a deterministic classifier rule — forces same-day birthdays
# into the `birthday_wish` type even if the LLM drifts
curl -sS -X PUT "$BASE/api/loop/classifier-rules" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{
    "id":"force_birthday_today",
    "when":[
      {"field":"signal.type","op":"eq","value":"contact_birthday"},
      {"field":"signal.payload.daysUntilNext","op":"eq","value":0}
    ],
    "then":{"type":"birthday_wish","actionKind":"email_reply","confidence":0.9}
  }'

# Preview which rules match a signal without running a tick
curl -sS -X POST "$BASE/api/loop/classifier-rules/dry-run" \
  -H "Authorization: Bearer $TOKEN" \
  -H "content-type: application/json" \
  -d '{"signal":{"type":"contact_birthday","payload":{"daysUntilNext":0}}}'

curl -sS "$BASE/api/loop/connectors?refresh=1" \
  -H "Authorization: Bearer $TOKEN" | jq .

© melandlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/codex/skills/openloomi-loop of melandlabs/openloomi.

Open the folder on GitHubat commit 2aca101