From c93c6f46cffa9ccc0bf2c5e312ea0804fb651f74 Mon Sep 17 00:00:00 2001 From: Teal Bauer Date: Thu, 12 Feb 2026 01:15:24 +0100 Subject: [PATCH 1/2] feat: finalize beans-prime Claude Code plugin - Replace WIP plugin README with install and usage docs - Update main README Claude Code section with plugin install instructions - Add extraKnownMarketplaces and enabledPlugins to .claude/settings.json - Keep manual hook setup in collapsible details block Refs: beans-j7hd --- ...hd--research-claude-code-pluginmarketplace.md | 11 ++++++++++- .claude/settings.json | 11 +++++++++++ README.md | 13 ++++++++++++- extras/claude/plugins/beans-prime/README.md | 16 +++++++++++++++- 4 files changed, 48 insertions(+), 3 deletions(-) diff --git a/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md b/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md index 7c4461d5..ce4c3898 100644 --- a/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md +++ b/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md @@ -1,12 +1,21 @@ --- # beans-j7hd title: Research Claude Code plugin/marketplace -status: todo +status: in-progress type: task priority: normal created_at: 2025-12-13T01:53:55Z updated_at: 2026-03-07T23:11:57Z order: k +updated_at: 2026-02-12T00:15:12Z --- Wrap up our work in progress Claude Code plugin/marketplace to make installation a little easier. + +## Tasks + +- [x] Finalize plugin README +- [x] Update main README Claude Code section +- [x] Add extraKnownMarketplaces to .claude/settings.json +- [x] Validate plugin structure +- [ ] Commit changes diff --git a/.claude/settings.json b/.claude/settings.json index 60b2323d..da9beeff 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -1,4 +1,15 @@ { + "extraKnownMarketplaces": { + "beans": { + "source": { + "source": "github", + "repo": "hmans/beans" + } + } + }, + "enabledPlugins": { + "beans-prime@beans": true + }, "hooks": { "SessionStart": [ { diff --git a/README.md b/README.md index 418f3703..77f4ebe2 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,16 @@ Some agents provide mechanisms to automate this step: ### Claude Code -An official Beans plugin for Claude is in the works, but for the time being, please manually add the following hooks to your project's `.claude/settings.json` file: +Install the Beans plugin from the marketplace: + +1. Add the marketplace: `/plugin marketplace add hmans/beans` +2. Install the plugin: `/plugin install beans-prime@beans` + +This automatically runs `beans prime` at session start and before context compaction. + +
Manual setup (without plugin) + +Add the following hooks to your project's `.claude/settings.json` file: ```json { @@ -101,6 +110,8 @@ An official Beans plugin for Claude is in the works, but for the time being, ple } ``` +
+ ### OpenCode Beans integrates with OpenCode via a plugin that injects task context into your sessions. To set it up, **copy the plugin** from [`.opencode/plugin/beans-prime.ts`](.opencode/plugin/beans-prime.ts) to your project's `.opencode/plugin/` directory (or `~/.opencode/plugin/` for global availability across all projects). diff --git a/extras/claude/plugins/beans-prime/README.md b/extras/claude/plugins/beans-prime/README.md index 45107943..c88af1dd 100644 --- a/extras/claude/plugins/beans-prime/README.md +++ b/extras/claude/plugins/beans-prime/README.md @@ -1,3 +1,17 @@ # beans-prime -This is a **work in progress** plugin for Claude Code that aims at integrating Beans a little easier with the agent (so the user doesn't have to manually edit their settings file). It's currently not ready for prime time use -- for now, please refer to Beans' main README for instructions on how to set up Beans with Claude Code. +A Claude Code plugin that integrates [Beans](https://github.com/hmans/beans) into your coding sessions. It runs `beans prime` automatically at session start and before context compaction, giving Claude full context about your project's tasks. + +## Installation + +``` +/plugin marketplace add hmans/beans +/plugin install beans-prime@beans +``` + +## What it does + +This plugin registers hooks for the following Claude Code events: + +- **SessionStart**: Runs `beans prime` when a new session begins, providing Claude with your project's task context and instructions. +- **PreCompact**: Runs `beans prime` before context compaction, ensuring task context is preserved when the conversation is compressed. From e05d66315c65e81510e25b2b26c673b7764e000e Mon Sep 17 00:00:00 2001 From: Teal Bauer Date: Thu, 12 Feb 2026 01:15:33 +0100 Subject: [PATCH 2/2] chore: complete beans-j7hd Refs: beans-j7hd --- ...-j7hd--research-claude-code-pluginmarketplace.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md b/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md index ce4c3898..de4af68d 100644 --- a/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md +++ b/.beans/beans-j7hd--research-claude-code-pluginmarketplace.md @@ -1,13 +1,13 @@ --- # beans-j7hd title: Research Claude Code plugin/marketplace -status: in-progress +status: completed type: task priority: normal created_at: 2025-12-13T01:53:55Z -updated_at: 2026-03-07T23:11:57Z order: k updated_at: 2026-02-12T00:15:12Z +updated_at: 2026-02-12T00:15:29Z --- Wrap up our work in progress Claude Code plugin/marketplace to make installation a little easier. @@ -18,4 +18,11 @@ Wrap up our work in progress Claude Code plugin/marketplace to make installation - [x] Update main README Claude Code section - [x] Add extraKnownMarketplaces to .claude/settings.json - [x] Validate plugin structure -- [ ] Commit changes +- [x] Commit changes + +## Summary of Changes + +- Replaced WIP plugin README with actual usage documentation +- Updated main README's Claude Code section: plugin install instructions up front, manual hook setup in a collapsible details block +- Added `extraKnownMarketplaces` and `enabledPlugins` to `.claude/settings.json` so projects using beans auto-prompt plugin installation +- Validated plugin structure with `claude plugin validate` (passes)