Releases: genomewalker/zellij-mcp
v0.10.1
Bug Fixes
-
Pane naming in detached sessions: Fixed
create_named_panenot properly naming panes when running in detached sessions. Added delay and verification after pane creation, with retry logic to find and rename the correct pane. -
Claude pane protection: Added safeguards to prevent accidentally closing the Claude pane:
destroy_named_paneblocks closing any pane with "claude" in the nameclose_panechecks the focused pane before closing
Documentation
- Added
BUG-pane-naming.mddocumenting the root cause and fix
v0.10.0 - Spatial Layout Visualization
What's New
session_map Visual Layout
The session_map tool now shows the actual spatial arrangement of panes within each tab:
╔══════════════════════════════════════════════════════════════╗
║ ● fascinating-quasar ║
╚══════════════════════════════════════════════════════════════╝
[Tab #1] idle
┌────────────────────────────┐┌─────────────┐┌─────────────┐
│ ││ shell ││ │
│ claude │├─────────────┤│ shell │
│ ││ shell ││ │
└────────────────────────────┘└─────────────┘└─────────────┘
- Shows side-by-side splits, stacked panes, and nested layouts
- Focused panes highlighted in orange
- Proportional sizing based on actual layout percentages
- Properly skips UI chrome (tab-bar, status-bar plugins)
Bug Fixes
- Fixed layout parser to handle nested pane structures
- Fixed plugin pane filtering (no more phantom shells)
- Improved T-junction rendering for overlapping borders
v0.6.0 - Autonomous Workflow Tools
Major Update: Autonomous Workflow Tools for Bioinformatics
This release adds 20+ new tools enabling fully autonomous workflow execution through OpenCode or Claude Code.
New Features
Core I/O with Pane Targeting
write_to_pane- Send text to any pane by namesend_keys- Ctrl+C, arrows, function keyssearch_pane- Regex search in pane content
Output Monitoring
wait_for_output- Block until pattern appearswait_for_idle- Wait for output to stabilizetail_pane- Incremental output reading
Compound Operations
run_in_pane- Execute command with wait and capturecreate_named_pane- Idempotent pane creation with registrydestroy_named_pane- Cleanup named panes
REPL Interaction
repl_execute- Run code in IPython/R/Julia, capture outputrepl_interrupt- Send Ctrl+C with prompt detection
SSH/HPC Integration
ssh_connect- Open SSH sessions in named panesssh_run- Execute remote commandsjob_submit- Submit SLURM/PBS jobs with trackingjob_status- Check job state
Infrastructure
SessionStateclass for persistent pane/SSH/job registrywith_pane_focushelper for transparent pane targetingstrip_ansiutility for clean LLM output- Enhanced layout parser with full metadata
Breaking Changes
- Removed
write_bytes(usesend_keys) - Removed
run_command(userun_in_pane) - Removed
dump_screen(useread_pane)
Tool Count
56 tools total (was 35 in v0.5.0)
v0.5.0 - New Docs & GitHub Pages
What's New
New README
- Modern layout with badges
- Clear installation instructions
- Natural language examples
- Safety guidelines section
- Combines well with prism-nvim section
GitHub Pages Site
- Animated demo showing pane creation
- Orange theme matching Zellij branding
- Installation steps with copy buttons
- Tool reference grid
Website: https://genomewalker.github.io/zellij-mcp/
Full Changelog
v0.4.0 - Proper Plugin Structure
What's New
Proper Plugin Structure
- Added
marketplace.jsonfor plugin marketplace integration - Updated
install.shto useclaude mcp addcommand - Updated README with clear installation instructions
Installation
git clone https://github.com/genomewalker/zellij-mcp
cd zellij-mcp
./scripts/install.shFull Changelog
v0.3.0
What's New
Safety Guidelines for Running Inside Zellij
Added comprehensive documentation for safely using zellij-mcp when Claude Code runs inside a Zellij pane:
- Always specify your session - Use
session_infoto discover session name, then pass--sessionon all commands - Never close your own pane - Safe patterns for creating and cleaning up work tabs
- Capture output correctly - Switch tabs before dumping screen content
- Recommended workflow - Step-by-step pattern for running commands in separate tabs