- 
+ 
Overview • Installation • @@ -43,13 +41,13 @@ Open-source toolkit for **Pipefy** developers: a Model Context Protocol (MCP) se | **SDK** | `pipefy-sdk` | Vendor GraphQL client, services, and models shared by MCP and CLI. | | **Skills** | [`skills/`](skills/) | Markdown playbooks (Anthropic Skills format) for common Pipefy workflows. | -Feedback and issues: [GitHub Issues](https://github.com/gbrlcustodio/pipefy-mcp-server/issues) · **dev@pipefy.com** +Feedback and issues: [GitHub Issues](https://github.com/pipefy/ai-toolkit/issues) · **dev@pipefy.com** --- ## Installation -> Pre-1.0 ships from this git repo via `uvx` and `uv tool install`. PyPI becomes the canonical source at **v1.0**. The current beta line is **`v0.2.0-beta.*`** (first tag: [`v0.2.0-beta.1`](https://github.com/gbrlcustodio/pipefy-mcp-server/releases/tag/v0.2.0-beta.1)). Two install paths: the **Quick install** script below (resolves the latest GitHub Release at runtime and runs `uv tool install` for you), or **Claude Code** via the plugin marketplace. +> Pre-1.0 ships from this git repo via `uvx` and `uv tool install`. PyPI becomes the canonical source at **v1.0**. The current beta line is **`v0.2.0-beta.*`** (first tag: [`v0.2.0-beta.1`](https://github.com/pipefy/ai-toolkit/releases/tag/v0.2.0-beta.1)). Two install paths: the **Quick install** script below (resolves the latest GitHub Release at runtime and runs `uv tool install` for you), or **Claude Code** via the plugin marketplace. > > The CLI snippets below pin **`@latest`**, a moving git tag the release flow updates to point at the most recent release. To pin a specific version, swap `@latest` for a version tag (e.g. `@v0.2.0-beta.2`). The `--with pipefy-sdk @ ...#subdirectory=packages/sdk` / `pipefy-auth @ ...#subdirectory=packages/auth` flags are required pre-1.0: this repo is a uv workspace, and the workspace members are not yet published to PyPI, so uv needs them named explicitly. The flags go away at v1.0 (PyPI install). @@ -65,7 +63,7 @@ Full env-var reference and `config.toml` precedence: [`docs/config.md`](docs/con One command installs the CLI + MCP server, optionally adds skills, and registers the MCP server in your client config: ```sh -curl -fsSL https://raw.githubusercontent.com/gbrlcustodio/pipefy-mcp-server/main/install.sh \ +curl -fsSL https://raw.githubusercontent.com/pipefy/ai-toolkit/main/install.sh \ | sh -s -- --client cursor ``` @@ -73,7 +71,7 @@ Replace `--client cursor` with one of: `claude-code`, `claude-desktop`, `codex`, - `--yes` skip all confirmation prompts. - `--no-skills` skip the `npx skills add` step. -- `--version vX.Y.Z` pin a specific [GitHub Release](https://github.com/gbrlcustodio/pipefy-mcp-server/releases) tag (default: most recent prerelease or release). +- `--version vX.Y.Z` pin a specific [GitHub Release](https://github.com/pipefy/ai-toolkit/releases) tag (default: most recent prerelease or release). - `--dry-run` print every command without executing. - `--allow-root` opt-in for root execution (refused by default). @@ -82,7 +80,7 @@ After install, run `pipefy auth login` to authenticate (`--device` on headless s ### Claude Code ```text -/plugin marketplace add gbrlcustodio/pipefy-mcp-server +/plugin marketplace add pipefy/ai-toolkit /plugin install pipefy /pipefy:install /pipefy:login @@ -96,9 +94,9 @@ Ad-hoc: ```sh uvx \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/cli" \ + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/cli" \ pipefy-cli --help ``` @@ -106,9 +104,9 @@ Permanent install: ```sh uv tool install \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/cli" + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/cli" pipefy --install-completion bash # or zsh, fish pipefy auth login # browser OAuth, session in OS keychain ``` @@ -118,8 +116,8 @@ CLI deep-dives (auth precedence, `--token` / `PIPEFY_TOKEN`, parity matrix): [`p ### Skill catalog install ```sh -npx skills add gbrlcustodio/pipefy-mcp-server # all skills -npx skills add gbrlcustodio/pipefy-mcp-server --skill pipefy-pipes-and-cards +npx skills add pipefy/ai-toolkit # all skills +npx skills add pipefy/ai-toolkit --skill pipefy-pipes-and-cards ``` Catalog and authoring guide: [`skills/README.md`](skills/README.md). diff --git a/RELEASE.md b/RELEASE.md index 6ddb49e8..afdeada3 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -8,7 +8,7 @@ PyPI publishing is **disabled** for tags that do not start with `v1.`. Pre-relea ### Public beta line (`v0.2.0-beta.*`) -The next **GitHub pre-release** after the standalone repo’s [`v0.1.0-beta.1`](https://github.com/gbrlcustodio/pipefy-mcp-server/releases/tag/v0.1.0-beta.1) is the **`v0.2.0-beta.*`** series on this monorepo (first cut: **`v0.2.0-beta.1`** unless you intentionally reuse another suffix). Same mechanics as any other **v0.x** tag: attach wheels to the GitHub Release; **no PyPI** until **`v1.`**. +The next **GitHub pre-release** after the standalone repo’s [`v0.1.0-beta.1`](https://github.com/pipefy/ai-toolkit/releases/tag/v0.1.0-beta.1) is the **`v0.2.0-beta.*`** series on this monorepo (first cut: **`v0.2.0-beta.1`** unless you intentionally reuse another suffix). Same mechanics as any other **v0.x** tag: attach wheels to the GitHub Release; **no PyPI** until **`v1.`**. The Release workflow requires the git tag (without leading `v`) to **exactly match** `__version__` in `packages/sdk/src/pipefy_sdk/__init__.py` (and the MCP/CLI/Auth/Infra copies). For example tag **`v0.2.0-beta.1`** implies **`__version__ = "0.2.0-beta.1"`** in all five packages before you push the tag (set via step 2 below using `version=0.2.0-beta.1`, or edit the five `__init__.py` files together). diff --git a/commands/install.md b/commands/install.md index 6f2e63ec..b9e50ec8 100644 --- a/commands/install.md +++ b/commands/install.md @@ -10,9 +10,9 @@ Otherwise prompt the user to confirm running: ``` uv tool install --force \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/cli" + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/cli" ``` Verify with `pipefy --version`. diff --git a/docs/MIGRATION.md b/docs/MIGRATION.md index 0499d85a..bef362ff 100644 --- a/docs/MIGRATION.md +++ b/docs/MIGRATION.md @@ -67,8 +67,8 @@ pipefy card get 12345 **`skills/` catalog** — Anthropic Skills-format playbooks for common Pipefy workflows, consumable by any LLM agent. Install via [`skills.sh`](https://github.com/vercel-labs/skills): ```sh -npx skills add gbrlcustodio/pipefy-mcp-server # all skills -npx skills add gbrlcustodio/pipefy-mcp-server --skill pipefy-pipes-and-cards +npx skills add pipefy/ai-toolkit # all skills +npx skills add pipefy/ai-toolkit --skill pipefy-pipes-and-cards ``` --- diff --git a/install.sh b/install.sh index 0da5ac53..99fdcc91 100755 --- a/install.sh +++ b/install.sh @@ -8,7 +8,7 @@ set -eu -REPO="gbrlcustodio/pipefy-mcp-server" +REPO="pipefy/ai-toolkit" TOOLS="pipefy_cli pipefy_mcp_server" # wheels installed as standalone uv tools YES=0 diff --git a/packages/cli/README.md b/packages/cli/README.md index 69282247..a9f2b294 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -6,9 +6,9 @@ Typer-based CLI for Pipefy. Exposes all MCP tool capabilities as terminal comman ```sh uvx \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/cli" \ + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/cli" \ --refresh pipefy-cli ``` @@ -16,9 +16,9 @@ Or persistently: ```sh uv tool install \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/cli" + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/cli" ``` The `--with` flags are required pre-1.0 because the workspace members are not yet on PyPI. At v1.0 this collapses to `uv tool install pipefy-cli`. diff --git a/packages/mcp/README.md b/packages/mcp/README.md index f57a292e..b5855db7 100644 --- a/packages/mcp/README.md +++ b/packages/mcp/README.md @@ -6,9 +6,9 @@ MCP server for Pipefy — **149 tools** for AI agents (Cursor, Claude Desktop, C ```sh uvx \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/mcp" \ + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/mcp" \ --refresh pipefy-mcp-server ``` @@ -36,7 +36,7 @@ Full reference (every `PIPEFY_*` variable, validation rules, TOML schema, preced ### macOS keychain `errSecParam (-25244)` -`pipefy auth login` may exit with `errSecParam (-25244)` at the final keychain-write step even though OAuth itself succeeded. The cause is not yet reliably diagnosed — direct `keyring.set_password` calls from the same uv-tool-installed Python succeed under repro testing, so this is likely a transient `Security.framework` condition rather than a deterministic per-binary ACL problem. If it occurs, retry the slash command (Claude Code) or `pipefy auth login` (terminal) first; as a fallback, run `pipefy auth login` once from a regular Terminal.app session and approve any macOS keychain dialog that appears. [Issue #235](https://github.com/gbrlcustodio/pipefy-mcp-server/issues/235) tracks platform-aware error messaging. +`pipefy auth login` may exit with `errSecParam (-25244)` at the final keychain-write step even though OAuth itself succeeded. The cause is not yet reliably diagnosed — direct `keyring.set_password` calls from the same uv-tool-installed Python succeed under repro testing, so this is likely a transient `Security.framework` condition rather than a deterministic per-binary ACL problem. If it occurs, retry the slash command (Claude Code) or `pipefy auth login` (terminal) first; as a fallback, run `pipefy auth login` once from a regular Terminal.app session and approve any macOS keychain dialog that appears. [Issue #235](https://github.com/pipefy/ai-toolkit/issues/235) tracks platform-aware error messaging. ### Claude Code: `claude mcp add` (per-project terminal flow) @@ -45,9 +45,9 @@ Useful when you want to wire the server without editing `~/.claude.json` by hand ```bash claude mcp add --scope project pipefy \ -- uvx \ - --with "pipefy-sdk @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/sdk" \ - --with "pipefy-auth @ git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/auth" \ - --from "git+https://github.com/gbrlcustodio/pipefy-mcp-server@latest#subdirectory=packages/mcp" \ + --with "pipefy-sdk @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/sdk" \ + --with "pipefy-auth @ git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/auth" \ + --from "git+https://github.com/pipefy/ai-toolkit@latest#subdirectory=packages/mcp" \ pipefy-mcp-server ``` diff --git a/packages/mcp/src/pipefy_mcp/_docs.py b/packages/mcp/src/pipefy_mcp/_docs.py index b4967368..9d67915a 100644 --- a/packages/mcp/src/pipefy_mcp/_docs.py +++ b/packages/mcp/src/pipefy_mcp/_docs.py @@ -2,4 +2,6 @@ from pipefy_mcp import __version__ -DOCS_SETUP_REF = f"https://github.com/gbrlcustodio/pipefy-mcp-server/blob/v{__version__}/README.md#installation" +DOCS_SETUP_REF = ( + f"https://github.com/pipefy/ai-toolkit/blob/v{__version__}/README.md#installation" +) diff --git a/skills/README.md b/skills/README.md index f9effee3..f96d1ed9 100644 --- a/skills/README.md +++ b/skills/README.md @@ -7,9 +7,9 @@ Markdown playbooks in **Anthropic Skills** format: each file describes a Pipefy **Install via [`skills.sh`](https://github.com/vercel-labs/skills)** (55+ agent targets — Claude Code, Cursor, Codex, OpenCode, …): ```bash -npx skills add gbrlcustodio/pipefy-mcp-server # all skills -npx skills add gbrlcustodio/pipefy-mcp-server --skill pipefy-pipes-and-cards -npx skills add gbrlcustodio/pipefy-mcp-server -g -a claude-code -y # CI-friendly +npx skills add pipefy/ai-toolkit # all skills +npx skills add pipefy/ai-toolkit --skill pipefy-pipes-and-cards +npx skills add pipefy/ai-toolkit -g -a claude-code -y # CI-friendly ``` `skills.sh` reads canonical `skills/**/SKILL.md` files directly from this repo; no install or wheel needed. @@ -17,7 +17,7 @@ npx skills add gbrlcustodio/pipefy-mcp-server -g -a claude-code -y # CI-fri **Reference from source (no install):** ```bash -git clone https://github.com/gbrlcustodio/pipefy-mcp-server.git +git clone https://github.com/pipefy/ai-toolkit.git # Reference paths such as skills/pipes-and-cards/pipefy-pipes-and-cards/SKILL.md # in your IDE rules or agent context. ```