{"id":46471150,"url":"https://github.com/loomle/loomle","last_synced_at":"2026-05-25T09:06:51.612Z","repository":{"id":341498399,"uuid":"1169690942","full_name":"loomle/loomle","owner":"loomle","description":"LOOMLE brings Unreal Engine 5 runtime and graph context into AI-native workflows. ","archived":false,"fork":false,"pushed_at":"2026-04-25T06:54:15.000Z","size":20107,"stargazers_count":0,"open_issues_count":20,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T09:03:08.858Z","etag":null,"topics":["ai","ai-agent","ue5","ue5-plugin","unreal","unreal-engine-5"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loomle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-01T03:56:20.000Z","updated_at":"2026-04-25T06:54:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"7c9ea6f7-8395-492f-899d-d6db7cbe1c42","html_url":"https://github.com/loomle/loomle","commit_stats":null,"previous_names":["loomle/loomle"],"tags_count":105,"template":false,"template_full_name":null,"purl":"pkg:github/loomle/loomle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loomle%2Floomle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loomle%2Floomle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loomle%2Floomle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loomle%2Floomle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loomle","download_url":"https://codeload.github.com/loomle/loomle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loomle%2Floomle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32381793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T11:25:28.583Z","status":"ssl_error","status_checked_at":"2026-04-28T11:25:05.435Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ue5","ue5-plugin","unreal","unreal-engine-5"],"created_at":"2026-03-06T06:17:57.657Z","updated_at":"2026-05-25T09:06:51.606Z","avatar_url":"https://github.com/loomle.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LOOMLE\n\nAgent-native Unreal Engine MCP server for Blueprint, Material, PCG, and Widget\nworkflows.\n\nLOOMLE helps Claude Code, Codex, and other MCP-compatible coding agents operate\nlive Unreal Engine projects through tools that match UE semantics. It does not\nask agents to guess internal node classes, invent graph transformations, or\ntreat UE assets as generic JSON.\n\nUse LOOMLE when you want an AI agent to inspect or edit a real UE project,\nincluding Blueprint graphs, Material graphs, PCG graphs, UMG WidgetBlueprints,\nasset metadata, editor context, compile diagnostics, and play sessions.\n\n## What It Provides\n\n- A global `loomle mcp` command for Claude Code, Codex, and other MCP hosts.\n- A UE editor bridge installed into each project as `Plugins/LoomleBridge`.\n- UE-semantic tools for project/session setup, assets, Blueprint, Material,\n  PCG, UMG widgets, editor focus, runtime execution, diagnostics, logs, and\n  play sessions.\n- Palette-driven creation so agents use UE's own creation model instead of\n  guessing classes.\n- Compact first-level schemas with `schema.inspect` for detailed operation\n  schemas when a tool intentionally has a second layer.\n\n## Why Not Just Python?\n\nUnreal Python is useful for basic editor automation, but many valuable editor\nworkflows sit behind UE's own C++ editor APIs, graph schemas, palette actions,\nK2 nodes, pin reconstruction, compiler behavior, and asset-specific editors.\nLOOMLE exposes those workflows as explicit agent tools instead of treating the\neditor as a generic script box.\n\nThe goal is not prompt-to-game magic. The goal is a reliable UE-native control\nsurface for agents working inside existing projects.\n\n## Install\n\nmacOS and Linux:\n\n```bash\ncurl -fsSL https://loomle.ai/install.sh | bash\n```\n\nWindows PowerShell:\n\n```powershell\n\u0026 ([scriptblock]::Create((irm https://loomle.ai/install.ps1)))\n```\n\nThe installer creates a global install under `~/.loomle` by default and exposes\na stable command at `~/.loomle/bin/loomle`. MCP hosts should run:\n\n```bash\nloomle mcp\n```\n\nSee the full install guide: https://loomle.ai/install.html\n\n## Project Model\n\nLOOMLE has two installation scopes:\n\n- Global install: the `loomle` command, active version state, release payloads,\n  plugin cache, and runtime/project registry under `~/.loomle`.\n- Project install: the Unreal project plugin under `Plugins/LoomleBridge` plus\n  required project support settings.\n\nThe global install is not tied to one Unreal project. When Unreal Editor starts\nwith `LoomleBridge` loaded, the project reports a runtime endpoint. The current\nMCP session then uses `project.list` and `project.attach` to select one online\nproject.\n\nIf a project does not have LOOMLE support yet, close Unreal Editor for that\nproject and run the MCP tool `project.install` with the target `projectRoot`.\n\n## Quickstart\n\nFrom an MCP host session:\n\n1. Call `project.list` to find online projects.\n2. Call `project.attach` with the target `projectId` or `projectRoot`.\n3. Call `context` if the user already has an asset open or selected in UE.\n4. Inspect before editing.\n5. Use palettes for creation.\n6. Compile or verify after meaningful asset changes.\n\nFull quickstart: https://loomle.ai/quickstart.html\n\n## Trying LOOMLE?\n\nThe fastest useful test is:\n\n1. Install LOOMLE and configure your MCP host.\n2. Open an Unreal project.\n3. Run `project.install` if the project does not have `Plugins/LoomleBridge`.\n4. Restart Unreal Editor, then call `project.list`, `project.attach`, and\n   `context`.\n5. Try one domain inspect tool, such as `blueprint.graph.inspect`,\n   `material.graph.inspect`, `pcg.graph.inspect`, or `widget.tree.inspect`.\n\nIf anything is confusing or fails, open a\n[first user feedback issue](https://github.com/loomle/loomle/issues/new?template=first-user-feedback.yml).\nEarly feedback is especially useful when it includes the MCP host, Unreal\nversion, the first unclear step, and the tool output.\n\n## Tool Surface\n\nThe public MCP tools are grouped by UE domain:\n\n- Project and session: `loomle.status`, `project.list`, `project.attach`,\n  `project.install`, `schema.inspect`, `loomle`, `context`.\n- Assets: `asset.create`, `asset.inspect`, `asset.edit`.\n- Blueprint: class contract, members, graphs, node-local edits, palette, and\n  compile tools.\n- Material: graph, node, palette, layout, and compile tools.\n- PCG: graph, palette, node settings, graph parameters, layout, and compile\n  tools.\n- Widget: UMG palette, WidgetTree, widget inspect, and compile tools.\n- Runtime/editor/diagnostics: `execute`, `jobs`, `profiling`, `play`,\n  `editor.*`, `diagnostic.tail`, and `log.tail`.\n\nAPI reference: https://loomle.ai/tools/\n\n## Search Keywords\n\nLOOMLE is an Unreal Engine MCP server for AI agents, Claude Code, Codex,\nBlueprint MCP workflows, PCG MCP workflows, UMG / WidgetBlueprint automation,\nMaterial graph tooling, UE editor automation, and local-first Unreal agent\ntooling.\n\n## CLI\n\nThe CLI stays intentionally small:\n\n- `loomle mcp`: run the stdio MCP server.\n- `loomle update`: update the global LOOMLE install.\n- `loomle doctor`: inspect the global install and print MCP configuration hints.\n\nMCP tools are not duplicated as CLI subcommands.\n\n## Development\n\nBuild and validate the local checkout against a UE project:\n\n```bash\npython3 tools/dev_verify.py --project-root /path/to/MyProject\n```\n\nThat flow builds the Rust client, syncs `engine/LoomleBridge` into the dev\nproject, starts Unreal Editor, and validates through the checkout-built\n`loomle` binary.\n\nRelease bundles contain only:\n\n- `loomle` / `loomle.exe`\n- `plugin-cache/LoomleBridge/`\n\nThey do not include archived workspace reference material or a per-project\nclient.\n\n## Documentation\n\n- Website: https://loomle.ai/\n- Install: https://loomle.ai/install.html\n- Quickstart: https://loomle.ai/quickstart.html\n- Tools API: https://loomle.ai/tools/\n- Releases: https://github.com/loomle/loomle/releases\n\nCurrent design documents live under `docs/`. Historical notes and obsolete\nspecs are under `docs/archive/legacy/` and are not the current public contract.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floomle%2Floomle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floomle%2Floomle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floomle%2Floomle/lists"}