Summary

Ataraxy-Labs/opensessions is a terminal session manager designed to enhance the tmux experience by providing an integrated sidebar. It addresses the complexity of managing numerous terminal sessions, agents, and local development environments by offering instant switching, real-time agent status, and contextual information like git branches. This tool benefits power users and developers who rely heavily on tmux and seek improved visibility and control over their terminal workflows without abandoning their existing setup.

How It Works

The project integrates with tmux via the TPM plugin manager. It operates by running a local Bun server on 127.0.0.1:7391, which exposes an HTTP API. External agents and scripts can push status updates, progress indicators, and logs to this server. The core of the user interface is a TUI sidebar client, built with Solid, that consumes this data, displaying live agent states for tools like Amp, Claude Code, Codex, and OpenCode, alongside session context such as git branches and detected localhost ports. This approach allows for a non-intrusive enhancement to existing tmux workflows.

Quick Start & Requirements

• Primary install: Add set -g @plugin 'Ataraxy-Labs/opensessions' to ~/.tmux.conf, then run tmux source-file ~/.tmux.conf followed by ~/.tmux/plugins/tpm/bin/install_plugins.
• Prerequisites: tmux, bun, TPM (tmux plugin manager).
• Links: Programmatic API reference: docs/reference/programmatic-api.md.

Highlighted Details

• Live agent status monitoring for Amp, Claude Code, Codex, and OpenCode, with per-thread unseen markers for done, error, and interrupted states.
• Session context display including git branch, working directory, and detected localhost ports.
• A programmatic metadata API allowing scripts and agents to push status, progress, and logs via HTTP endpoints (/set-status, /set-progress, /log).
• Fast session switching capabilities using various keybindings, session reordering, and hiding/restoring functionality.

Maintenance & Community

No specific details regarding maintainers, sponsorships, or community channels (e.g., Discord, Slack) were found in the provided README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license generally permits commercial use and linking, with no specific restrictions noted in the provided text.

Limitations & Caveats

The integration with Zellij is experimental and not currently supported. The application is hardcoded to run on 127.0.0.1:7391, and not all typed configuration fields are yet active in the running server.