From 40d14dd020ba4895879dc3b41e1610a49bab5196 Mon Sep 17 00:00:00 2001 From: Roberto Chavarria Date: Mon, 13 Jul 2026 17:01:29 -0300 Subject: [PATCH 1/2] docs(pipefy-login): drop the false PIPEFY_AUTH_URL requirement The /pipefy:pipefy-login command claimed PIPEFY_AUTH_URL must be set in the shell, but it defaults to the prod OIDC issuer (https://signin.pipefy.com/realms/pipefy). Only non-prod IdPs need to set it. Reword the note to say so. --- commands/pipefy-login.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commands/pipefy-login.md b/commands/pipefy-login.md index 95c90df1..7be22259 100644 --- a/commands/pipefy-login.md +++ b/commands/pipefy-login.md @@ -13,4 +13,4 @@ Otherwise prompt the user to confirm running: pipefy auth login $ARGUMENTS ``` -Requires `PIPEFY_AUTH_URL` set in the shell environment (the OIDC issuer URL). +This targets Pipefy production by default. Only set `PIPEFY_AUTH_URL` (the OIDC issuer URL) in the shell environment when logging in to a non-prod IdP; it defaults to `https://signin.pipefy.com/realms/pipefy`. From b586c6edecadfedefeca905f9efdcb25ad9b6b29 Mon Sep 17 00:00:00 2001 From: Roberto Chavarria Date: Mon, 13 Jul 2026 17:01:29 -0300 Subject: [PATCH 2/2] docs: document testing the Claude Code plugin from a local checkout Add a README section explaining how to point the plugin marketplace at a local clone (so a working branch loads live), including the /reload-plugins step and the gotcha where an extraKnownMarketplaces entry locks the GitHub marketplace. Link it from CONTRIBUTING's skill quick-start so contributors try skills before opening a PR. --- CONTRIBUTING.md | 2 ++ README.md | 13 +++++++++++++ 2 files changed, 15 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 59cbd8bd..08f86c28 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -22,6 +22,8 @@ Skills are Markdown-only — no Python, no `uv`, no test infrastructure required 5. Open a PR. CI validates frontmatter, MCP tool names, and `pipefy` CLI subcommands referenced in each `SKILL.md`. +> **Try your skill in Claude Code before opening the PR.** Point the plugin marketplace at your local clone so your branch loads live — see [Test the Claude Code plugin from a local checkout](README.md#test-the-claude-code-plugin-from-a-local-checkout). + ### Frontmatter requirements Every `SKILL.md` must have valid YAML frontmatter with: diff --git a/README.md b/README.md index 20a5604f..3e48aa1f 100644 --- a/README.md +++ b/README.md @@ -219,6 +219,19 @@ npx @modelcontextprotocol/inspector uv --directory . run pipefy-mcp-server **Adding an MCP tool:** implement under `packages/mcp/src/pipefy_mcp/tools/`, register in `ToolRegistry`, add the name to `PIPEFY_TOOL_NAMES`, and ship the matching CLI command (or document a deferral in `docs/parity.md`). See [`AGENTS.md`](AGENTS.md) for the full TDD workflow. +### Test the Claude Code plugin from a local checkout + +The [Claude Code install](#claude-code) adds the marketplace from the `pipefy/ai-toolkit` GitHub repo, which tracks `main`. To run **your local branch** (e.g. `dev`) as the plugin instead, point the marketplace at your clone: + +```text +/plugin marketplace add /absolute/path/to/ai-toolkit +/plugin install pipefy@pipefy +``` + +Whatever is checked out in that clone — any branch — is what loads. Use the `plugin@marketplace` form (`pipefy@pipefy`) since the marketplace and the plugin share the name `pipefy`. After editing plugin files (skills, commands), run `/reload-plugins` to pick up changes without restarting. + +> **Already installed the GitHub version?** A marketplace named `pipefy` can be registered only once, and a marketplace declared in `~/.claude/settings.json` under `extraKnownMarketplaces` is locked — `/plugin marketplace add` becomes a no-op (`already on disk — declared in user settings`) and keeps pointing at GitHub. Run `/plugin marketplace remove pipefy` first (or delete that `extraKnownMarketplaces` entry), **then** add the local path. + --- ## Contributing