Catalog›Plugins›Communication›halyardHhalyardConnect Claude Code to human experts via Slack. Ask questions, get answers, and build organizational knowledge — all without leaving your ed Open site Project Open in the app JSON README (API)Connect Claude Code to human experts via Slack. Ask questions, get answers, and build organizational knowledge — all without leaving your editor.READMELoading documentation…# Halyard — Plugin Marketplace A plugin marketplace that connects AI agents (Claude Code, Codex, Cursor, and any MCP-compatible client) to shared team memory and human experts via Slack, Teams, or Discord. ## What's included ### `halyard` plugin Installs the following into your agent: 1. **`org-kb` MCP server** — Connects to the Halyard API at `mcp.usehalyard.ai`, giving your agent access to tools for messaging experts on Slack, polling for responses, and managing a knowledge base. 2. **`ask-for-help` skill** — Teaches the agent *when* and *how* to ask for human input. It will automatically consult experts when it hits ambiguous requirements, design decisions, or anything that needs human judgment. It also learns to summarize answers so the same question doesn't get asked twice. 3. **`gather-context` skill** — Orients the agent before it starts work by searching the knowledge base, codebase, and web for prior decisions and background on the area being touched. 4. **`log-work` skill** — Prompts the agent to log non-trivial work using the knowledge base so accomplishments are captured for future reference. Covers work summaries, direct authoring of decisions/processes/specs, and attaching rich report artifacts. 5. **`review-work` skill** — Lets the agent query the knowledge base to review what you or your team have been working on — useful for standups, catch-ups, and finding past context. Also surfaces PR delivery analytics (cycle time, throughput, cadence). 6. **`triage-knowledge` skill** — Reviews the knowledge base inbox: the queue of AI-generated candidate entries awaiting approval. The agent can accept, refine, or dismiss candidates before they enter the live knowledge base. 7. **`mark-terms` skill** — Teaches the agent to link org-specific jargon in knowledge entries to canonical definition entries so the knowledge graph stays connected. 8. **Search-first hook** (Claude Code only) — Once per session, if no `search_knowledge`/`explore_knowledge` call has happened yet, refuses the first investigative tool call (`Bash`, `Read`, `Grep`, `Glob`, subagents, web research, or an edit) with a reason asking the agent to search the knowledge base first when the task touches existing systems or prior work, or to retry the call unchanged if not. A PreToolUse hook's advisory context only reaches the agent after the call, so a one-time deny is the earliest point a hook can steer the first move. Never fires again in that session. 9. **Stop hook** (Claude Code only) — When the transcript shows substantive activity (edits, subagents, or web research) since the last nudge or capture, asks the agent to decide whether that work produced durable knowledge and to call `summarize_work` if so, or end the turn silently if not. The first nudge needs one such call; after a nudge or a `summarize_work`/`upsert_knowledge` call it re-arms after ten more, so long sessions are asked again about later work. It is a proxy gate, not a content classifier. 10. **`knowledge-first` rule** (Cursor only) — An always-on rule that orients every Cursor session toward the knowledge base: search before substantive work, ask a human on a miss, capture outcomes after. Mirrors what the Claude Code hooks do, using Cursor's rules system. 11. **Session upload hook** (Claude Code and Codex) — At session end, uploads the session transcript to Halyard through `halyard hook` (the uploader in the `@halyard/cli`), and at session start sweeps any transcript for the repo that never uploaded. Runs only when the `halyard` binary is on the path or pinned in the repo (`node_modules/.bin/halyard`) and credentials exist: `HALYARD_TOKEN` in the environment, the plugin's **Halyard API key** option (Claude Code prompts for it when the plugin is enabled and keeps it in the OS credential store — leave it empty to use `halyard login`), or `HALYARD_TOKEN` in the repo's `.env`. Logs to `~/.halyard/hooks.log`; never blocks the agent. ## Quick start ### From a local clone ```bash # Add the marketplace /plugin marketplace add ./path/to/claude-plugin-marketplace # Install the plugin /plugin install halyard@halyard-labs ``` ### From GitHub ```bash # Add the marketplace /plugin marketplace add halyard-labs/claude-plugin-marketplace # Install the plugin /plugin install halyard@halyard-labs ``` ### Enable for your entire team (recommended) Instead of having each teammate install manually, add the marketplace and plugin to your repo's `.claude/settings.json`. This enables the plugin automatically for anyone who opens the project in Claude Code: ```json { "enabledPlugins": { "halyard@halyard-labs": true }, "extraKnownMarketplaces": { "halyard-labs": { "source": { "source": "github", "repo": "halyard-labs/claude-plugin-marketplace" } } } } ``` Commit this file to your repo — teammates will get the plugin enabled on their next session without any manual setup. ## Codex CLI support The halyard plugin is also available as a Codex plugin. The skills and MCP server are shared between Claude Code and Codex. ### From a local clone ```bash # Add the Codex marketplace codex plugin marketplace add ./path/to/claude-plugin-marketplace # Install the plugin codex plugin install halyard@halyard-labs ``` ### From GitHub ```bash # Add the Codex marketplace codex plugin marketplace add halyard-labs/claude-plugin-marketplace # Install the plugin codex plugin install halyard@halyard-labs ``` ### Manual MCP setup (alternative) If you prefer manual configuration instead of the plugin system: ```bash codex mcp add org-kb --url https://mcp.usehalyard.ai codex mcp login org-kb ``` ## Cursor support The halyard plugin also ships in Cursor's plugin format (`.cursor-plugin/plugin.json` + `mcp.json`), following [cursor/plugin-template](https://github.com/cursor/plugin-template). The skills and MCP server are shared with Claude Code and Codex; Claude Code's session hooks are replaced by an always-on `knowledge-first` rule. ### From the Cursor Marketplace Once listed, install from [cursor.com/marketplace](https://cursor.com/marketplace) — search for **Halyard**. Submission copy and process live in [`docs/cursor-marketplace-submission.md`](https://github.com/halyard-labs/claude-plugin-marketplace/blob/HEAD/docs/cursor-marketplace-submission.md). ### Local install (before/without the marketplace) Symlink the plugin into Cursor's local plugin directory: ```bash ln -s "$(pwd)/plugins/halyard" ~/.cursor/plugins/local/halyard ``` ### Manual MCP setup (alternative) Add the server to your project's `.cursor/mcp.json`: ```json { "mcpServers": { "halyard": { "url": "https://mcp.usehalyard.ai" } } } ``` On the first Halyard tool call, Cursor opens a browser to authorize against your Halyard account. ## Prerequisites - An account at [usehalyard.ai](https://usehalyard.ai) with your Slack workspace connected - Claude Code v1.0.33 or later (for Claude Code), [Codex CLI](https://github.com/openai/codex) (for Codex), or [Cursor](https://cursor.com) 2.5+ (for Cursor plugins) ## After installation Once installed, your agent will automatically: - Use the halyard MCP tools when it needs human input - Follow the ask → wait → summarize workflow - Search the knowledge base before asking repeat questions - Save learnings so your team's knowledge compounds over time - Prompt to log meaningful work at the end of each session You can also invoke skills manually: ``` /halyard:ask-for-help # Ask a human expert for help /halyard:gather-context # Research a topic before starting work /halyard:log-work # Log work to the knowledge base /halyard:review-work # Review past work, decisions, and delivery metrics /halyard:triage-knowledge # Review the knowledge base inbox queue ``` ## Team setup To have this plugin auto-suggested when teammates open a project, add this to your repo's `.claude/settings.json`: ```json { "extraKnownMarketplaces": { "halyard-labs": { "source": { "source": "github", "repo": "halyard-labs/claude-plugin-marketplace" } } }, "enabledPlugins": { "halyard@halyard-labs": true } } ``` ## Project structure ``` claude-plugin-marketplace/ ├── .agents/ │ └── plugins/ │ └── marketplace.json # Codex marketplace catalog ├── .claude-plugin/ │ └── marketplace.json # Claude Code marketplace catalog ├── .cursor-plugin/ │ └── marketplace.json # Cursor marketplace catalog ├── docs/ │ └── cursor-marketplace-submission.md # Cursor submission copy + checklist ├── plugins/ │ └── halyard/ │ ├── .claude-plugin/ │ │ └── plugin.json # Claude Code plugin manifest │ ├── .codex-plugin/ │ │ └── plugin.json # Codex plugin manifest │ ├── .cursor-plugin/ │ │ └── plugin.json # Cursor plugin manifest │ ├── assets/ # Brand assets (logos) │ ├── hooks/ │ │ ├── hooks.json # Session hooks (Claude Code + Codex) │ │ └── agent-session-upload.sh # Launcher for `halyard hook` (session upload) │ ├── rules/ │ │ └── knowledge-first.mdc # Always-on rule (Cursor only) │ ├── skills/ │ │ ├── ask-for-help/ │ │ │ └── SKILL.md # Ask experts for help │ │ ├── gather-context/ │ │ │ └── SKILL.md # Research context before starting work │ │ ├── log-work/ │ │ │ └── SKILL.md # Log work to knowledge base │ │ ├── mark-terms/ │ │ │ └── SKILL.md # Link org jargon to canonical definitions │ │ ├── review-work/ │ │ │ └── SKILL.md # Review past work, decisions, delivery metrics │ │ └── triage-knowledge/ │ │ └── SKILL.md # Review the knowledge base inbox queue │ ├── README.md # Plugin README (Cursor marketplace listing body) │ ├── .mcp.json # MCP server config (Claude Code + Codex) │ └── mcp.json # MCP server config (Cursor — no leading dot) ├── LICENSE └── README.md ``` DetailsTypePluginsTopicCommunicationPublisherhalyard-labsSourcemarketplaceCategoryToolsStars1Last update2026-10-27T03:14:24ZProject statusActiveLanguageShellLicenseMITAdded2026-08-30 01:48:58Updated2026-08-30 01:48:58Source idhalyard-labs/claude-plugin-marketplace/halyardMoreMore plugins on CommunicationAll from halyard-labsA–Z index
