# RimZ: Realtime Dashboard for Agentic Coding with tmux and Zellij

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/rimio-ai-rimz
Generated for open source discovery and AI-assisted research.

RimZ is a powerful realtime dashboard and control room designed for agentic coding, enabling humans and AI agents to collaborate seamlessly within tmux or Zellij environments. Built with Rust, it provides comprehensive observability, orchestration, and automation capabilities for managing fleets of coding agents. This tool enhances productivity by offering real-time insights, message-based steering, and scriptable workflows for AI-driven development.

GitHub: https://github.com/rimio-ai/rimz
OSRepos URL: https://osrepos.com/repo/rimio-ai-rimz

## Summary

RimZ is a powerful realtime dashboard and control room designed for agentic coding, enabling humans and AI agents to collaborate seamlessly within tmux or Zellij environments. Built with Rust, it provides comprehensive observability, orchestration, and automation capabilities for managing fleets of coding agents. This tool enhances productivity by offering real-time insights, message-based steering, and scriptable workflows for AI-driven development.

## Topics

- agent-orchestration
- agentic-ai
- ai-agents
- coding-agent
- rust
- terminal-ui
- tmux
- zellij

## Repository Information

Last analyzed by OSRepos: Fri Sep 18 2026 00:31:14 GMT+0100 (Western European Summer Time)
Detail views: 2
GitHub clicks: 1

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

RimZ is a cutting-edge realtime dashboard and control room for harnessing agentic coding, built on tmux and Zellij. It's designed to facilitate seamless collaboration between a human developer and a fleet of AI agents within a single terminal room. RimZ provides an immediate overview of every agent, displaying its live status, task, context health, and real-time cost, with a sidebar that intelligently routes your attention to where it's most needed.

This lightweight Rust-based binary integrates directly into your existing tmux or Zellij setup, preserving your keybinds and allowing official agent CLIs to run untouched. RimZ lays the foundation for advanced harness engineering and loop engineering, offering primitives like a robust sidebar for observability, a unified command grammar for various agents, durable messages for steering, supervised runs for scripting, and event-driven wakeups for automation.

## Why Use and Key Benefits

RimZ offers a unique set of features that streamline agentic coding workflows, making it an indispensable tool for developers working with AI agents:

*   **Extremely Lightweight Integration:** Runs as a single binary within your familiar terminal multiplexer, ensuring zero learning curve and compatibility with existing tools and official agent applications.
*   **Realtime Harness Dashboard:** Gain immediate insights into your agent fleet, including working state, task, model usage, effort, context health, live token statistics, and dollar costs.
*   **Intelligent Attention Routing:** The sidebar triages your fleet, highlighting agents that require your input or attention, allowing you to quickly navigate to the relevant pane.
*   **Worktrees for Every Agent:** Launch agents in isolated Git worktrees with dynamic layouts, enabling parallel development on different features without conflicts.
*   **Cross-Model Agent Teams:** Combine the strengths of various AI models and providers into cohesive teams, assigning roles for planning, coding, or reviewing to optimize outcomes.
*   **Message-Driven Agent Communication:** Interact with agents using a Slack-like messaging system, ensuring durable message delivery, respecting context windows, and facilitating agent-to-agent communication.
*   **End-to-End Scriptability:** Integrate agents into scripts, CI pipelines, and automated workflows with `rimz agents -p`, offering supervised turns, exit codes, and JSON output for robust automation.
*   **Engineer Your Own Loops:** Schedule agent runs based on time, intervals, cron expressions, or as watchdogs that trigger on command results, enabling hands-off automation.
*   **Auto-Continue While Away:** Agents automatically recover from rate limits and transient API errors, resuming work without manual intervention, allowing you to step away with confidence.
*   **Remote Control from Your Phone:** Answer agent prompts and steer your fleet directly from official Claude and ChatGPT mobile apps, maintaining workflow continuity from anywhere.
*   **Continuous Local or Remote Work:** Connect to your RimZ room from any location via SSH, with self-healing links that ensure your session persists and agents continue working seamlessly.

RimZ is currently beta software, actively developed and dogfooded by its creators, ensuring it's ready for daily personal use while continuously evolving.

## Installation

Installing RimZ is straightforward, with options for various environments.

**Using the Install Script:**

The recommended way to install RimZ is via the official install script:

sh
curl -fsSL https://raw.githubusercontent.com/rimio-ai/rimz/main/scripts/install.sh | sh


On macOS, this script automatically uses Homebrew if available.

**Homebrew (macOS/Linux):**

If you prefer using Homebrew:

sh
brew install rimio-ai/rimz/rimz


**Cargo (Rust Package Manager):**

For Rust developers, you can install RimZ directly from crates.io:

sh
cargo install --locked rimz


After installation, the first `rimz` run will offer to install necessary hooks for agents to report to the room. You can preview these changes with `rimz hooks install --dry-run`.

## Examples

Here are some common ways to get started and leverage RimZ in your daily workflow:

**Opening a Room and Launching Agents:**

Navigate to your project directory and open a RimZ room, then launch your preferred agents:

sh
cd ~/code/query-engine
rimz
claude
codex


**Working with Agent Teams and Worktrees:**

Launch multiple agents in isolated worktrees with dynamic layouts:

sh
rimz agents claude,codex --worktree=feat-x       # Claude + Codex, side by side
rimz agents 'vim,claude+term' --worktree=feat-y  # editor, agent, shell in one tab
rimz teams forge -w feat-complex                 # Use a predefined team for complex features


**Steering Agents with Messages:**

Communicate with your agents, addressing them by their handle:

sh
rimz message @claude "add coverage for the expiry edge cases"
rimz message @coder --wait "did the migration land? one line"
git diff main | rimz message @reviewer --stdin "review this"


**Automating Tasks with Scripting and Loops:**

Integrate agents into scripts or set up automated loops:

sh
rimz agents codex "Prepare the release checklist." -p --timeout 30m --output-format json
rimz loop add watchdog --check "cargo test" --on fail \
    --agent codex --prompt "fix the failing test" --every 15m


**Remote Access:**

Connect to your RimZ room from anywhere:

sh
rimz remote add dev dev-box:~/code/query-engine
rimz remote connect dev          # Rebuilds the room, agents where you left them
rimz remote connect dev --web    # Access the same room in your browser


## Links

For more in-depth information and to contribute to the project, refer to the official documentation and repository:

*   **GitHub Repository:** [https://github.com/rimio-ai/rimz](https://github.com/rimio-ai/rimz){:target="_blank"}
*   **Documentation Index:** [https://github.com/rimio-ai/rimz/blob/main/docs/README.md](https://github.com/rimio-ai/rimz/blob/main/docs/README.md){:target="_blank"}
*   **Installation Guide:** [https://github.com/rimio-ai/rimz/blob/main/docs/guide/installation.md](https://github.com/rimio-ai/rimz/blob/main/docs/guide/installation.md){:target="_blank"}
*   **Design Principles:** [https://github.com/rimio-ai/rimz/blob/main/DESIGN.md](https://github.com/rimio-ai/rimz/blob/main/DESIGN.md){:target="_blank"}
*   **Architecture Overview:** [https://github.com/rimio-ai/rimz/blob/main/ARCHITECTURE.md](https://github.com/rimio-ai/rimz/blob/main/ARCHITECTURE.md){:target="_blank"}
*   **License (MIT):** [https://github.com/rimio-ai/rimz/blob/main/LICENSE](https://github.com/rimio-ai/rimz/blob/main/LICENSE){:target="_blank"}