@vanillagreen/pi-claude-bridge 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 1.0.0
+
+Initial vstack fork of `elidickinson/pi-claude-bridge`.
+
+- Registers Claude Code as a Pi provider via `claude-bridge/*` models.
+- Removes the upstream AskClaude tool; this package is provider-only.
+- Adds vstack extension-manager settings.
+- Adds opt-in forwarding for `APPEND_SYSTEM.md` and recognized Pi `before_agent_start` prompt hooks (`pi-agents-tmux`, `pi-task-panel`, `pi-caveman`).
+- Keeps upstream provider fixes for session sync/rebuild, compact recovery, abort recovery, ID-based tool-result matching, skills forwarding, strict MCP config, cloud MCP suppression, and Opus thinking display.
+- Pins and bundles Claude Agent SDK `0.2.128`, with auto-detection of the local `claude` executable for vstack installs without `node_modules`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eli Dickinson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# pi-claude-bridge
+
+![Claude bridge provider](https://raw.githubusercontent.com/vanillagreencom/vstack/main/pi-extensions/pi-claude-bridge/assets/claude-bridge1.png)
+
+Claude Code provider bridge for Pi. It registers `claude-bridge/*` models and routes Pi turns through the Claude Agent SDK while keeping Pi's tools in the Pi TUI.
+
+This package is a vstack fork of [`elidickinson/pi-claude-bridge`](https://github.com/elidickinson/pi-claude-bridge). The provider, MCP tool bridge, session sync, streaming, and Claude Code SDK plumbing come from that project; this fork removes the AskClaude tool and adds vstack-controlled prompt-context forwarding.
+
+## What it provides
+
+- `claude-bridge/claude-opus-4-7`, Sonnet, and Haiku models in `/model`.
+- Pi tool calls bridged to Claude Code through a local MCP server.
+- Session reuse/rebuild so Claude Code follows Pi history across normal turns, `/compact`, forks, tree navigation, and abort recovery.
+- Thinking-level forwarding, summarized Opus thinking display, MCP isolation, and Claude cloud-MCP suppression to reduce token overhead.
+- Optional forwarding of Pi-only context that upstream does not pass to Claude Code.
+
+## Prompt context
+
+Default behavior matches upstream: append `AGENTS.md` plus Pi's skills block to Claude Code's `claude_code` preset prompt.
+
+Extra Pi prompt context is **off by default** and can be enabled in `/extensions:settings` → `Claude Bridge`:
+
+| Setting | Default | Effect |
+| --- | --- | --- |
+| `includeAppendSystemPromptMd` | off | Forward project/global `APPEND_SYSTEM.md`, including `.pi/APPEND_SYSTEM.md`. |
+| `includeProjectAgentsHook` | off | Forward recognized `pi-agents-tmux` `before_agent_start` additions such as the Project Agents/Subagents list. |
+| `includeTaskPanelHook` | off | Forward recognized `pi-task-panel` workflow reminders. |
+| `includeCavemanHook` | off | Forward recognized `pi-caveman` response-style prompt additions. |
+
+The bridge detects these hook additions from the effective Pi system prompt for the current turn and forwards only enabled recognized blocks.
+
+## Settings
+
+| Setting | Default | Notes |
+| --- | --- | --- |
+| `enabled` | on | Register the Claude bridge provider; reload required. |
+| `appendSystemPrompt` | on | Forward `AGENTS.md` + skills. |
+| `strictMcpConfig` | on | When Claude Code filesystem settings are loaded, block filesystem MCP auto-loads; Pi owns tool execution. |
+| `pathToClaudeCodeExecutable` | auto | Explicit `claude` binary path; empty auto-detects `claude` or `claude-code` on PATH. |
+
+Legacy config files are still read: `~/.pi/agent/claude-bridge.json` and `.pi/claude-bridge.json`. vstack extension-manager settings override them.
+
+## Differences from upstream
+
+- No AskClaude tool; this package is provider-only.
+- vstack extension-manager settings for prompt forwarding and Claude Code options.
+- Bundled runtime dependencies for vstack installs; the bridge auto-detects the local Claude Code executable.
+- Opt-in delivery of `APPEND_SYSTEM.md` and recognized Pi `before_agent_start` prompt hooks.
+- Keeps upstream provider fixes: ID-based tool-result matching, compact/session rebuild handling, abort recovery, skill read-tool rewriting, strict MCP config, cloud MCP suppression, and Opus 4.7 thinking display forcing.
+
+## Debugging
+
+Set `CLAUDE_BRIDGE_DEBUG=1` to write bridge logs to `~/.pi/agent/claude-bridge.log` and per-query Claude Code CLI logs under `~/.pi/agent/cc-cli-logs/`.