@skastr0/quartz-opencode-plugin

OpenCode plugin wrapper for Quartz TypeScript code intelligence.

Status

Experimental. The plugin is publishable as a Bun/ESM package, but the repository is still using explicit release gates before any real npm upload.

Install

After the first npm release:

bun add -d @skastr0/quartz-opencode-plugin

The package exports @skastr0/quartz-opencode-plugin/server.

Build

bun run build

The bundle is written to dist/server.js and exported as @skastr0/quartz-opencode-plugin/server.

Runtime Behavior

The plugin roots one persistent native Quartz analyzer at the OpenCode workspace directory and reuses it across tool calls. It marks the analyzer cache dirty from OpenCode's file.edited and file.watcher.updated events, with tool-hook fallbacks for apply_patch, edit, write, and morph-mcp_edit_file. The analyzer is disposed when OpenCode emits server.instance.disposed for that workspace directory; deleting a session does not close it.

Use the optional package argument when the workspace has multiple discovered TypeScript packages.

Tools

Discovery:

• type_packages
• type_symbols
• type_info
• type_expand
• type_related
• type_search

Analysis:

• type_eval
• type_diagnostics
• type_check_snippet
• type_at_position
• type_file
• type_refresh

Relationships and refactors:

• type_compatible
• type_graph
• type_refactor_preview
• type_why_error
• type_explain
• type_transform_search
• type_verify_contract

Examples

{"tool":"type_symbols","args":{"pattern":"^User","kind":"interface","limit":10}}

{"tool":"type_info","args":{"symbol":"User"}}

{"tool":"type_transform_search","args":{"from":"User","to":"UserDTO","limit":5}}

The plugin returns JSON strings for most tool results, matching the core analyzer data shapes. type_refresh clears cached TypeScript projects and returns the analyzer refresh result.