The 33GOD Agentic IDE
A Zellij fork optimized for multi-agent workflows
[33GOD Features] [Installation] [Configuration] [Roadmap] [FAQ]
Perth is a specialized fork of Zellij designed to be the primary IDE for the 33GOD ecosystem. It extends Zellij's terminal multiplexer capabilities with native support for:
- Visual Notifications - Per-pane alerts with styled borders (error/success/warning)
- Animation Engine - Frame-based UI animations for activity indicators
- PostgreSQL Persistence - Session state survives crashes and reboots
- ZDrive Integration - Programmatic workspace control with Redis-backed context
Perth is built for managing complex, multi-agent workflows where dozens of AI agents operate concurrently. It provides immediate visual feedback on background activity, robust session recovery, and seamless CLI automation.
Visual alerts on panes and tabs when background tasks complete:
zellij notify --pane-id 3 --style error --message "Build failed"- Styles: error (red), success (green), warning (yellow)
- Auto-clear: Notifications dismiss when pane receives focus
Low-CPU animations for active session indicators:
- Candycane pattern:
[block]|[dark]|[medium]|[light]shifting at 60fps - Dirty region updates for efficient rendering
- Adaptive FPS (degrades to 30fps under high CPU load)
Full session state persisted to database:
export DATABASE_URL=postgres://perth:perth@localhost:5432/perth
zellij attach my-session # State auto-persisted- Write-behind caching (non-blocking)
- Graceful degradation if database unavailable
Programmatic workspace control via external zdrive tool:
zdrive pane api-server # Navigate by semantic name
zdrive pane log api "Started" # Track development intent
zdrive attach --plane-ticket STORY-042 # Identifier-based attachment- Redis-backed metadata persistence
- Intent history with timestamps
- Agent/human attribution tracking
Zellij is a workspace aimed at developers, ops-oriented people and anyone who loves the terminal. Similar programs are sometimes called "Terminal Multiplexers".
Perth inherits all Zellij features: layouts, floating/stacked panes, WebAssembly plugins, web-client, and more. See the Zellij documentation for base functionality.
For 33GOD features (notifications, persistence):
- PostgreSQL 16+ (optional but recommended)
- Redis (for ZDrive CLI, optional)
For base Zellij functionality:
- No additional dependencies
# Clone the repository
git clone https://github.com/33GOD/perth.git
cd perth
# Build and install
cargo install --path .
# Optional: Set up PostgreSQL persistence
export DATABASE_URL=postgres://perth:perth@localhost:5432/perthSee THIRD_PARTY_INSTALL.md for OS-specific packages.
Perth configuration lives in ~/.config/zellij/config.yaml. 33GOD-specific settings:
# PostgreSQL connection (overridden by DATABASE_URL env var)
database_url: postgres://perth:perth@localhost:5432/perth
# Notification defaults
notifications:
auto_clear_on_focus: true
animation_fps: 60For base Zellij functionality (without 33GOD features):
bash <(curl -L https://zellij.dev/launch)- Clone the project
- In the project folder, for debug builds run:
cargo xtask run - To run all tests:
cargo xtask test
For more build commands, see CONTRIBUTING.md.
For configuring Zellij, please see the Configuration Documentation.
Issues in this repository, whether open or closed, do not necessarily indicate a problem or a bug in the software. They only indicate that the reporter wanted to communicate their experiences or thoughts to the maintainers. The Zellij maintainers do their best to go over and reply to all issue reports, but unfortunately cannot promise these will always be dealt with or even read. Your understanding is appreciated.
Goal: Transform Perth into an agentic IDE with a functional Dashboard tab.
| Sprint | Status | Features |
|---|---|---|
| Sprint 1 | Completed | Persistence Manager, Notification Bus, Animation Engine, ZDrive Integration |
| Sprint 2 | Not Started | Integration Adapter Framework, Bloodbank/iMi/Jelmore Adapters |
| Sprint 3 | Not Started | Template Registry, Layout Instantiation |
| Sprint 4 | Not Started | Dashboard Components (Bloodbank Feed, iMi Browser, ZDrive Browser) |
| Sprint 5 | Not Started | E2E Integration, Performance Validation |
See sprint-plan-perth-2026-01-22.md for detailed story breakdown.
Perth maintains compatibility with upstream Zellij. See the Zellij roadmap for base features.
- PRD - Product Requirements Document
- Architecture - System Architecture
- Sprint Plan - Story breakdown and sprint allocation
- Sprint 1 Summary - Completed Sprint 1 deliverables
- ZDrive Notes - External ZDrive CLI integration
Perth: Named for the Australian city, continuing the tradition of naming 33GOD components after places. Perth represents a "fresh start" destination, fitting for an IDE designed for new agent-driven workflows.
Zellij: From Wikipedia - Zellij (Arabic: zillij) is a style of mosaic tilework made from individually hand-chiseled tile pieces. The pieces were typically of different colors and fitted together to form various patterns based on tessellations, most notably elaborate Islamic geometric motifs such as radiating star patterns. This form of Islamic art is found in the architecture of Morocco, Algeria, Tunisia, and al-Andalus.
MIT
