Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ GridBash is a Windows-native Rust TUI multiplexer built for agent-heavy developm
- Pane-contained drag selection that copies selected terminal text without crossing into sibling panes.
- Sleeping panes stay visually hidden until hovered, then wake without crossing input into other panes.
- Normal terminal keys pass through to the focused pane, or to selected panes when multiple panes are selected.
- Modeless Alt shortcuts for pane focus, selection, rename, settings, and quit.
- Modeless Alt shortcuts for pane focus, selection, rename, settings, grouping, and quit.
- Hidden manager agent groups let a manager profile coordinate selected worker panes without taking a visible grid slot.
- Compact dark theme with focus, selection, sleep, exit, usage, and quiet-output cues.
- Claude, Codex, and other agent panes show a compact conversation summary in the footer line.
- Built-in launch profiles for common CLI coding agents.
Expand Down Expand Up @@ -196,6 +197,8 @@ GridBash captures drag selection so selected text stays inside the pane where th
| Alt+a | Select all panes, or clear selection when all panes are selected |
| Alt+r | Rename the focused pane |
| Alt+z | Put the focused pane to sleep; when multiple panes are selected, sleep the selected panes |
| Alt+g | Group selected panes under a hidden manager; with no selection, open the focused group's manager prompt |
| Alt+u | Dissolve the focused pane's manager group |
| Hover sleeping pane | Wake the pane and make its terminal contents visible again |
| Alt+o | Open settings |
| Alt+q | Quit |
Expand Down Expand Up @@ -229,6 +232,7 @@ Example:
```toml
[defaults]
profile = "powershell"
manager_profile = "claude-1"

[profiles.review]
command = "codex"
Expand All @@ -248,6 +252,14 @@ Default profile resolution order:
--profile > GRIDBASH_PROFILE > [defaults].profile > git-bash
```

Hidden manager groups use this manager profile resolution order:

```text
--manager-profile > GRIDBASH_MANAGER_PROFILE > [defaults].manager_profile
```

The manager profile can be a normal GridBash profile or a ready Vibe profile. To create a group, select one or more awake panes and press `Alt+g`. GridBash launches the manager as a hidden PTY, marks the grouped panes with a `G<letter>` badge, relays worker output snapshots to the manager, and forwards manager `gridbash send` blocks back to awake workers in that group.

## Design Goals

GridBash is inspired by agent-first multiplexers such as Mato and terminal workspaces such as Zellij, but V1 takes a different path: Windows-native, single binary, visual selection, scoped multi-pane input, and a hard bias toward fast multi-agent grids.
Expand Down
1 change: 1 addition & 0 deletions config.example.toml
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
[defaults]
profile = "git-bash"
manager_profile = "claude-1"

[profiles.codex-fast]
command = "codex"
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Integrate hidden manager agent groups

Date: 2026-07-07
Release target: unreleased

## Summary

- Integrated hidden manager agent groups from `origin/feat/hidden-agent-groups` onto current `main` without carrying over the old branch's unrelated deletes.
- Tracks issue #66.

## What Changed

- Added `--manager-profile`, `GRIDBASH_MANAGER_PROFILE`, and `[defaults].manager_profile` resolution for hidden group managers.
- Added hidden manager PTYs that coordinate selected awake worker panes, parse manager `gridbash send` blocks, and relay worker output snapshots back to managers.
- Added group badges and a manager prompt overlay while preserving visible pane arrays for resize, sleep, swap, worktree labels, usage labels, and pane-contained input selection.
- Added focused tests for manager config parsing, Vibe profile resolution, send-block parsing, and existing pane behavior.

## Why It Matters

- Manager agents can coordinate worker panes without consuming a visible grid slot.
- The integration avoids regressing current `main` behavior that landed after the source feature branch diverged.

## Validation

- `npm test`
- Result: 34 passed, 0 failed, 1 ignored Windows ConPTY smoke test.

## Release Notes

- Added hidden manager agent groups behind `Alt+g`/`Alt+u` and manager profile configuration.
Loading
Loading