@amitkot/pi-open-zed

Host-side Zed IDE bridge for Pi — opens files at a line number from the coding agent.

Packages

Package details

extension

Install @amitkot/pi-open-zed from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@amitkot/pi-open-zed
Package
@amitkot/pi-open-zed
Version
0.1.0
Published
Jun 14, 2026
Downloads
not available
Author
amitkot
License
MIT
Types
extension
Size
5.1 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

open-zed extension

Opens files in the Zed IDE from Pi, bypassing macOS sandbox restrictions.

Purpose

The sandboxed bash tool cannot run zed (like gh). This extension calls zed on the host via child_process.execFile, so the LLM can open files for the user's inspection or editing in their IDE.

Threat Model

  • Risk: Accidental file opens, minimal.
  • Mitigations:
    • Uses child_process.execFile with argument arrays (no shell).
    • Adds execution timeout.
    • Does not pass full process environment to subprocesses.
    • Only opens files — no edits, no mutations.

Requirements

  • Zed IDE installed on the host machine
  • zed available on PATH

Tools

  • open_zed — opens a file in Zed, optionally at a specific line number

Parameters

  • path (required) — file path to open
  • line (optional) — line number to navigate to (1-indexed)

Prompt Guidelines

  • Use open_zed when the user asks to open or edit a file in their Zed IDE.
  • Do not use raw zed shell commands when this tool is available.

Installation

pi install npm:@amitkot/pi-open-zed

For local development from a checkout:

pi -e ./packages/open-zed/src/index.ts

To install the whole pi-tools monorepo from git:

pi install git:github.com/amitkot/pi-tools

After installation or changes, restart Pi or run:

/reload