Skip to content

feat: codex plugin#150

Merged
wey-gu merged 5 commits intomainfrom
codex_plugin
Mar 31, 2026
Merged

feat: codex plugin#150
wey-gu merged 5 commits intomainfrom
codex_plugin

Conversation

@wey-gu
Copy link
Copy Markdown
Member

@wey-gu wey-gu commented Mar 31, 2026

Note

Low Risk
Mostly adds documentation/metadata and a new Codex plugin package; the main risk is incorrect integration registry/install instructions affecting setup and discovery.

Overview
Adds a new Codex native plugin (nowledge-mem-codex-plugin) with a plugin.json manifest, five composable skills (read-working-memory, search-memory, save-thread, distill-memory, status), and accompanying README.md/AGENTS.md/CHANGELOG.md.

Updates the integration surfaces (integrations.json, top-level README.md, and the npx check-integration skill) to switch Codex from the legacy nowledge-mem-codex-prompts install flow to the new plugin-based install, including a migration/deprecation note for the old prompts package.

Written by Cursor Bugbot for commit c6f09c8. This will update automatically on new commits. Configure here.

Summary by CodeRabbit

Release Notes

  • New Features

    • Released Codex Plugin with five composable skills: read working memory, search memory, save thread, distill memory, and status checks.
    • Updated installation method from automated script to manual plugin directory copy.
  • Documentation

    • Added comprehensive plugin setup guide, skill documentation, and migration path from previous implementation.
  • Deprecated

    • Superseded custom prompts package with native Codex Plugin offering equivalent capabilities via composable skills.

wey-gu and others added 5 commits March 31, 2026 11:28
nmem-cli-based plugin replaces the old prompt package. Skills:
read-working-memory, search-memory, save-thread, distill-memory, status.
Progressive loading — each skill injects context only when triggered.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- integrations.json: Codex entry updated to type plugin, v0.1.0
- README: Codex row now points to plugin install
- codex-prompts: deprecation notice added
- check-integration skill: Codex install command updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- plugin.json: developerName → Nowledge Labs, description leads with
  user outcome, defaultPrompts use natural language, keywords reflect
  what users search for
- SKILL.md descriptions: remove "Uses nmem CLI" implementation detail,
  lead with what the user gets
- README: rewritten to lead with the promise (remember across tools),
  verify step uses natural language
- AGENTS.md: tighter, more operational

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace em dashes with colons, commas, periods, or sentence
restructuring throughout all plugin copy. Follows feedback that
em dashes read as AI-generated rather than human-polished.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
/docs/features/working-memory, /docs/features/search, and
/docs/features/threads were phantom URLs (SPA returns 200 but
renders 404 client-side). Fixed to real pages:
- Working Memory -> /docs/advanced-features#working-memory
- Search -> /docs/search-relevance
- Threads -> /docs/threads

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Mar 31, 2026

📝 Walkthrough

Walkthrough

This PR migrates the Nowledge Mem integration from a prompt-based to a native Codex plugin architecture. Changes include updating the integration registry, adding a plugin manifest and skill documentation, introducing installation via plugin directory copy instead of remote scripts, and marking the previous prompt-based package as deprecated.

Changes

Cohort / File(s) Summary
Registry Updates
README.md, integrations.json
Updated integration registry: renamed "Codex Prompts" to "Codex Plugin", changed type from prompts to plugin, updated directory references, changed install method from curl-based script to manual plugin directory copy, transitioned skills from empty array to populated list (read-working-memory, search-memory, save-thread, distill-memory, status), and shifted slashCommands from /prompts:* pattern to empty array.
Plugin Manifest
nowledge-mem-codex-plugin/.codex-plugin/plugin.json
New plugin manifest declaring metadata (name nowledge-mem, version 0.1.0), skills directory reference, interface configuration with capabilities (Read, Write), and default prompt array for session guidance.
Plugin Documentation
nowledge-mem-codex-plugin/AGENTS.md, CHANGELOG.md, README.md
Added comprehensive plugin documentation: AGENTS.md defines CLI workflows for memory operations (read, search, save, distill), CHANGELOG.md documents initial v0.1.0 release with five composable skills, and README.md provides installation, configuration, verification, and migration guidance from legacy prompt package.
Skill Definitions
nowledge-mem-codex-plugin/skills/read-working-memory/SKILL.md, search-memory/SKILL.md, save-thread/SKILL.md, distill-memory/SKILL.md, status/SKILL.md
Added skill documentation files defining purpose, command syntax, operational triggers, and workflows for each plugin capability (working memory loading, memory search with routing logic, transcript saving, insight distillation, and health status checks).
Deprecation Notice & Integration Guide
nowledge-mem-codex-prompts/README.md, nowledge-mem-npx-skills/skills/check-integration/SKILL.md
Added deprecation notice to legacy prompt package README linking to migration guide; updated Codex CLI integration instructions to reflect manual plugin copy workflow instead of remote script installation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • #36: Implements the same migration from prompt-based to Codex plugin/CLI model with identical skill additions and install flow changes.
  • #141: Converts Codex CLI integration from prompts package to native plugin with matching integrations.json refactoring and plugin skills/manifest updates.

Poem

🐰 The prompts have leapt into plugins divine,
Five skills now composable, working in line—
From curl-script to copy, the install runs clean,
Memory flows richer through workflows serene!
✨ Nowledge mem hops forward to 0.1.0's gleam! 🌟

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'feat: codex plugin' is vague and generic, using minimal descriptive language that doesn't convey the scope or significance of the changes. Revise title to be more specific about the main change, e.g., 'feat: migrate nowledge-mem from custom prompts to Codex plugin' or 'feat: add nowledge-mem Codex plugin with five composable skills'.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex_plugin

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@wey-gu
Copy link
Copy Markdown
Member Author

wey-gu commented Mar 31, 2026

bugbot run

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
README.md (1)

36-36: Clarify the fifth skill in the Codex row description.

Line 36 says “five composable skills” but the sentence enumerates only four capability areas. Consider explicitly mentioning status for consistency and scanning clarity.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 36, The README table row for "Codex Plugin
(nowledge-mem-codex-plugin)" claims "five composable skills" but only lists
four; update that cell to explicitly include the missing "status" skill (e.g.,
"Working Memory, routed recall, real session save, distillation, and status") so
the phrase "five composable skills" matches the enumerated items and improves
scannability.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@nowledge-mem-codex-prompts/README.md`:
- Around line 3-4: The blockquote in README.md contains an extra blank line that
triggers markdownlint MD028; edit the block that starts with "**Deprecated**:
This custom prompts package..." to remove the empty line so the entire
deprecation notice is a single continuous blockquote line (no blank line between
sentences) to satisfy the no-blanks-blockquote rule.

In `@nowledge-mem-npx-skills/skills/check-integration/SKILL.md`:
- Line 44: The Codex CLI table row in SKILL.md ("Codex CLI" entry) omits the
`.agents/plugins/nowledge-mem` install target that integrations.json declares as
canonical; update the install instruction in that table cell to include both
install locations (e.g., `~/.codex/plugins/nowledge-mem` and
`~/.agents/plugins/nowledge-mem`) so the Markdown matches the registry. Verify
against the `integrations.json` entry for the Codex integration to ensure naming
and paths exactly match the source-of-truth.

---

Nitpick comments:
In `@README.md`:
- Line 36: The README table row for "Codex Plugin (nowledge-mem-codex-plugin)"
claims "five composable skills" but only lists four; update that cell to
explicitly include the missing "status" skill (e.g., "Working Memory, routed
recall, real session save, distillation, and status") so the phrase "five
composable skills" matches the enumerated items and improves scannability.
🪄 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: f4a83855-b143-404f-88d5-19d6ff12e658

📥 Commits

Reviewing files that changed from the base of the PR and between e60d162 and c6f09c8.

📒 Files selected for processing (13)
  • README.md
  • integrations.json
  • nowledge-mem-codex-plugin/.codex-plugin/plugin.json
  • nowledge-mem-codex-plugin/AGENTS.md
  • nowledge-mem-codex-plugin/CHANGELOG.md
  • nowledge-mem-codex-plugin/README.md
  • nowledge-mem-codex-plugin/skills/distill-memory/SKILL.md
  • nowledge-mem-codex-plugin/skills/read-working-memory/SKILL.md
  • nowledge-mem-codex-plugin/skills/save-thread/SKILL.md
  • nowledge-mem-codex-plugin/skills/search-memory/SKILL.md
  • nowledge-mem-codex-plugin/skills/status/SKILL.md
  • nowledge-mem-codex-prompts/README.md
  • nowledge-mem-npx-skills/skills/check-integration/SKILL.md

Comment on lines +3 to +4
> **Deprecated**: This custom prompts package has been superseded by the **[Codex Plugin](../nowledge-mem-codex-plugin/)**. The plugin provides the same capabilities as composable Codex skills with proper plugin lifecycle support. See the [migration guide](https://mem.nowledge.co/docs/integrations/codex-cli#migrating-from-custom-prompts) for details.

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

Fix markdownlint MD028 in deprecation notice.

Line 4 introduces a blank line inside the blockquote, which triggers no-blanks-blockquote.

Suggested markdown fix
 > **Deprecated**: This custom prompts package has been superseded by the **[Codex Plugin](../nowledge-mem-codex-plugin/)**. The plugin provides the same capabilities as composable Codex skills with proper plugin lifecycle support. See the [migration guide](https://mem.nowledge.co/docs/integrations/codex-cli#migrating-from-custom-prompts) for details.
- 
+
🧰 Tools
🪛 markdownlint-cli2 (0.22.0)

[warning] 4-4: Blank line inside blockquote

(MD028, no-blanks-blockquote)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@nowledge-mem-codex-prompts/README.md` around lines 3 - 4, The blockquote in
README.md contains an extra blank line that triggers markdownlint MD028; edit
the block that starts with "**Deprecated**: This custom prompts package..." to
remove the empty line so the entire deprecation notice is a single continuous
blockquote line (no blank line between sentences) to satisfy the
no-blanks-blockquote rule.

| **Alma** | Running inside Alma; `~/.config/alma/` exists | In Alma: Settings > Plugins > Marketplace, search "Nowledge Mem" | [Guide](https://mem.nowledge.co/docs/integrations/alma) |
| **Droid** | Running inside Droid (Factory) | Add nowledge-co/community marketplace, install nowledge-mem@nowledge-community | [Guide](https://mem.nowledge.co/docs/integrations/droid) |
| **Codex CLI** | Running as Codex CLI agent; `~/.codex/` exists | `curl -fsSL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-codex-prompts/install.sh \| bash` | [Guide](https://mem.nowledge.co/docs/integrations/codex-cli) |
| **Codex CLI** | Running as Codex CLI agent; `~/.codex/` exists | Copy `nowledge-mem-codex-plugin` to `~/.codex/plugins/nowledge-mem` | [Guide](https://mem.nowledge.co/docs/integrations/codex-cli) |
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

Align Codex install path with registry source of truth.

Line 44 omits the .agents/plugins/nowledge-mem install location that is present in integrations.json, so this table can drift from the declared canonical source. Please include both targets in the install instruction.

Based on learnings: Maintain integrations.json as the single source of truth for all Nowledge Mem integrations, tracking capabilities, versions, install commands, transport, tool naming, and thread save methods.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@nowledge-mem-npx-skills/skills/check-integration/SKILL.md` at line 44, The
Codex CLI table row in SKILL.md ("Codex CLI" entry) omits the
`.agents/plugins/nowledge-mem` install target that integrations.json declares as
canonical; update the install instruction in that table cell to include both
install locations (e.g., `~/.codex/plugins/nowledge-mem` and
`~/.agents/plugins/nowledge-mem`) so the Markdown matches the registry. Verify
against the `integrations.json` entry for the Codex integration to ensure naming
and paths exactly match the source-of-truth.

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