Skip to content

Releases: 24601/opencode-zellij-namer

v1.1.3 - Fix plugin export format

20 Dec 01:58

Choose a tag to compare

Bug Fix

  • Fix: Use named export (export const ZellijNamer) instead of default export. OpenCode requires named exports for plugin loading.
  • Also kept default export for backwards compatibility.

v1.1.2 - Trigger rename on startup

20 Dec 01:52

Choose a tag to compare

Bug Fix

  • Fix: Trigger session rename immediately when plugin loads, not just on idle events. Previously the plugin would only rename after the first session.idle event.

v1.1.1 - Fix default export

20 Dec 01:48

Choose a tag to compare

Bug Fix

  • Fix: Add export default for OpenCode plugin loading. The plugin was not being loaded because OpenCode requires a default export, not a named export.

This fix resolves sessions not being renamed (staying with Zellij's random names like outstanding-cymbal).

v1.1.0

18 Dec 22:17

Choose a tag to compare

Features

AGENTS.md Integration

  • Auto-read naming guidance from project's AGENTS.md file (enabled by default)
  • Search locations: ./AGENTS.md, ./.github/AGENTS.md, ./docs/AGENTS.md
  • Extracts ## Naming or ## Session Naming sections
  • Falls back to ## Guidelines section with naming keywords

Custom Instructions

  • Add OPENCODE_ZN_INSTRUCTIONS env var for personal naming preferences
  • Custom instructions take precedence over AGENTS.md when they conflict

Configuration

Variable Default Description
OPENCODE_ZN_INSTRUCTIONS - Custom naming instructions for AI
OPENCODE_ZN_USE_AGENTS_MD 1 Set to 0 to disable AGENTS.md reading

Tests

  • 63 passing tests

v1.0.1

18 Dec 20:55

Choose a tag to compare

Fix repository URL for npm provenance

v1.0.0 - Initial Release

18 Dec 20:54

Choose a tag to compare

Features

  • 🤖 AI-powered session naming using Gemini 3 Flash Preview
  • 🎯 Automatic intent detection (feat, fix, debug, test, refactor, doc, ops, review, spike)
  • 📁 Smart tag extraction from branch names, directories, and context
  • ⚡ Non-blocking, debounced updates
  • 🔧 Fully configurable via environment variables
  • 🔒 Security-hardened (shell injection prevention, path traversal protection)
  • 🧪 48 passing tests

Installation

# Add to ~/.config/opencode/opencode.json
"plugin": ["opencode-zellij-namer"]

Configuration

Set GEMINI_API_KEY for AI-powered naming, or use heuristic fallback without it.

See README for full documentation.