Skip to content

Commit 2643b13

Browse files
committed
fix: repair plugin install, expand MCP bundle, add marketing site
The Claude Code plugin manifest used an npm-style object for `repository`, which fails schema validation on install ("Failed to install plugin"). Emit `repository` as a plain URL string and add the `mcpServers` pointer so the bundled servers load automatically. - Expand the no-auth MCP roster to ten servers across docs (Context7, Microsoft Learn, AWS Knowledge, Cloudflare Docs, Keeper Docs), code intelligence (DeepWiki, grep.app), browser (Playwright, Chrome DevTools), and cloud (Azure). Authored once in _sources, emitted for both engines. - Add a GitHub Pages marketing site (site/) and a Pages deploy workflow. - Remove bundled third-party license/attribution material and references; rewrite NOTICE for this repo. - Regenerate the plugin/ output and refresh README, CHANGELOG, and design docs.
1 parent 5853c2b commit 2643b13

21 files changed

Lines changed: 1138 additions & 173 deletions

File tree

.github/workflows/pages.yml

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: Deploy marketing site to GitHub Pages
2+
3+
on:
4+
push:
5+
branches: [main]
6+
paths:
7+
- "site/**"
8+
- ".github/workflows/pages.yml"
9+
workflow_dispatch:
10+
11+
permissions:
12+
contents: read
13+
pages: write
14+
id-token: write
15+
16+
# Allow one concurrent deployment; let in-progress runs finish.
17+
concurrency:
18+
group: pages
19+
cancel-in-progress: false
20+
21+
jobs:
22+
deploy:
23+
environment:
24+
name: github-pages
25+
url: ${{ steps.deployment.outputs.page_url }}
26+
runs-on: ubuntu-latest
27+
steps:
28+
- uses: actions/checkout@v4
29+
- uses: actions/configure-pages@v5
30+
- uses: actions/upload-pages-artifact@v3
31+
with:
32+
path: site
33+
- id: deployment
34+
uses: actions/deploy-pages@v4

.prettierignore

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,3 @@ plugin/
88

99
# Generated lockfile
1010
pnpm-lock.yaml
11-
12-
# Vendored upstream attribution and license texts — keep verbatim
13-
THIRD_PARTY/

CHANGELOG.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,25 @@ All notable changes to Godmode will be documented here. Format based on [Keep a
44

55
## [Unreleased]
66

7+
## [0.2.0] — 2026-05-28
8+
9+
### Added
10+
11+
- Dual-engine plugin, installable in both Claude Code and Codex from one source.
12+
- 9 hero slash commands: `/learn`, `/explain`, `/guide`, `/agents`, `/implement`, `/debug`, `/review`, `/verify`, `/commit`.
13+
- 10 bundled no-auth MCP servers: Context7, Microsoft Learn, AWS Knowledge, Cloudflare Docs, Keeper Docs, DeepWiki, grep.app, Playwright, Chrome DevTools, Azure.
14+
15+
### Fixed
16+
17+
- Plugin install failure: `repository` is now emitted as a plain URL string (Claude's schema rejects the npm-style object form).
18+
- Bundled MCPs now load on install via an `mcpServers` pointer in the Claude Code manifest.
19+
720
## [0.1.0] — 2026-05-27
821

922
### Added
1023

11-
- Initial design spec at `docs/superpowers/specs/2026-05-27-godmode-design.md`.
24+
- Initial design spec at `docs/specs/2026-05-27-godmode-design.md`.
1225
- Apache-2.0 `LICENSE` and project `NOTICE` file.
13-
- `THIRD_PARTY/` attribution for vendored upstream projects:
14-
- [Superpowers](https://github.com/obra/superpowers) (MIT)
15-
- [claude-mem](https://github.com/thedotmack/claude-mem) (Apache-2.0)
1626
- `README.md`, `CONTRIBUTING.md`, `SECURITY.md`, `CHANGELOG.md`.
1727
- Repository scaffold (`package.json`, `tsconfig.json`, `.gitignore`).
1828

@@ -23,5 +33,5 @@ All notable changes to Godmode will be documented here. Format based on [Keep a
2333
- Token economics pillar: meter, prompt optimizer, model router, cache-friendly prompting, budget gates, cost dashboard, subagent dispatch gate.
2434
- Webviewer: Hono + WebSocket server on `127.0.0.1:51847`, React + Vite + Tailwind + shadcn SPA, 4 pages (Dashboard / Memory / Plans / Cost).
2535
- Dual-engine plugin manifests: `.claude-plugin/plugin.json` + `.codex-plugin/plugin.json` built from one source.
26-
- Bundled MCP servers: Context7, Microsoft Learn, Cloudflare Docs, Keeper Docs, Playwright.
36+
- Bundled MCP servers: Context7, Microsoft Learn, AWS Knowledge, Cloudflare Docs, Keeper Docs, DeepWiki, grep.app, Playwright, Chrome DevTools, Azure.
2737
- Distribution roadmap to `v1.0` with marketplace listings at `v0.7`.

NOTICE

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,4 @@
1-
Forge
2-
Copyright 2026 Patrick King and Forge contributors.
1+
Godmode
2+
Copyright 2026 Patrick King.
33

4-
This product includes software developed at, or derived from, the following projects:
5-
6-
* Superpowers (https://github.com/obra/superpowers)
7-
Copyright (c) 2025 Jesse Vincent
8-
Licensed under the MIT License.
9-
10-
* claude-mem (https://github.com/thedotmack/claude-mem)
11-
Copyright (c) Alex Newman
12-
Licensed under the Apache License, Version 2.0.
13-
14-
Selected skills, hooks, schema patterns, and orchestration ideas have been
15-
adapted from the above projects under the terms of their respective licenses.
16-
Full upstream license texts are preserved under THIRD_PARTY/.
4+
Licensed under the Apache License, Version 2.0. See LICENSE for the full text.

README.md

Lines changed: 43 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# 🔥 Godmode
44

55
**Learn. Plan. Build. Optimize.**
6-
One plugin for Claude Code and Codex. Battle-tested workflows and five bundled documentation MCPs install today — persistent memory, token economics, and a live dashboard are on the roadmap.
6+
One plugin for Claude Code and Codex. Battle-tested workflows and ten bundled no-auth MCP servers install today — persistent memory, token economics, and a live dashboard are on the roadmap.
77

88
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
99
[![Status](https://img.shields.io/badge/status-alpha-green.svg)](docs/specs/2026-05-27-godmode-design.md)
@@ -18,20 +18,20 @@ One plugin for Claude Code and Codex. Battle-tested workflows and five bundled d
1818

1919
Godmode takes the best ideas from across the Claude Code and Codex plugin ecosystem — brainstorming, plan-driven development, subagent orchestration, persistent memory, and disciplined verification — and **fuses them into one coherent, opinionated plugin** that ships with curated MCP servers, hybrid project + global memory, and a live local web dashboard.
2020

21-
Built on top of two excellent upstream projects (MIT-licensed [Superpowers](https://github.com/obra/superpowers) and Apache-2.0-licensed [claude-mem](https://github.com/thedotmack/claude-mem)) and a long list of skills and patterns from across the community, Godmode consolidates and optimizes them into a single super-plugin you install once.
21+
It consolidates that surface into a single super-plugin you install once, in either engine, with no per-repo setup grind.
2222

2323
---
2424

2525
## Why Godmode?
2626

27-
| Problem | Godmode's answer |
28-
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
29-
| 12 plugins doing 12 jobs with overlapping commands | One plugin, one command surface, one mental model |
30-
| Memory that disappears every new session | Hybrid global + per-project SQLite memory, auto-injected on session start, browseable in the dashboard |
31-
| No idea what each session is costing you | Real-time token meter, prompt optimizer, cache-aware shaping, per-scope budgets, cost dashboard |
32-
| Codex and Claude Code drifting apart | Dual-engine plugin built from a single source — full parity at every release |
33-
| Same setup grind every new repo | One marketplace install wires the same commands and MCP servers into every repo, in both engines |
34-
| MCP servers configured one at a time | Curated bundle (Context7, Microsoft Learn, Cloudflare Docs, Keeper Docs, Playwright) pre-wired and opt-out, not opt-in |
27+
| Problem | Godmode's answer |
28+
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
29+
| 12 plugins doing 12 jobs with overlapping commands | One plugin, one command surface, one mental model |
30+
| Memory that disappears every new session | Hybrid global + per-project SQLite memory, auto-injected on session start, browseable in the dashboard |
31+
| No idea what each session is costing you | Real-time token meter, prompt optimizer, cache-aware shaping, per-scope budgets, cost dashboard |
32+
| Codex and Claude Code drifting apart | Dual-engine plugin built from a single source — full parity at every release |
33+
| Same setup grind every new repo | One marketplace install wires the same commands and MCP servers into every repo, in both engines |
34+
| MCP servers configured one at a time | Curated 10-server no-auth bundle (docs, code intelligence, browser, cloud) pre-wired and opt-out, not opt-in |
3535

3636
---
3737

@@ -40,7 +40,7 @@ Built on top of two excellent upstream projects (MIT-licensed [Superpowers](http
4040
**Available now — installs and runs in both engines, no daemon required:**
4141

4242
- **9 hero slash commands**`/learn`, `/explain`, `/guide`, `/agents`, `/implement`, `/debug`, `/review`, `/verify`, `/commit`. Battle-tested workflow prompts, authored once and shipped to both engines.
43-
- **5 bundled documentation MCPs** — Context7, Microsoft Learn, Cloudflare Docs, Keeper Docs, Playwright. One setup, working integrations.
43+
- **10 bundled no-auth MCP servers**docs (Context7, Microsoft Learn, AWS Knowledge, Cloudflare Docs, Keeper Docs), code intelligence (DeepWiki, grep.app), browser automation (Playwright, Chrome DevTools), and cloud (Azure). One setup, working integrations, no API keys.
4444
- **Dual engine, one source** — every command and MCP is authored once in `src/plugin/_sources/` and emitted for both Claude Code (`commands/` + `.mcp.json`) and Codex (`skills/` + `codex mcp add`). Full parity at every build.
4545
- **Nothing to compile to use it** — no server, no database, no native dependencies for teammates. Install straight from the marketplace and go.
4646

@@ -56,17 +56,22 @@ See the [roadmap](#roadmap) for sequencing.
5656

5757
## Bundled MCP servers
5858

59-
Godmode ships these curated MCPs and wires them into both engines during install:
59+
Godmode ships these ten curated MCP servers and wires them into both engines during install:
6060

61-
| MCP | What it gives you |
62-
| ------------------- | ----------------------------------------------------------------- |
63-
| **Context7** | Up-to-date docs for libraries, frameworks, SDKs, CLIs |
64-
| **Microsoft Learn** | Search and fetch Microsoft / Azure documentation and code samples |
65-
| **Cloudflare Docs** | Search Cloudflare documentation |
66-
| **Keeper Docs** | Search Keeper Security documentation |
67-
| **Playwright** | Browser automation, screenshots, end-to-end checks |
61+
| MCP | Category | What it gives you |
62+
| ------------------- | ----------------- | -------------------------------------------------------------------- |
63+
| **Context7** | Docs | Up-to-date, version-aware docs for libraries, frameworks, SDKs, CLIs |
64+
| **Microsoft Learn** | Docs | Search and fetch Microsoft / Azure documentation and code samples |
65+
| **AWS Knowledge** | Docs | AWS documentation, code samples, and regional availability |
66+
| **Cloudflare Docs** | Docs | Search the Cloudflare developer platform documentation |
67+
| **Keeper Docs** | Docs | Search Keeper Security documentation |
68+
| **DeepWiki** | Code intelligence | Ask questions about any public GitHub repo's architecture and docs |
69+
| **grep.app** | Code intelligence | Regex code search across a million public GitHub repositories |
70+
| **Playwright** | Browser | Drive a real browser for testing, screenshots, and verification |
71+
| **Chrome DevTools** | Browser | Inspect the DOM, network, console, and performance traces in Chrome |
72+
| **Azure** | Cloud | Manage Azure resources and deployments (uses your local `az login`) |
6873

69-
All five are documentation/automation servers with no embedded credentials. To opt one out, remove its entry from `plugin/.mcp.json` (Claude Code) or skip its line in the Codex setup below.
74+
Every server is **no-auth**: the HTTP endpoints are public, the `npx`-based stdio servers need no API key, and Azure uses your ambient `az login` credentials — no secrets live in the config. To opt one out, remove its entry from `plugin/.mcp.json` (Claude Code) or skip its line in the Codex setup below.
7075

7176
---
7277

@@ -82,7 +87,7 @@ Godmode installs from a marketplace in **both** engines — no daemon, database,
8287
# 1. Register the marketplace
8388
/plugin marketplace add patrickking67/godmode
8489
85-
# 2. Install — commands, skills, and all five MCP servers come wired in
90+
# 2. Install — commands, skills, and all ten MCP servers come wired in
8691
/plugin install godmode@godmode
8792
```
8893

@@ -107,20 +112,25 @@ Codex pulls the workflow **skills** from the marketplace, then registers the MCP
107112
# 1. Register the marketplace — brings in the workflow skills
108113
codex plugin marketplace add patrickking67/godmode
109114

110-
# 2. Wire up the five bundled MCP servers
115+
# 2. Wire up the ten bundled MCP servers
111116
codex mcp add context7 -- npx -y @upstash/context7-mcp
112117
codex mcp add microsoft-learn --url "https://learn.microsoft.com/api/mcp"
118+
codex mcp add aws-knowledge --url "https://knowledge-mcp.global.api.aws"
113119
codex mcp add cloudflare-docs --url "https://docs.mcp.cloudflare.com/mcp"
114120
codex mcp add keeper-docs --url "https://docs.keeper.io/~gitbook/mcp"
121+
codex mcp add deepwiki --url "https://mcp.deepwiki.com/mcp"
122+
codex mcp add grep --url "https://mcp.grep.app"
115123
codex mcp add playwright -- npx -y @playwright/mcp@latest
124+
codex mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest
125+
codex mcp add azure -- npx -y @azure/mcp@latest server start
116126
```
117127

118128
Cloned the repo? Step 2 collapses to one command — `bash plugin/codex-mcp-setup.sh` — generated from the same source as the list above, so it never drifts. (You can also append `plugin/codex-config.toml` to `~/.codex/config.toml`.) For a local marketplace, use `codex plugin marketplace add /absolute/path/to/godmode`.
119129

120130
### Verify
121131

122132
```sh
123-
codex mcp list # Codex: the five servers are listed
133+
codex mcp list # Codex: the ten servers are listed
124134
```
125135

126136
In Claude Code, open `/plugin` to confirm **godmode** is installed and its commands are listed. In a fresh session of either engine, run `/learn` to confirm the workflows loaded.
@@ -177,20 +187,16 @@ Full design in [`docs/specs/2026-05-27-godmode-design.md`](docs/specs/2026-05-27
177187

178188
## Roadmap
179189

180-
| Version | Milestone |
181-
| -------- | --------------------------------------------------------------------------------------------- |
182-
| **v0.1** | Design spec + scaffold |
183-
| **v0.2** | Dual-engine plugin: 9 commands + 5 bundled MCPs, installable in both engines _(you are here)_ |
184-
| v0.3 | Core hybrid memory — global + per-project SQLite, FTS5, session injection |
185-
| v0.4 | Token meter, prompt optimizer, model router, budgets |
186-
| v0.5 | Webviewer — Dashboard, Memory, Plans, Cost |
187-
| v0.6 | Full CLI + `godmode doctor` |
188-
| v0.7 | Beta on public marketplace |
189-
| **v1.0** | Stable API; full test coverage; public launch |
190-
191-
---
192-
193-
Full attribution in [`NOTICE`](NOTICE) and [`THIRD_PARTY/`](THIRD_PARTY/).
190+
| Version | Milestone |
191+
| -------- | ---------------------------------------------------------------------------------------------- |
192+
| **v0.1** | Design spec + scaffold |
193+
| **v0.2** | Dual-engine plugin: 9 commands + 10 bundled MCPs, installable in both engines _(you are here)_ |
194+
| v0.3 | Core hybrid memory — global + per-project SQLite, FTS5, session injection |
195+
| v0.4 | Token meter, prompt optimizer, model router, budgets |
196+
| v0.5 | Webviewer — Dashboard, Memory, Plans, Cost |
197+
| v0.6 | Full CLI + `godmode doctor` |
198+
| v0.7 | Beta on public marketplace |
199+
| **v1.0** | Stable API; full test coverage; public launch |
194200

195201
---
196202

THIRD_PARTY/README.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

THIRD_PARTY/claude-mem-LICENSE

Lines changed: 0 additions & 9 deletions
This file was deleted.

THIRD_PARTY/superpowers-LICENSE

Lines changed: 0 additions & 21 deletions
This file was deleted.

0 commit comments

Comments
 (0)