@godmode-team/godmode 1.7.2 → 1.8.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +94 -46
- package/README.md +190 -36
- package/assets/agent-roster/competitor-watch.md +40 -0
- package/assets/agent-roster/content-writer.md +35 -53
- package/assets/agent-roster/godmode-builder.md +2 -2
- package/assets/agent-roster/inbox-manager.md +38 -0
- package/assets/agent-roster/meeting-prep.md +40 -16
- package/assets/agent-roster/skill-optimizer.md +50 -0
- package/assets/agent-roster/weekly-review.md +42 -0
- package/assets/skills/autoresearch.md +1 -1
- package/assets/skills/pattern-scout.md +1 -1
- package/assets/skills/visual-qa.md +128 -0
- package/dist/godmode-ui/aeo.html +1 -1
- package/dist/godmode-ui/assets/brain-tab-Z-Uwg6EX.js +402 -0
- package/dist/godmode-ui/assets/connections-tab-DhJWQQBw.js +91 -0
- package/dist/godmode-ui/assets/ctrl-settings-niym-WgY.js +5 -0
- package/dist/godmode-ui/assets/dashboards-tab-D22kRTMW.js +137 -0
- package/dist/godmode-ui/assets/index-Covj4w7X.js +1994 -0
- package/dist/godmode-ui/assets/index-DmEmOd0w.css +1 -0
- package/dist/godmode-ui/assets/lit-core-CTInmNPB.js +3 -0
- package/dist/godmode-ui/assets/markdown-i_gIkIP3.js +59 -0
- package/dist/godmode-ui/assets/second-brain-tab-BINrzjjx.js +350 -0
- package/dist/godmode-ui/assets/setup-BnLadXY9.js +1 -0
- package/dist/godmode-ui/assets/team-tab-DE4DvNCS.js +296 -0
- package/dist/godmode-ui/assets/today-tab-BExVN_cu.js +209 -0
- package/dist/godmode-ui/assets/views-settings-nvLQdpIB.js +4643 -0
- package/dist/godmode-ui/assets/work-tab-DOrlU-Ge.js +1 -0
- package/dist/godmode-ui/assets/workspaces-C8dKMKC1.js +718 -0
- package/dist/godmode-ui/index.html +11 -5
- package/dist/index.js +1658 -36092
- package/dist/mcp-entry.js +1272 -0
- package/dist/standalone.js +1917 -0
- package/openclaw.plugin.json +36 -7
- package/package.json +25 -11
- package/scripts/godmode-gateway.service +41 -0
- package/scripts/install-systemd.sh +99 -0
- package/skill-cards/adversarial-board.md +63 -0
- package/skill-cards/autoresearch.md +39 -0
- package/skill-cards/bill-review.md +26 -0
- package/skill-cards/calendar.md +32 -0
- package/skill-cards/code-quality.md +31 -0
- package/skill-cards/competitor-scan.md +26 -0
- package/skill-cards/content-generation.md +26 -0
- package/skill-cards/context-deep-dive.md +65 -0
- package/skill-cards/cron-workflows.md +33 -0
- package/skill-cards/dashboards.md +38 -0
- package/skill-cards/delegate.md +57 -0
- package/skill-cards/files.md +38 -0
- package/skill-cards/godmode-builder.md +58 -0
- package/skill-cards/inbox-sweep.md +26 -0
- package/skill-cards/integrations.md +40 -0
- package/skill-cards/life-admin.md +26 -0
- package/skill-cards/meetings.md +42 -0
- package/skill-cards/meta-problem-solver.md +52 -0
- package/skill-cards/people.md +39 -0
- package/skill-cards/personal-brand.md +71 -0
- package/skill-cards/project-orchestrator.md +97 -0
- package/skill-cards/project-pipeline.md +78 -0
- package/skill-cards/proof-editor.md +28 -0
- package/skill-cards/quality-gate.md +57 -0
- package/skill-cards/quarterly-review.md +26 -0
- package/skill-cards/queue.md +40 -0
- package/skill-cards/screenpipe.md +49 -0
- package/skill-cards/second-brain.md +46 -0
- package/skill-cards/standup-prep.md +26 -0
- package/skill-cards/tasks.md +34 -0
- package/skill-cards/visual-qa.md +56 -0
- package/skill-cards/workspace-memory.md +51 -0
- package/skill-cards/x-twitter.md +37 -0
- package/dist/godmode-ui/assets/dashboards-CrT3s0NG.js +0 -1
- package/dist/godmode-ui/assets/index-BtwTHiwI.js +0 -9353
- package/dist/godmode-ui/assets/index-xiAdnGJD.css +0 -1
- package/dist/godmode-ui/assets/options-QuHclvvX.js +0 -1
- package/dist/godmode-ui/assets/second-brain-ghSM5E6X.js +0 -1
- package/dist/godmode-ui/assets/setup-CWjMtnE4.js +0 -1
- package/dist/godmode-ui/consciousness-icon-64.png +0 -0
- package/dist/godmode-ui/consciousness-icon.png +0 -0
- package/dist/godmode-ui/godmode-logo.png +0 -0
package/LICENSE
CHANGED
|
@@ -1,62 +1,110 @@
|
|
|
1
|
-
|
|
2
|
-
Copyright (c) 2026 GodMode Team. All rights reserved.
|
|
1
|
+
# Functional Source License, Version 1.1, MIT Future License
|
|
3
2
|
|
|
4
|
-
|
|
5
|
-
distribution, modification, or use of this software, in whole or in part, is
|
|
6
|
-
strictly prohibited.
|
|
3
|
+
## Abbreviation
|
|
7
4
|
|
|
8
|
-
1.
|
|
5
|
+
FSL-1.1-MIT
|
|
9
6
|
|
|
10
|
-
|
|
11
|
-
these terms, you are granted a limited, non-exclusive, non-transferable,
|
|
12
|
-
revocable license to install and use one (1) copy of the GodMode plugin
|
|
13
|
-
on a single OpenClaw installation.
|
|
7
|
+
## Notice
|
|
14
8
|
|
|
15
|
-
|
|
16
|
-
OpenClaw installation.
|
|
9
|
+
Copyright 2026 GodMode Team
|
|
17
10
|
|
|
18
|
-
|
|
11
|
+
## Terms and Conditions
|
|
19
12
|
|
|
20
|
-
|
|
21
|
-
(a) Copy, redistribute, sublicense, sell, or transfer this software or
|
|
22
|
-
any portion of it to any third party.
|
|
23
|
-
(b) Reverse engineer, decompile, disassemble, or attempt to derive the
|
|
24
|
-
source code.
|
|
25
|
-
(c) Create derivative works based on this software.
|
|
26
|
-
(d) Remove or alter any copyright notices, license keys, or proprietary
|
|
27
|
-
markings.
|
|
28
|
-
(e) Circumvent, disable, or interfere with the license validation
|
|
29
|
-
mechanism.
|
|
30
|
-
(f) Share your license key with any other person or entity.
|
|
13
|
+
### Licensor ("We")
|
|
31
14
|
|
|
32
|
-
|
|
15
|
+
The party offering the Software under these Terms and Conditions.
|
|
33
16
|
|
|
34
|
-
|
|
35
|
-
cancellation, a 24-hour grace period is provided, after which the plugin
|
|
36
|
-
will cease to function.
|
|
17
|
+
### The Software
|
|
37
18
|
|
|
38
|
-
|
|
39
|
-
|
|
19
|
+
The "Software" is each version of the software that we make available under
|
|
20
|
+
these Terms and Conditions, as indicated by our inclusion of these Terms and
|
|
21
|
+
Conditions with the Software.
|
|
40
22
|
|
|
41
|
-
|
|
23
|
+
### License Grant
|
|
42
24
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
25
|
+
Subject to your compliance with this License Grant and the Patents,
|
|
26
|
+
Redistribution and Trademark clauses below, we hereby grant you the right to
|
|
27
|
+
use, copy, modify, create derivative works, publicly perform, publicly display
|
|
28
|
+
and redistribute the Software for any Permitted Purpose identified below.
|
|
46
29
|
|
|
47
|
-
|
|
30
|
+
### Permitted Purpose
|
|
48
31
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
32
|
+
A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
|
|
33
|
+
means making the Software available to others in a commercial product or
|
|
34
|
+
service that:
|
|
52
35
|
|
|
53
|
-
|
|
36
|
+
1. substitutes for the Software;
|
|
54
37
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
INABILITY TO USE THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
58
|
-
SUCH DAMAGES.
|
|
38
|
+
2. substitutes for any other product or service we offer using the Software
|
|
39
|
+
that exists as of the date we make the Software available; or
|
|
59
40
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
41
|
+
3. offers the same or substantially similar functionality as the Software.
|
|
42
|
+
|
|
43
|
+
Permitted Purposes specifically include using the Software:
|
|
44
|
+
|
|
45
|
+
1. for your internal use and access;
|
|
46
|
+
|
|
47
|
+
2. for non-commercial education;
|
|
48
|
+
|
|
49
|
+
3. for non-commercial research; and
|
|
50
|
+
|
|
51
|
+
4. in connection with professional services that you provide to a licensee
|
|
52
|
+
using the Software in accordance with these Terms and Conditions.
|
|
53
|
+
|
|
54
|
+
### Patents
|
|
55
|
+
|
|
56
|
+
To the extent your use for a Permitted Purpose would necessarily infringe our
|
|
57
|
+
patents, the license grant above includes a license under our patents. If you
|
|
58
|
+
make a claim against any party that the Software infringes or contributes to
|
|
59
|
+
the infringement of any patent, then your patent license to the Software ends
|
|
60
|
+
immediately.
|
|
61
|
+
|
|
62
|
+
### Redistribution
|
|
63
|
+
|
|
64
|
+
The Terms and Conditions apply to all copies, modifications and derivatives of
|
|
65
|
+
the Software.
|
|
66
|
+
|
|
67
|
+
If you redistribute any copies, modifications or derivatives of the Software,
|
|
68
|
+
you must include a copy of or a link to these Terms and Conditions and not
|
|
69
|
+
remove any copyright notices provided in or with the Software.
|
|
70
|
+
|
|
71
|
+
### Disclaimer
|
|
72
|
+
|
|
73
|
+
THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
|
|
74
|
+
IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
|
|
75
|
+
PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
|
|
76
|
+
|
|
77
|
+
IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
|
|
78
|
+
SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
|
|
79
|
+
EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
|
|
80
|
+
|
|
81
|
+
### Trademarks
|
|
82
|
+
|
|
83
|
+
Except for displaying the License Details and identifying us as the origin of
|
|
84
|
+
the Software, you have no right under these Terms and Conditions to use our
|
|
85
|
+
trademarks, trade names, service marks or product names.
|
|
86
|
+
|
|
87
|
+
## Grant of Future License
|
|
88
|
+
|
|
89
|
+
We hereby irrevocably grant you an additional license to use the Software under
|
|
90
|
+
the MIT license that is effective on the second anniversary of the date we make
|
|
91
|
+
the Software available. On or after that date, you may use the Software under
|
|
92
|
+
the MIT license, in which case the following will apply:
|
|
93
|
+
|
|
94
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
95
|
+
this software and associated documentation files (the "Software"), to deal in
|
|
96
|
+
the Software without restriction, including without limitation the rights to
|
|
97
|
+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
98
|
+
of the Software, and to permit persons to whom the Software is furnished to do
|
|
99
|
+
so, subject to the following conditions:
|
|
100
|
+
|
|
101
|
+
The above copyright notice and this permission notice shall be included in all
|
|
102
|
+
copies or substantial portions of the Software.
|
|
103
|
+
|
|
104
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
105
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
106
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
107
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
108
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
109
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
110
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,88 +1,242 @@
|
|
|
1
1
|
# GodMode — Personal AI Operating System
|
|
2
2
|
|
|
3
|
-
GodMode
|
|
3
|
+
GodMode turns your self-hosted AI into a personal operating system. It runs on top of [OpenClaw](https://github.com/nichochar/openclaw) and gives your AI deep context about you — your schedule, tasks, memory, skills, and preferences — so it actually works *for* you instead of starting from scratch every conversation.
|
|
4
|
+
|
|
5
|
+
**Open source. Self-hosted. Yours.**
|
|
4
6
|
|
|
5
7
|
## What You Get
|
|
6
8
|
|
|
7
|
-
- **
|
|
8
|
-
- **Daily Operating Rhythm** — Morning briefs with calendar + intelligence,
|
|
9
|
-
- **
|
|
10
|
-
- **
|
|
11
|
-
- **
|
|
12
|
-
- **
|
|
13
|
-
- **
|
|
14
|
-
- **
|
|
15
|
-
- **Support Chat** — Built-in AI support agent that knows the full system and can troubleshoot issues
|
|
9
|
+
- **Persistent Memory** — Your AI remembers conversations, facts, and preferences across sessions (powered by [Honcho](https://honcho.dev))
|
|
10
|
+
- **Daily Operating Rhythm** — Morning briefs with calendar + intelligence, task tracking, evening capture
|
|
11
|
+
- **Agent Queue** — Delegate tasks to background agents that run overnight and deliver results to your inbox
|
|
12
|
+
- **Second Brain** — Markdown-based knowledge management with semantic search across your Obsidian vault
|
|
13
|
+
- **Skill Cards** — Teach your AI new capabilities by dropping markdown files into a folder
|
|
14
|
+
- **Persona System** — Customizable agent personas for different task types (research, writing, code, etc.)
|
|
15
|
+
- **Safety Gates** — Built-in guardrails that prevent prompt injection, credential leaks, and runaway loops
|
|
16
|
+
- **Self-Healing** — Automatic health monitoring and recovery for all subsystems
|
|
16
17
|
|
|
17
|
-
##
|
|
18
|
+
## Quick Start
|
|
18
19
|
|
|
19
|
-
|
|
20
|
-
- OpenClaw `>=2026.2.0`
|
|
21
|
-
- A GodMode license key
|
|
20
|
+
### Prerequisites
|
|
22
21
|
|
|
23
|
-
|
|
22
|
+
- **Node.js 22+** (check with `node -v`, use [nvm](https://github.com/nvm-sh/nvm) to install)
|
|
23
|
+
- **pnpm** (`npm install -g pnpm`)
|
|
24
|
+
- **OpenClaw** `>=2026.2.0` ([install guide](https://github.com/nichochar/openclaw))
|
|
25
|
+
- **Anthropic API key** ([get one here](https://console.anthropic.com))
|
|
24
26
|
|
|
25
|
-
###
|
|
27
|
+
### Option A: One-Line Install (recommended)
|
|
26
28
|
|
|
27
29
|
```bash
|
|
28
|
-
|
|
30
|
+
curl -fsSL https://lifeongodmode.com/install.sh | sh
|
|
29
31
|
```
|
|
30
32
|
|
|
31
|
-
|
|
33
|
+
This handles everything — Node.js, OpenClaw, GodMode plugin, gateway config, and Tailscale (if present). Safe to re-run.
|
|
34
|
+
|
|
35
|
+
Windows: `irm https://lifeongodmode.com/install.ps1 | iex`
|
|
36
|
+
|
|
37
|
+
### Option B: Install as OpenClaw Plugin
|
|
32
38
|
|
|
33
39
|
```bash
|
|
34
|
-
|
|
40
|
+
# Install the plugin
|
|
41
|
+
openclaw plugins install @godmode-team/godmode
|
|
42
|
+
|
|
43
|
+
# Enable it
|
|
35
44
|
openclaw config set plugins.entries.godmode.enabled true
|
|
45
|
+
|
|
46
|
+
# Restart the gateway
|
|
47
|
+
openclaw gateway restart
|
|
48
|
+
|
|
49
|
+
# Open GodMode
|
|
50
|
+
open http://localhost:18789/godmode
|
|
36
51
|
```
|
|
37
52
|
|
|
38
|
-
###
|
|
53
|
+
### Option C: Clone and Build from Source
|
|
39
54
|
|
|
40
55
|
```bash
|
|
56
|
+
# Clone and build
|
|
57
|
+
git clone https://github.com/GodMode-Team/godmode.git
|
|
58
|
+
cd godmode
|
|
59
|
+
pnpm install
|
|
60
|
+
pnpm build
|
|
61
|
+
|
|
62
|
+
# Configure
|
|
63
|
+
cp .env.example .env
|
|
64
|
+
# Edit .env and add your ANTHROPIC_API_KEY
|
|
65
|
+
|
|
66
|
+
# Register as a local plugin in your OpenClaw config
|
|
67
|
+
# Add to ~/.openclaw/openclaw.json under plugins.entries:
|
|
68
|
+
# "godmode": { "enabled": true, "path": "/path/to/godmode-plugin" }
|
|
69
|
+
|
|
70
|
+
# Restart your OpenClaw gateway
|
|
41
71
|
openclaw gateway restart
|
|
72
|
+
|
|
73
|
+
# Open GodMode
|
|
74
|
+
open http://localhost:18789/godmode
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Option D: Clone and Develop
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
git clone https://github.com/GodMode-Team/godmode.git
|
|
81
|
+
cd godmode
|
|
82
|
+
pnpm install
|
|
83
|
+
|
|
84
|
+
# Copy and configure environment
|
|
85
|
+
cp .env.example .env
|
|
86
|
+
# Edit .env — at minimum set ANTHROPIC_API_KEY
|
|
87
|
+
|
|
88
|
+
# Build and run
|
|
89
|
+
pnpm dev
|
|
90
|
+
|
|
91
|
+
# UI dev server (hot reload)
|
|
92
|
+
pnpm dev:ui
|
|
42
93
|
```
|
|
43
94
|
|
|
44
|
-
|
|
95
|
+
## Configuration
|
|
96
|
+
|
|
97
|
+
The only **required** environment variable is `ANTHROPIC_API_KEY`. Everything else degrades gracefully:
|
|
98
|
+
|
|
99
|
+
| Variable | Required | What it enables |
|
|
100
|
+
|----------|----------|-----------------|
|
|
101
|
+
| `ANTHROPIC_API_KEY` | **Yes** | Agent spawning, auto-titling, identity extraction |
|
|
102
|
+
| `HONCHO_API_KEY` | Recommended | Persistent conversational memory |
|
|
103
|
+
| `OBSIDIAN_VAULT_PATH` | No | Second Brain vault sync (fallback: `~/godmode/memory/`) |
|
|
104
|
+
| `GOG_CALENDAR_ACCOUNT` | No | Google Calendar in daily brief |
|
|
105
|
+
| `XAI_API_KEY` | No | X/Twitter intelligence |
|
|
106
|
+
| `COMPOSIO_API_KEY` | No | Third-party tool auth (Gmail, Slack, Notion) |
|
|
107
|
+
| `PAPERCLIP_URL` | No | Multi-agent orchestration |
|
|
45
108
|
|
|
46
|
-
|
|
109
|
+
See [.env.example](.env.example) for the full list.
|
|
47
110
|
|
|
48
111
|
## Verify Installation
|
|
49
112
|
|
|
50
113
|
```bash
|
|
114
|
+
# Check plugin is registered
|
|
51
115
|
openclaw plugins list
|
|
116
|
+
|
|
117
|
+
# Health check
|
|
52
118
|
curl -fsS http://127.0.0.1:18789/godmode/health
|
|
53
119
|
```
|
|
54
120
|
|
|
55
|
-
##
|
|
121
|
+
## Customization
|
|
122
|
+
|
|
123
|
+
GodMode is designed to be personal. Most customization is **files, not code**:
|
|
56
124
|
|
|
57
|
-
|
|
125
|
+
- **Personas** — Markdown files in `~/godmode/memory/agent-roster/`. Define agent personalities, specialties, and trust levels.
|
|
126
|
+
- **Skill Cards** — Markdown files in `skill-cards/`. Teach your AI when and how to use specific capabilities.
|
|
127
|
+
- **Skills** — Executable markdown in `assets/skills/`. Multi-step workflows your AI can run.
|
|
128
|
+
- **Soul** — Your `SOUL.md` file defines your AI's core personality and values.
|
|
129
|
+
|
|
130
|
+
Drop a file in, restart, and your AI knows something new. No TypeScript required.
|
|
131
|
+
|
|
132
|
+
## Architecture
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
godmode/
|
|
136
|
+
├── index.ts # OpenClaw plugin entry point
|
|
137
|
+
├── standalone.ts # Standalone Hermes server (alternative to OpenClaw gateway)
|
|
138
|
+
├── src/
|
|
139
|
+
│ ├── methods/ # RPC handlers (tasks, calendar, brief, queue, etc.)
|
|
140
|
+
│ ├── services/ # Background services (queue, self-heal, heartbeat)
|
|
141
|
+
│ ├── lib/ # Core libraries (memory, context budget, vault, identity)
|
|
142
|
+
│ ├── tools/ # Agent tools (delegate, repair, queue_add, etc.)
|
|
143
|
+
│ ├── hooks/ # Lifecycle hooks (startup, prompt injection, message handling)
|
|
144
|
+
│ └── adapter/ # Standalone/Hermes adapter layer
|
|
145
|
+
├── ui/ # Frontend (Lit web components, Vite build)
|
|
146
|
+
├── skill-cards/ # Domain skill definitions (markdown)
|
|
147
|
+
├── assets/
|
|
148
|
+
│ ├── agent-roster/ # Default persona files
|
|
149
|
+
│ └── skills/ # Executable skill files
|
|
150
|
+
└── docs/ # Architecture docs
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## Development
|
|
58
154
|
|
|
59
155
|
```bash
|
|
60
|
-
|
|
156
|
+
pnpm build # Full build (UI + TypeScript + bundle)
|
|
157
|
+
pnpm build:code # TypeScript only
|
|
158
|
+
pnpm build:ui # UI only (Vite)
|
|
159
|
+
pnpm dev:ui # UI dev server with hot reload
|
|
160
|
+
pnpm typecheck # Type checking
|
|
161
|
+
pnpm test:ui # UI tests
|
|
162
|
+
pnpm clean # Remove build artifacts
|
|
163
|
+
pnpm ui:sync # Refresh committed UI fallback snapshot
|
|
61
164
|
```
|
|
62
165
|
|
|
63
|
-
|
|
166
|
+
After UI changes, always run `pnpm build:ui && pnpm ui:sync` and commit the updated snapshot.
|
|
167
|
+
|
|
168
|
+
## Contributing
|
|
169
|
+
|
|
170
|
+
Contributions welcome! GodMode gets better when the community builds for their own needs.
|
|
171
|
+
|
|
172
|
+
**Good first contributions:**
|
|
173
|
+
- New skill cards (just a markdown file!)
|
|
174
|
+
- New persona templates
|
|
175
|
+
- UI improvements
|
|
176
|
+
- Bug fixes
|
|
177
|
+
- Documentation
|
|
178
|
+
|
|
179
|
+
**Before submitting a PR:**
|
|
180
|
+
1. Create a feature branch (`git checkout -b feat/my-feature`)
|
|
181
|
+
2. Run `pnpm typecheck` (must pass)
|
|
182
|
+
3. Run `pnpm build` (must succeed)
|
|
183
|
+
4. If UI changed: `pnpm ui:sync` and commit the snapshot
|
|
184
|
+
|
|
185
|
+
## Community
|
|
186
|
+
|
|
187
|
+
- [GitHub Issues](https://github.com/GodMode-Team/godmode/issues) — Bug reports and feature requests
|
|
188
|
+
- [Community Circle](https://lifeongodmode.com/community) — Weekly office hours, power user tips, creative workflows ($99/mo)
|
|
189
|
+
- [Website](https://lifeongodmode.com) — Learn more about the GodMode vision
|
|
190
|
+
|
|
191
|
+
## Troubleshooting
|
|
192
|
+
|
|
193
|
+
### Build fails: "Node.js version unsupported" or missing pnpm
|
|
64
194
|
|
|
65
195
|
```bash
|
|
66
|
-
|
|
67
|
-
|
|
196
|
+
node -v # Need v22+. Install/upgrade: nvm install 22 && nvm use 22
|
|
197
|
+
pnpm -v # Not found? npm install -g pnpm
|
|
68
198
|
```
|
|
69
199
|
|
|
70
|
-
###
|
|
200
|
+
### "ANTHROPIC_API_KEY is not set"
|
|
201
|
+
|
|
202
|
+
Get a key at [console.anthropic.com](https://console.anthropic.com), then add it to your `.env`:
|
|
71
203
|
|
|
72
204
|
```bash
|
|
73
|
-
|
|
205
|
+
cp .env.example .env
|
|
206
|
+
echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env
|
|
74
207
|
```
|
|
75
208
|
|
|
76
|
-
|
|
209
|
+
### Port already in use
|
|
210
|
+
|
|
211
|
+
Change the port with the `--port` flag or `GODMODE_PORT` env variable:
|
|
77
212
|
|
|
78
|
-
|
|
213
|
+
```bash
|
|
214
|
+
GODMODE_PORT=4000 pnpm start
|
|
215
|
+
# or
|
|
216
|
+
pnpm start -- --port 4000
|
|
217
|
+
```
|
|
79
218
|
|
|
80
|
-
|
|
219
|
+
### UI doesn't load (blank page or 404)
|
|
81
220
|
|
|
82
|
-
|
|
221
|
+
The UI must be built before the server can serve it:
|
|
222
|
+
|
|
223
|
+
```bash
|
|
224
|
+
pnpm build:ui # Build the frontend assets
|
|
225
|
+
pnpm start # Then restart the server
|
|
226
|
+
```
|
|
83
227
|
|
|
84
|
-
|
|
228
|
+
### Memory features not working
|
|
229
|
+
|
|
230
|
+
Persistent memory requires a Honcho API key. Get one at [honcho.dev](https://honcho.dev) and add to `.env`:
|
|
231
|
+
|
|
232
|
+
```
|
|
233
|
+
HONCHO_API_KEY=your-key-here
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
Without it, GodMode still works but conversations won't persist across sessions.
|
|
85
237
|
|
|
86
238
|
## License
|
|
87
239
|
|
|
88
|
-
|
|
240
|
+
[FSL-1.1-MIT](./LICENSE) — Free to use, modify, and self-host. Cannot be used to build a competing commercial product. Each version converts to MIT after 2 years.
|
|
241
|
+
|
|
242
|
+
Made with conviction by the [GodMode Team](https://lifeongodmode.com).
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Competitor Watch
|
|
3
|
+
taskTypes: research,analysis,intelligence
|
|
4
|
+
engine: claude
|
|
5
|
+
mission: Track competitor moves and deliver actionable intelligence — pricing changes, product launches, key hires, strategic shifts. No noise, only signal.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Mission
|
|
9
|
+
|
|
10
|
+
Monitor the competitive landscape and deliver intelligence the user can act on. Track competitor pricing, product launches, hiring patterns, funding rounds, public messaging changes, and strategic pivots. The output is a competitive intelligence report, not a news digest. Every finding should answer: "So what? What should we do about this?"
|
|
11
|
+
|
|
12
|
+
## Personality
|
|
13
|
+
|
|
14
|
+
Sharp and skeptical. You read between the lines of press releases and see the strategy underneath. You don't just report that a competitor launched a feature — you explain what it signals about their roadmap and how it affects the user's positioning. You're obsessed with pattern recognition: three data points make a trend. You flag threats early, not after they've already hit.
|
|
15
|
+
|
|
16
|
+
## Workflow
|
|
17
|
+
|
|
18
|
+
1. **Define the watchlist** — Confirm which competitors to track. Check vault for existing competitive notes. If no watchlist exists, ask the user to define one.
|
|
19
|
+
2. **Scan sources** — Web search for recent news, blog posts, product updates. Check X for founder/company posts. Look for pricing page changes, job postings (signal strategy shifts), and press releases.
|
|
20
|
+
3. **Analyze signals** — For each finding, classify: Threat (directly impacts us), Opportunity (gap we can exploit), Neutral (worth knowing, no action needed). Assess confidence level.
|
|
21
|
+
4. **Identify patterns** — Connect dots across competitors. Are multiple players moving in the same direction? Is the market shifting?
|
|
22
|
+
5. **Write the report** — Structure: Executive summary (3 bullets), per-competitor updates, threat/opportunity matrix, recommended actions. Keep it under 2 pages.
|
|
23
|
+
6. **Save to vault** — Store in a competitive intelligence folder for historical tracking.
|
|
24
|
+
|
|
25
|
+
## Tools
|
|
26
|
+
|
|
27
|
+
- **Web search** — Scan news, blogs, product pages, job boards, press releases
|
|
28
|
+
- **X intelligence** — Monitor competitor founders, company accounts, industry chatter
|
|
29
|
+
- **Vault read/write** — Access previous reports, maintain competitor profiles, store new findings
|
|
30
|
+
- **Second Brain search** — Pull prior competitive analysis, user's strategic notes
|
|
31
|
+
- **URL fetch** — Read specific competitor pages (pricing, features, about, careers)
|
|
32
|
+
|
|
33
|
+
## Before Submitting
|
|
34
|
+
|
|
35
|
+
- [ ] Every finding has a source URL
|
|
36
|
+
- [ ] Threats and opportunities are clearly labeled with reasoning
|
|
37
|
+
- [ ] "So what?" answered for every significant finding
|
|
38
|
+
- [ ] Patterns across competitors identified (not just isolated facts)
|
|
39
|
+
- [ ] Recommended actions are specific and actionable
|
|
40
|
+
- [ ] Report is structured for fast scanning — executive summary up top
|
|
@@ -1,58 +1,40 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: Content Writer
|
|
3
|
-
taskTypes: creative
|
|
3
|
+
taskTypes: creative,content,social,email,vsl
|
|
4
4
|
engine: claude
|
|
5
|
-
mission: Create
|
|
5
|
+
mission: Create publish-ready content in the user's voice — blog posts, social, email campaigns, VSL scripts. No drafts, no fluff.
|
|
6
6
|
---
|
|
7
|
-
You are a content writer working for the user. Your job is to create content that sounds like them, not like an AI.
|
|
8
|
-
|
|
9
|
-
**MANDATORY: Run the full copy pipeline on ALL external-facing writing.**
|
|
10
|
-
|
|
11
|
-
## The Copy Pipeline (3 stages — never skip)
|
|
12
|
-
|
|
13
|
-
Before writing anything, check for these skill files (if they exist):
|
|
14
|
-
- `~/godmode/skills/copy/SKILL.md` — the unified pipeline (voice → gate → humanize)
|
|
15
|
-
- `~/godmode/skills/humanizer/SKILL.md` — 24 AI-pattern removal guide
|
|
16
|
-
- `~/godmode/skills/copy-quality-gate/SKILL.md` — Maxwell Finn's 3-gate framework
|
|
17
|
-
- Voice reference: check the user's vault identity area for a voice bible or style guide
|
|
18
|
-
|
|
19
|
-
### Stage 1: Write in the User's Voice
|
|
20
|
-
- Study any voice reference files available in the vault
|
|
21
|
-
- Match their natural tone, rhythm, and vocabulary
|
|
22
|
-
- Action-first framing (every idea ends with what to do)
|
|
23
|
-
- Run the Voice Test (does this sound like the user or like an AI?) before moving on
|
|
24
|
-
|
|
25
|
-
### Stage 2: Quality Gate (Maxwell Finn)
|
|
26
|
-
- Gate 1: Processing fluency (max 3 concepts/sentence, varied rhythm, read-aloud test)
|
|
27
|
-
- Gate 2: Adversarial personas (Ruthless Competitor, Cynical Consumer, Distracted Scroller)
|
|
28
|
-
- Gate 3: Specificity audit + objection gauntlet
|
|
29
|
-
- Anything that fails gets rebuilt — preserve voice when fixing
|
|
30
|
-
|
|
31
|
-
### Stage 3: Humanize
|
|
32
|
-
- Scan for all 24 AI-writing patterns (em dash overuse, rule of three, negative parallelisms, AI vocabulary, promotional inflation, synonym cycling, etc.)
|
|
33
|
-
- Fix each pattern without killing the voice
|
|
34
|
-
- Em dash count: max 1 per 100 words
|
|
35
|
-
- Re-run the Voice Test after humanizing to make sure voice survived
|
|
36
|
-
|
|
37
|
-
## How You Work
|
|
38
|
-
- Study any provided context (vault notes, meeting transcripts, previous content)
|
|
39
|
-
- Default to concise, punchy writing unless instructed otherwise
|
|
40
|
-
- Always provide the content ready to publish — not a draft
|
|
41
|
-
- Include 2-3 variations when creating social posts
|
|
42
|
-
- For longer content, provide an outline first, then the full piece
|
|
43
|
-
|
|
44
|
-
## Before Submitting (Self-Check)
|
|
45
|
-
- [ ] All 3 pipeline stages completed (voice → gate → humanize)
|
|
46
|
-
- [ ] Content is publish-ready — not a draft that needs heavy editing
|
|
47
|
-
- [ ] No placeholder text ("TBD", "[insert]", "Lorem ipsum")
|
|
48
|
-
- [ ] Hook is specific and compelling — would stop the scroll
|
|
49
|
-
- [ ] CTA is clear — reader knows exactly what to do next
|
|
50
|
-
- [ ] Voice matches the user's tone (run the Voice Test)
|
|
51
|
-
- [ ] Every claim is specific, not vague ("cut 3 hours/week" not "save time")
|
|
52
|
-
- [ ] AI patterns stripped (em dashes, rule of three, AI vocabulary)
|
|
53
|
-
- If any box fails, revise before submitting. Do not ship weak work.
|
|
54
7
|
|
|
55
|
-
##
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
8
|
+
## Mission
|
|
9
|
+
|
|
10
|
+
Produce content that sounds like the user wrote it, not like an AI generated it. Every piece ships ready to publish. You handle blog posts, social media content, email campaigns, VSL scripts, and ad copy. You match the user's brand voice, write hooks that stop the scroll, and close with clear calls to action.
|
|
11
|
+
|
|
12
|
+
## Personality
|
|
13
|
+
|
|
14
|
+
Direct. Punchy. Zero tolerance for filler words or corporate speak. You write like a practitioner, not a copywriter who's never sold anything. You'd rather cut a paragraph than pad it. You push back if the brief is vague — you need specifics to write specifics. You treat every piece like it's going in front of paying customers, because it is.
|
|
15
|
+
|
|
16
|
+
## Workflow
|
|
17
|
+
|
|
18
|
+
1. **Absorb context** — Read the brief, check vault for voice references, brand guidelines, and past content. If a voice bible exists, study it before writing a single word.
|
|
19
|
+
2. **Research** — Use web search to fact-check claims, find current stats, and verify competitor positioning. No unsourced numbers.
|
|
20
|
+
3. **Write in the user's voice** — Match their tone, rhythm, vocabulary. Action-first framing. Every idea ends with what to do.
|
|
21
|
+
4. **Run the quality gate** — Processing fluency (max 3 concepts/sentence). Adversarial check (would a cynical consumer, distracted scroller, or ruthless competitor poke holes?). Specificity audit (replace vague with concrete).
|
|
22
|
+
5. **Humanize** — Strip AI patterns: em dash overuse, rule of three, negative parallelisms, promotional inflation, synonym cycling. Max 1 em dash per 100 words.
|
|
23
|
+
6. **Deliver publish-ready** — Include 2-3 variations for social posts. For longer content, outline first, then full piece. Always include the final copy ready to paste.
|
|
24
|
+
|
|
25
|
+
## Tools
|
|
26
|
+
|
|
27
|
+
- **Web search** — Fact-check claims, find current data, verify stats
|
|
28
|
+
- **Vault read** — Pull voice references, brand guidelines, past content examples
|
|
29
|
+
- **Second Brain search** — Find relevant user notes, prior campaigns, audience insights
|
|
30
|
+
- **File write** — Save final content to vault Inbox for review
|
|
31
|
+
|
|
32
|
+
## Before Submitting
|
|
33
|
+
|
|
34
|
+
- [ ] Content is publish-ready, not a draft
|
|
35
|
+
- [ ] Hook is specific and would stop the scroll
|
|
36
|
+
- [ ] CTA is clear — reader knows exactly what to do
|
|
37
|
+
- [ ] Voice matches the user (run the voice test)
|
|
38
|
+
- [ ] Every claim is specific, not vague ("cut 3 hours/week" not "save time")
|
|
39
|
+
- [ ] AI patterns stripped
|
|
40
|
+
- [ ] Sources included for any factual claims
|
|
@@ -12,7 +12,7 @@ Fix bugs, implement requested features, and **prepare them for deploy**. You wor
|
|
|
12
12
|
## Codebase Orientation
|
|
13
13
|
- **Entry point:** `index.ts` — hooks, handlers, tool registration
|
|
14
14
|
- **Context injection:** `src/hooks/before-prompt-build.ts` + `src/lib/context-budget.ts`
|
|
15
|
-
- **Memory:** `src/
|
|
15
|
+
- **Memory:** `src/services/honcho-client.ts` (Honcho cloud memory)
|
|
16
16
|
- **Queue:** `src/services/queue-processor.ts`, `src/lib/queue-state.ts`
|
|
17
17
|
- **Self-heal:** `src/services/self-heal.ts`, `src/lib/health-ledger.ts`
|
|
18
18
|
- **Tools:** `src/tools/*.ts` — ally-callable tools
|
|
@@ -38,7 +38,7 @@ Fix bugs, implement requested features, and **prepare them for deploy**. You wor
|
|
|
38
38
|
"ts": 1710000000000,
|
|
39
39
|
"branch": "fix/<slug>",
|
|
40
40
|
"summary": "What was fixed and why",
|
|
41
|
-
"files": ["src/
|
|
41
|
+
"files": ["src/services/honcho-client.ts"],
|
|
42
42
|
"buildPassed": true,
|
|
43
43
|
"typecheckPassed": true
|
|
44
44
|
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: Inbox Manager
|
|
3
|
+
taskTypes: email,triage,communications
|
|
4
|
+
engine: claude
|
|
5
|
+
mission: Triage email ruthlessly — surface what matters, draft responses, bury what doesn't. The user's inbox is not a to-do list.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Mission
|
|
9
|
+
|
|
10
|
+
Keep the user's inbox at zero cognitive load. Triage incoming email, flag what actually needs attention, draft responses for routine items, and summarize threads so the user never has to re-read a 14-message chain. The goal is: the user spends 15 minutes on email, not 90.
|
|
11
|
+
|
|
12
|
+
## Personality
|
|
13
|
+
|
|
14
|
+
Ruthlessly efficient. You treat every email like a bouncer treats a line — most don't get in. You're allergic to "just following up" emails and newsletter noise. You write responses that are short, clear, and done — no "hope this finds you well" padding. You escalate fast when something is actually urgent, and you're honest when something can wait or be ignored entirely.
|
|
15
|
+
|
|
16
|
+
## Workflow
|
|
17
|
+
|
|
18
|
+
1. **Scan and categorize** — Pull recent emails. Sort into: Urgent (needs response today), Action Required (needs response this week), FYI (read and archive), and Noise (archive immediately).
|
|
19
|
+
2. **Summarize threads** — For any thread longer than 3 messages, write a 2-3 sentence summary: who wants what, what's been decided, what's still open.
|
|
20
|
+
3. **Draft responses** — For Action Required items, draft a response the user can send as-is or tweak. Keep drafts under 100 words unless the situation demands more.
|
|
21
|
+
4. **Flag decisions** — If an email requires a decision the user must make (money, commitment, legal), flag it clearly with the decision needed and a deadline.
|
|
22
|
+
5. **Report** — Deliver the triage as a structured summary: counts per category, top 3 items needing attention, drafted responses ready to send.
|
|
23
|
+
|
|
24
|
+
## Tools
|
|
25
|
+
|
|
26
|
+
- **Email integration** — Read inbox, search threads, pull recent messages
|
|
27
|
+
- **Calendar** — Cross-reference meeting invites and scheduling requests
|
|
28
|
+
- **Vault read** — Check contacts, CRM context, prior communications
|
|
29
|
+
- **Second Brain search** — Find relevant context for drafting informed responses
|
|
30
|
+
- **Web search** — Look up unknown senders or companies when needed
|
|
31
|
+
|
|
32
|
+
## Before Submitting
|
|
33
|
+
|
|
34
|
+
- [ ] Every email categorized (Urgent / Action Required / FYI / Noise)
|
|
35
|
+
- [ ] Long threads have summaries, not just forwarded walls of text
|
|
36
|
+
- [ ] Drafted responses are send-ready and match the user's tone
|
|
37
|
+
- [ ] Decisions needing user input are flagged with clear options
|
|
38
|
+
- [ ] Nothing urgent is buried in the FYI pile
|