psmux

Toggle the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS flag in ~/.claude/settings.json.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Oruga420/claude-code-skills --skill psmux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: psmux
Source: https://github.com/Oruga420/claude-code-skills/tree/main/psmux
Command: npx skills add https://github.com/Oruga420/claude-code-skills --skill psmux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a safe, repeatable way to enable, disable, and install psmux so Claude Code can spawn Agent Teams into split terminal panes without manual JSON edits or guesswork.

Core Features & Use Cases

  • Installation check and bootstrap: Detects whether psmux is installed and installs it via winget if missing, reporting version information.
  • Feature flag management: Reads and updates the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS key inside the env object of ~/.claude/settings.json while preserving all other settings.
  • Toggle control: Supports explicit on/off commands and an argument-less toggle behavior for developers who want quick enable/disable of Agent Teams.

Quick Start

Use the psmux skill to enable Agent Teams and install psmux if needed by saying /psmux on.

Frequently Asked Questions about psmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable Claude Code Agent Teams split-pane sessions?

To enable Claude Code Agent Teams split-pane sessions, you need to set the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS key to true inside the env object of your ~/.claude/settings.json file. This allows Claude Code to spawn agents into split terminal panes.

What is psmux used for in terminal multiplexing?

Psmux is a terminal multiplexer used to enable Claude Code Agent Teams split-pane sessions. It allows developers to manage multiple terminal panes within their local environment, enabling agents to run concurrently in split views.

How do I install psmux on Windows for Claude Code?

You can install psmux on Windows using the winget package manager. The psmux skill automatically detects if the tool is missing and runs the winget installation command, reporting the version information upon successful setup.

Can I toggle Agent Teams on and off without editing settings.json manually?

Yes, you can toggle Agent Teams on and off without manual JSON edits by using the psmux skill. It safely updates only the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS value inside the env object while preserving all other settings in your configuration file.

Does toggling psmux modify other fields in Claude Code settings?

No, toggling psmux does not modify other fields in Claude Code settings. The tool strictly reads and updates only the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS key inside the env object of ~/.claude/settings.json, leaving all other configuration entries untouched.

What are the limitations of using psmux for terminal multiplexing?

Psmux is limited to local developer environments and relies on winget for installation, meaning it primarily targets Windows systems. It exclusively manages the Agent Teams feature flag and does not handle broader terminal multiplexing configurations outside of Claude Code.