Introduction

wsx is a terminal UI that runs Claude Code, Pi, Hermes, Codex, or oh-my-pi sessions in their own git worktrees. Use it to launch, watch, and steer many agent sessions in parallel from one dashboard, including several agents working together in one workspace.

Key features

  • Parallel sessions in worktrees: each workspace gets its own branch, worktree, and agent session. See Dashboard.
  • Multiple coding agents: pick Claude, Pi, Hermes, Codex, or oh-my-pi per workspace. See Coding agents.
  • Multi-agent workspaces: run several agents in one worktree and have them message each other. See Multi-agent workspaces.
  • Attention alerts: status glyphs, a terminal bell, and a live activity line show which sessions need you. See Status indicators.
  • Agent status and recaps: agents report their status and a goal/state/next recap with wsx status and wsx recap. See Status and recap.
  • Project manager digest: one pane summarizes what every workspace is for and what's next. See Project manager digest.
  • Configurable detail bar: up to four containers of built-in or custom modules. See Detail bar.
  • Tags and hiding: label workspaces and hide them by tag or PR state. See Tags and hiding.
  • Split panes and saved layouts: watch other workspaces while attached. See Updates panel and split panes.
  • Pinned commands and prompt tags: fire saved prompts with Ctrl-x <digit> and insert XML-wrapped prompt sections. See Pinned commands and Prompt tags.
  • Bundled agent skills: wsx, agent-review, and handoff. See Agent skills.
  • Editor, terminal, and diff hooks: open a workspace in your tools with one key. See Editor, terminal, and diff.
  • Editor-hosted agents: give an agent in your editor the workspace's context with wsx context. See Editor-hosted agents.
  • Related repos: let agents read sibling repos without editing them. See Related repos.
  • Remote and shared workspaces: attach over ssh, or run agents in tmux on this or another host. See Remote access and Shared workspaces.
  • Desktop widgets: a waybar module, a KDE Plasma applet, and a macOS menubar plugin. See Desktop widgets.
  • Less setup per workspace: auto-rename branches from your first prompt, and run per-repo setup and archive scripts. See Auto-rename and Setup and archive scripts.

Where to go next