Zed module

[bpmct]

A discussion dedicated to the Zed module. Share your thoughts, questions, and feedback here.

Module Scorecard

Presentation & Onboarding	IDE Integration	Credential Hygiene	Restricted-Environment Readiness	Engineering Quality	Overall
12 / 17	19 / 19	20 / 20	2 / 2	10 / 10	93 / 100

Drilldown

Presentation & Onboarding — 12 / 17

Criterion	Max	Score	Notes
Configuration-mode examples	12	12	README documents five examples covering all major modes: default launch, folder for a specific directory, display_name/order for UI placement, agent_name for multi-agent workspaces, and settings with an MCP server JSON example. Each example uses sensible defaults and is self-contained.
Visual preview	5	0	No image, GIF, or video is embedded in the README. The frontmatter references an SVG icon (icon: ../../../../.icons/zed.svg), but an icon is not a visual preview of the module in action.

Credential Hygiene — 20 / 20

Criterion	Max	Score	Notes
Secrets marked sensitive	16	16	No variable in main.tf is a credential or secret; all inputs are configuration values (agent ID, folder path, display name, JSON settings blob). The settings variable is a general-purpose config JSON, not a dedicated secret input. README examples use placeholder values ("some-command", "arg-1") and contain no inline literal or placeholder API keys.
Non-hardcoded auth path	4	4	README explicitly states: "Zed needs you to either have Coder CLI installed with coder config-ssh run or Coder Desktop." The coder_app URL uses the zed://ssh/ protocol, which delegates authentication to the Coder SSH configuration rather than embedding raw keys in the template.

Restricted-Environment Readiness — 2 / 2

Criterion	Max	Score	Notes
Mirrorable artifact source	5	N/A	Module downloads or installs nothing of its own. It writes a local settings file and creates a zed://ssh/ app URL; Zed itself lives on the user's desktop. No download URL exists to override.
Bring-your-own binary	10	N/A	No tool is downloaded or installed by this module. Zed is a pre-existing desktop application on the user's machine.
Egress transparency	3	N/A	Module performs no network downloads or external API calls at install or runtime. The only external interaction is the user's local Zed client connecting via SSH, which is outside the module's control.
Runs without sudo	2	2	The coder_script in main.tf writes to $HOME/.config/zed/settings.json (or $XDG_CONFIG_HOME/zed/). It uses mkdir -p, base64 -d, jq, and printf—none of which require root. No sudo invocation appears anywhere in the script.

Engineering Quality — 10 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All eight variables have clear description fields and sensible default values (e.g., display_name = "Zed", slug = "zed", folder = ""). Types are appropriate (string, number). No validation is strictly necessary for these free-form config values.
Test coverage	4	4	zed.tftest.hcl covers business logic: default URL construction, folder appending, agent_name hostname, base64 encoding of settings, and empty-settings short-circuit. main.test.ts provides end-to-end container tests: settings file written with correct JSON (including special characters), merge behavior with jq, and no-script-when-empty. Clear separation of concerns.

IDE Integration — 19 / 19

Criterion	Max	Score	Notes
Dashboard entry point	7	7	coder_app.zed is created with external = true and URL zed://ssh/${hostname}${folder}. Clicking the app in the Coder dashboard launches Zed via the custom protocol. Documented in the README with the default example.
Managed configuration	6	6	The settings input accepts a JSON string that is written (or merged via jq) to ~/.config/zed/settings.json on agent start. README includes a dedicated section "Configure Zed settings including MCP servers" with a full jsonencode example showing context_servers.
Configurable folder or workdir	6	6	The folder variable appends a path to the zed://ssh/ URL. README documents this with the "Open in a specific directory" example (folder = "/home/coder/project").
Pre-installed extensions	6	N/A	Zed is a native desktop IDE, not a web IDE. This criterion applies only to web IDEs.

Overall — 93 / 100

Raw 63 / 68 → round(63 / 68 × 100) = 93

---

Scored against SCORECARD.md on 2026-10-19 with solstice-1.