Skip to content

PR-1: rename ClawDnD→WorldOS (Wave 1+2 — plugin/app/docs/branding) - #296

Merged
100yenadmin merged 1 commit into
mainfrom
chore/rename-worldos-pr1
May 29, 2026
Merged

PR-1: rename ClawDnD→WorldOS (Wave 1+2 — plugin/app/docs/branding)#296
100yenadmin merged 1 commit into
mainfrom
chore/rename-worldos-pr1

Conversation

@100yenadmin

@100yenadmin 100yenadmin commented May 29, 2026

Copy link
Copy Markdown
Member

Part of #295. Wave 1 (plugin.json, marketplace, LICENSE, build script, macos/WorldOSApp Swift rename) + Wave 2 (README/CHANGELOG/CLAUDE.md/doc+script+icon renames). Bundle ID kept dev.clawdnd.app (W0-B). Engine refs + env vars deferred to PR-2/PR-3. Validation: swift build clean, plugin.json asserted, license clean, --axe PASS.

Also fixed three rename-consequence breakages so the build/CI/launchers keep working: .github/workflows/macos-swift.yml + .gitignore now point at macos/WorldOSApp; scripts/install-desktop-shortcut.sh + scripts/launch_common.sh now reference worldos-*.command.

Kept as live wire contracts (deferred to PR-2/PR-3): CLAWDND_* env vars, the 'clawdnd' WebView message channel + window.ClawDnDNative bridge (paired with out-of-scope viewer/openworlds JSX), the clawdnd-engine/rules/voice MCP server ids, and the /Users/lume/ClawDnD-val checkout dir.

Deferred (Wave 3 doc sweep, intentionally untouched): clawdnd-.command refs in commands/.md and viewer/dashboard.html (legacy dashboard); macos/ClawDnDApp path refs in docs/*.md; historical CHANGELOG body entries.

Summary by CodeRabbit

Chores

  • Rebranded entire project from ClawDnD to WorldOS, including updated marketplace metadata, licenses, and documentation
  • Renamed macOS application bundle and deployment commands (worldos-play.command, worldos-dashboard.command, worldos-monitor.command)
  • Updated all user-facing strings, error messages, and UI text throughout the application
  • Updated build configuration, CI/CD workflows, and project ownership to electricsheephq

Review Change Stack

Wave 1 (load-bearing):
- .claude-plugin/plugin.json + marketplace.json: name/owner/repo/homepage/
  description → worldos / electricsheephq / WorldOS framing.
- LICENSE: copyright 100yenadmin → electricsheephq (MIT unchanged).
- script/build_and_run.sh: APP_NAME/DISPLAY_NAME → WorldOS, icon path;
  BUNDLE_ID kept dev.clawdnd.app (W0-B — changing it orphans installs).
- macos/ClawDnDApp → macos/WorldOSApp (git mv, incl. Sources/ + App file);
  Package.swift + @main struct + display/log strings → WorldOS.

Wave 2 (branding):
- README/CHANGELOG/THIRD_PARTY_NOTICES/CLAUDE.md: name + URL updates,
  README + CLAUDE.md rewritten to WorldOS framing.
- git mv ClawDnD-RUNBOOK/NORTH-STAR → WorldOS-*, clawdnd-*.command →
  worldos-*.command, assets/icon/ClawDnD.icns → WorldOS.icns (+ self-refs).

Rename-consequence fixes (kept the build/CI/launchers working):
- .github/workflows/macos-swift.yml + .gitignore → macos/WorldOSApp path.
- scripts/install-desktop-shortcut.sh + launch_common.sh → worldos-*.command.

Kept as live wire contracts (deferred to PR-2/PR-3): CLAWDND_* env vars,
the 'clawdnd' WebView message channel + window.ClawDnDNative bridge (paired
with out-of-scope JSX), the clawdnd-engine/rules/voice MCP server ids, the
dev.clawdnd.app bundle id, and the /Users/lume/ClawDnD-val checkout dir.

Part of #295.
@coderabbitai

coderabbitai Bot commented May 29, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

This PR performs a complete rebranding of the ClawDnD project to WorldOS, renaming the plugin identity, macOS app executable structure, build configuration, shell launchers, and updating all project documentation and legal notices to reflect the new name and owner (electricsheephq).

Changes

WorldOS Rebranding

Layer / File(s) Summary
Plugin manifest rebranding
.claude-plugin/marketplace.json, .claude-plugin/plugin.json
Plugin marketplace and core manifests updated with WorldOS name, new owner (electricsheephq), and updated homepage/repository URLs.
Build configuration and CI/CD
.github/workflows/macos-swift.yml, .gitignore, script/build_and_run.sh
GitHub Actions workflow paths and build scripts updated to monitor and build macos/WorldOSApp/ directory; icon asset references changed from ClawDnD to WorldOS; Info.plist icon identifiers updated.
macOS native app structure and Swift sources
macos/WorldOSApp/Package.swift, macos/WorldOSApp/Sources/WorldOSApp/App/WorldOSApp.swift, macos/WorldOSApp/Sources/WorldOSApp/Services/{AppProcessService,ProviderAdapters,RepositoryLocator}.swift, macos/WorldOSApp/Sources/WorldOSApp/Views/{PlayView,ProvidersView,RootView,SettingsView,WebView}.swift
SwiftPM package and app entry point renamed from ClawDnDApp to WorldOSApp; service error messages, diagnostics, repo path candidates, and UI alert/title text updated to reference WorldOS; provider detection status strings updated.
Release process documentation
macos/WorldOSApp/RELEASE_CHECKLIST.md
Release checklist updated to reference dist/WorldOS.app for signing and Gatekeeper verification.
Shell launcher commands and installation
worldos-play.command, worldos-dashboard.command, worldos-monitor.command, scripts/install-desktop-shortcut.sh, scripts/launch_common.sh
User-facing launcher scripts and desktop shortcut installer updated with WorldOS branding; command filenames and baked-in launcher references changed from clawdnd to worldos; startup messages and status alerts reflect WorldOS naming.
Project documentation, licensing, and legal notices
README.md, CHANGELOG.md, LICENSE, CLAUDE.md, THIRD_PARTY_NOTICES.md, WorldOS-NORTH-STAR.md, WorldOS-RUNBOOK.md
All project documentation updated with WorldOS branding; repository URLs changed to electricsheephq/WorldOS; licensing header updated; CLAUDE.md adds explicit guidance to preserve legacy clawdnd contract identifiers and notes that CLAWDND_* env vars are current with WORLDOS_* aliases planned.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related issues

Possibly related PRs

  • electricsheephq/WorldOS#83: The main PR is a branding/rename update of the native app shell introduced in PR #83—modifying the same Swift app modules/functions (AppProcessService, RepositoryLocator, ProviderAdapters, PlayView, WebView, and launcher/script naming) to switch identifiers/paths/messages from ClawDnD/repos/ClawDnD to WorldOS/repos/WorldOS.

Poem

🐰 A whisker-twitch, a name anew—
From Claw to World, the threads run through,
Through manifests and Swift, scripts sing,
Old branding out, new glory in! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: a multi-wave product rename from ClawDnD to WorldOS covering plugins, native app, documentation, and branding updates.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 7: Update the README's release status string so it matches the latest
changelog/release (replace the visible "**v1.0.1** (2026-05-28)" text with the
current release version/date, e.g., "**v1.0.2** (2026-05-29)"); locate the exact
token "**v1.0.1**" in README.md (the big status paragraph) and update the
version/date and any adjacent release link or reference if needed to point to
the v1.0.2 release URL so the README and changelog are consistent.
- Line 115: The fenced code block in README.md is missing a language tag which
triggers markdownlint MD040; update the backtick fence that contains the
commands "/plugin marketplace add ." and "/plugin install worldos@worldos" to
include an explicit language tag (e.g., text or bash) so the block becomes
```text (or ```bash) followed by the same lines and closing ``` to satisfy the
linter.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 38a02aaf-24fc-49ac-94d5-d969a2bd0fc8

📥 Commits

Reviewing files that changed from the base of the PR and between 3eee923 and 4ff2751.

📒 Files selected for processing (43)
  • .claude-plugin/marketplace.json
  • .claude-plugin/plugin.json
  • .github/workflows/macos-swift.yml
  • .gitignore
  • CHANGELOG.md
  • CLAUDE.md
  • LICENSE
  • README.md
  • THIRD_PARTY_NOTICES.md
  • WorldOS-NORTH-STAR.md
  • WorldOS-RUNBOOK.md
  • assets/icon/WorldOS.icns
  • macos/WorldOSApp/Package.swift
  • macos/WorldOSApp/RELEASE_CHECKLIST.md
  • macos/WorldOSApp/Sources/WorldOSApp/App/WorldOSApp.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Models/AppSection.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Models/CampaignSummary.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Models/DependencyStatus.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Models/LocalEndpoint.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Models/ProviderModels.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/AppProcessService.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/CampaignStore.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/DependencyChecker.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/Diagnostics.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/PortFinder.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/ProviderAdapters.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/RepositoryLocator.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Services/Shell.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/CampaignsView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/EmptyStateView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/LogsView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/MonitorView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/PlayView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/ProvidersView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/RootView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/SettingsView.swift
  • macos/WorldOSApp/Sources/WorldOSApp/Views/WebView.swift
  • script/build_and_run.sh
  • scripts/install-desktop-shortcut.sh
  • scripts/launch_common.sh
  • worldos-dashboard.command
  • worldos-monitor.command
  • worldos-play.command

Comment thread README.md
WorldOS is a Claude Code plugin. It simulates persistent, canon-anchored worlds whose standing threads move on their own — and lets you drop in and *play* a full D&D 5e adventure inside them. You don't play *against* the AI; you go on an adventure *with* it. A Dungeon Master narrates the world and voices every NPC, and a companion party member adventures alongside you — with its own character sheet, personality, voice, and agency. Dice and rules are deterministic (never hallucinated), worlds and campaigns persist across sessions, and every line is spoken aloud.

> **Status:** **v1.0.1** ([Release](https://github.com/100yenadmin/ClawDnD/releases/tag/v1.0.1), 2026-05-28). Tier-1 **plus a living-world generative engine plus a native macOS desktop app (OpenWorlds)** — built and green in CI: **engine 1385/1385 ✓, viewer 90/90 ✓**, license-check clean. The full deterministic stack (dice, characters, combat with tactical zones / monster Multiattack / Parry reactions / end-of-turn repeat saves, full SRD 5.2.1 spellcasting, rests, inventory/economy, NPC memory + companion dossiers, encounters, persistence, voice) runs under an AI DM that **generates epic, mature, Baldur's-Gate-caliber stories live inside persistent, canon-anchored worlds** — grounded by on-demand lore lookup, a searchable campaign memory, chronology, standing threads that move on their own, and a 2,076-record canon roster for the Sword Coast (the seven BG3 origin heroes carry full companion-dossier seeds for the engine's living-world systems). QA-scored on a story-craft lens (≥4.3/5, prestige-fantasy). The OpenWorlds desktop app renders 14 polished screens (Launcher / Table / Combat / Map / Character / Inventory / Relations / Dialogue / Forge / Merchant / Bestiary / Journal / Acts / World Seed / Create / Settings), all data-bound to live read-models; the Merchant BUY and Forge Craft buttons relay structured `/move` intents to the DM during a live session. Tier 2 (OpenClaw companion fork) remains the optional gateway milestone. See the [issues](https://github.com/100yenadmin/ClawDnD/issues) for the roadmap.
> **Status:** **v1.0.1** ([Release](https://github.com/electricsheephq/WorldOS/releases/tag/v1.0.1), 2026-05-28). Tier-1 **plus a living-world generative engine plus a native macOS desktop app (OpenWorlds)** — built and green in CI: **engine 1385/1385 ✓, viewer 90/90 ✓**, license-check clean. The full deterministic stack (dice, characters, combat with tactical zones / monster Multiattack / Parry reactions / end-of-turn repeat saves, full SRD 5.2.1 spellcasting, rests, inventory/economy, NPC memory + companion dossiers, encounters, persistence, voice) runs under an AI DM that **generates epic, mature, Baldur's-Gate-caliber stories live inside persistent, canon-anchored worlds** — grounded by on-demand lore lookup, a searchable campaign memory, chronology, standing threads that move on their own, and a 2,076-record canon roster for the Sword Coast (the seven BG3 origin heroes carry full companion-dossier seeds for the engine's living-world systems). QA-scored on a story-craft lens (≥4.3/5, prestige-fantasy). The OpenWorlds desktop app renders 14 polished screens (Launcher / Table / Combat / Map / Character / Inventory / Relations / Dialogue / Forge / Merchant / Bestiary / Journal / Acts / World Seed / Create / Settings), all data-bound to live read-models; the Merchant BUY and Forge Craft buttons relay structured `/move` intents to the DM during a live session. Tier 2 (OpenClaw companion fork) remains the optional gateway milestone. See the [issues](https://github.com/electricsheephq/WorldOS/issues) for the roadmap.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Update README status/version to match current release docs.

README still says v1.0.1 (2026-05-28), but the changelog already contains 1.0.2 dated 2026-05-29. This creates release-state ambiguity for users.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 7, Update the README's release status string so it matches
the latest changelog/release (replace the visible "**v1.0.1** (2026-05-28)" text
with the current release version/date, e.g., "**v1.0.2** (2026-05-29)"); locate
the exact token "**v1.0.1**" in README.md (the big status paragraph) and update
the version/date and any adjacent release link or reference if needed to point
to the v1.0.2 release URL so the README and changelog are consistent.

Comment thread README.md

Then inside Claude Code, register the local marketplace and install the plugin:

```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a language tag to this fenced code block.

This block trips markdownlint MD040 and should be tagged (for example, text or bash depending on intent).

Suggested patch
-```
+```text
 /plugin marketplace add .
 /plugin install worldos@worldos
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 115-115: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` at line 115, The fenced code block in README.md is missing a
language tag which triggers markdownlint MD040; update the backtick fence that
contains the commands "/plugin marketplace add ." and "/plugin install
worldos@worldos" to include an explicit language tag (e.g., text or bash) so the
block becomes ```text (or ```bash) followed by the same lines and closing ``` to
satisfy the linter.

@100yenadmin
100yenadmin merged commit 894b35f into main May 29, 2026
8 checks passed
@100yenadmin
100yenadmin deleted the chore/rename-worldos-pr1 branch May 29, 2026 15:30
100yenadmin added a commit that referenced this pull request May 29, 2026
…301)

Final phase of #295 (PR-1 #296, PR-2 #299, PR-3 #300 merged):
- plugin.json 1.0.2 -> 1.0.3
- CHANGELOG [1.0.3]: the rename across 4 phased PRs + non-breaking WORLDOS_*/CLAWDND_* env layer + preserved wire contracts + carried UI fixes
- SCORECARD v1.0.3 release note (honest standing scores; Caelar fix = code+#162 invariant+GUI, not a fresh duo)

Doc/JSON only - no engine logic change.

Co-authored-by: Eva <eva@100yen.org>
100yenadmin added a commit that referenced this pull request Jun 17, 2026
…#982)

First phase of the owner-approved full ClawDnD→WorldOS cutover (the v1.0.3 rename
shipped #296/#299/#300/#301 but left brand-prose stragglers). This renames ONLY the
brand token in prose/docs/flavor/command+skill descriptions and user-facing status
strings — surgically PRESERVING every retained contract and historical record:

KEPT (moved in later phases / immutable): clawdnd-engine/-rules/-voice/-player MCP ids,
CLAWDND_* env vars, dev.clawdnd.app, ClawDnD-val path, ClawDnDNative web-bridge,
lowercase clawdnd_* shell/py functions; and the historical/legal text (CHANGELOG,
qa/SCORECARD.md, LICENSE trademark list, servers/*/_env.py "renamed from ClawDnD"
explanation, docs/roadmap/SPRINT_MAP.md, qa/transcripts/*).

Transform: collapse dual "WorldOS / ClawDnD" → "WorldOS", then ClawDnD→WorldOS with a
negative lookahead preserving -val/Native suffixes; applied to an explicit allowlist of
30 brand-prose files only.

Gates: license_check pass; bash -n clean on all touched scripts; both adventure.json
still valid JSON; spot-checked that DM SKILL.md keeps clawdnd-engine/rules/voice and
play.sh keeps CLAWDND_PLAY_* + clawdnd_write_provider_status.

Co-authored-by: Eva <arncalso@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant