@godmode-team/godmode 1.0.0 → 1.3.0

package/README.md

@@ -1,88 +1,88 @@
-# GodMode Plugin for OpenClaw
+# GodMode — Personal AI Operating System
 
-GodMode is a commercial OpenClaw plugin that adds:
+GodMode is a premium OpenClaw plugin that transforms your self-hosted AI into a personal operating system. It adds deep onboarding, daily operating rhythms, trust tracking, team workspaces, and coding orchestration on top of OpenClaw's powerful infrastructure.
 
-- Personal operating dashboard at `/godmode`
-- Goal/project/task/people data handlers
-- My Day (`agentLog.*`) and workspace tooling
-- Optional Lifetracks generation endpoints
+## What You Get
+
+- **Guided Onboarding** — Interactive setup wizard that interviews you, audits your existing configuration, and builds your personalized AI operating environment
+- **Daily Operating Rhythm** — Morning briefs with calendar + intelligence, Focus Pulse for priority tracking, evening capture and processing
+- **Consciousness Sync** — Your AI maintains a living context document that updates hourly, keeping it aware of your schedule, tasks, and current state
+- **Trust Tracker** — Rate your AI's outputs, and it learns your preferences over time. The compounding feedback loop is what makes GodMode irreplaceable
+- **Second Brain** — Markdown-based knowledge management with semantic search across all your files
+- **Team Workspaces** — Git-backed collaboration with member roles, shared memory, and automatic sync
+- **Coding Orchestration** — Dispatch code tasks to isolated worktrees with automated validation gates, PR creation, and completion notifications
+- **Safety Gates** — Built-in guardrails that prevent prompt injection, credential leaks, and runaway agent loops
+- **Support Chat** — Built-in AI support agent that knows the full system and can troubleshoot issues
 
 ## Requirements
 
-- Node 22+
-- OpenClaw `>=2026.0.0`
+- Node.js 22+
+- OpenClaw `>=2026.2.0`
+- A GodMode license key
 
-## Install
+## Quick Start
 
-From npm:
+### 1. Install the plugin
 
 ```bash
 openclaw plugins install @godmode-team/godmode
 ```
 
-From a local clone:
+### 2. Activate your license
 
 ```bash
-pnpm install
-pnpm build
-openclaw plugins install --link /absolute/path/to/godmode-plugin
+openclaw config set plugins.entries.godmode.config.licenseKey "GM-YOUR-KEY-HERE"
+openclaw config set plugins.entries.godmode.enabled true
 ```
 
-## Configure
-
-Set required license key:
+### 3. Restart the gateway
 
 ```bash
-openclaw config set plugins.entries.godmode.config.licenseKey "GM-..."
-openclaw config set plugins.entries.godmode.enabled true
+openclaw gateway restart
 ```
 
-Optional workspace root:
+### 4. Open GodMode
+
+Navigate to `http://localhost:18789/godmode` in your browser. The setup wizard will walk you through everything else.
+
+## Verify Installation
 
 ```bash
-openclaw config set plugins.entries.godmode.config.workspaceRoot "~/godmode"
+openclaw plugins list
+curl -fsS http://127.0.0.1:18789/godmode/health
 ```
 
-Restart gateway after config changes:
+## Configuration
+
+### Workspace root (default: `~/godmode`)
 
 ```bash
-openclaw gateway restart
+openclaw config set plugins.entries.godmode.config.workspaceRoot "~/godmode"
 ```
 
-## Verify
+### Coding orchestration
 
 ```bash
-openclaw plugins list
-curl -fsS http://127.0.0.1:18789/godmode/health
+openclaw config set plugins.entries.godmode.config.coding.enabled true
+openclaw config set plugins.entries.godmode.config.coding.maxParallelWriters 1
 ```
 
-Then open `http://127.0.0.1:18789/godmode`.
-
-## Build
+### Focus Pulse (daily priority tracking)
 
 ```bash
-pnpm build
+openclaw config set plugins.entries.godmode.config.focusPulse.enabled true
 ```
 
-Build outputs:
-
-- `dist/index.js` (plugin runtime entry)
-- `dist/godmode-ui/*` (UI assets)
+## Consciousness Sync
 
-`pnpm build` will bundle UI from the first available source:
+The gold heart-brain icon in chat triggers a manual consciousness sync. Press `Cmd/Ctrl+Shift+H` or click the icon to force an immediate refresh of your AI's awareness context.
 
-1. `--ui-dir <path>` passed to `scripts/bundle-ui.mjs`
-2. `dist/control-ui` in this repo
-3. `../../dist/control-ui` (monorepo build output)
-4. `assets/godmode-ui` fallback snapshot
+By default, consciousness syncs automatically every hour via a background heartbeat.
 
-## Optional Features
+## Support
 
-Lifetracks endpoints require a generation module. Set:
+Having trouble? Open the built-in support chat from the Setup tab, or reach out to your account admin.
 
-```bash
-export GODMODE_LIFETRACK_MODULE=/absolute/path/to/lifetrack/index.js
-```
+## License
 
-Agent log writer startup integration is optional and auto-detected when the
-host runtime exposes the expected module.
+Commercial software. See [LICENSE](./LICENSE) for terms.