Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

feat(os): Super+o Open dialog window; bold only the tab in front

bubu-dudue1f6970b554f
diff --git a/os/INSTALL.md b/os/INSTALL.md
index 1ce271a6d..baac0e9b9 100644
--- a/os/INSTALL.md
+++ b/os/INSTALL.md
@@ -145,6 +145,7 @@ the next key. A capital letter in a prefix binding means Shift + letter.
| Super+w | Connect to Wi-Fi |
| Super+b | Open/focus Chromium, or return to Harness |
| Super+e | Open/focus the file manager, or return to Harness |
+| Super+o | Open a folder (in the file manager) or a text file (in its editor) |
| Super+Enter | Focus Harness |
| Super+l | Lock; unlock with the account password |
| Print or Super+p | Screenshot the whole screen |
diff --git a/os/README.md b/os/README.md
index 6f379802c..434084ca6 100644
--- a/os/README.md
+++ b/os/README.md
@@ -190,6 +190,8 @@ Super+t opens a shell directly, Super+m connects a computer, Super+w opens Wi-Fi
and Super+l locks the session behind the same wordmark and "Enter your password"
as disk unlock. Super+e opens the file manager in its own window, a folder
tree on the left and the folder on the right; pressing it again returns to hn.
+Super+o asks for a folder, opened in that window, or a text file, opened in
+its editor.
Print or Super+p captures the screen, Shift+Print or Super+r a
dragged region; each picture is saved under `~/Pictures/Screenshots` and copied
to the clipboard. The Super keys require no Shift or prefix. The shared TUI
diff --git a/os/packaging/fedora/guide.md b/os/packaging/fedora/guide.md
index 45649a4fa..f14560480 100644
--- a/os/packaging/fedora/guide.md
+++ b/os/packaging/fedora/guide.md
@@ -22,7 +22,7 @@ Ctrl+b is a prefix: release it before the next key. Verify customized keys with
`hn list-keys`. Closing a pane and stopping an agent are different actions.
The OS keys are in `labwc/rc.xml`: Super+n opens New Harness, Super+t a terminal,
-Super+m the connection flow, Super+w Wi-Fi, Super+b the browser, Super+e the file manager, Super+Enter hn,
+Super+m the connection flow, Super+w Wi-Fi, Super+b the browser, Super+e the file manager, Super+o opens a folder or file, Super+Enter hn,
and Super+l the lock screen. Print or Super+p saves a screenshot, Shift+Print or
Super+r a region, to `~/Pictures/Screenshots` and the clipboard. Super is Command
on a Mac keyboard running Linux.
diff --git a/os/root/usr/lib/harness-os/files b/os/root/usr/lib/harness-os/files
index cc3cbfe4b..78a2711fe 100644
--- a/os/root/usr/lib/harness-os/files
+++ b/os/root/usr/lib/harness-os/files
@@ -1,9 +1,24 @@
#!/bin/sh
-# Super+e: the file manager in a window of its own, beside hn as the browser is (Super+b) — a folder
-# tree on the left, the folder's contents on the right. It is hn's own file view run standalone
-# (`hn files`), in the same foot look as the hn screen, so a file opens in the editor right there.
+# The file manager windows, all hn's own file view run standalone (`hn files`) in foot:
+# files [DIR] Super+e: the explorer, full screen beside hn as the browser is (Super+b).
+# files --open Super+o: a small Open dialog in the middle of the screen. It launches
+# one of the two below through this script and closes.
+# files --root DIR the explorer rooted at DIR, and kept inside it.
+# files --edit FILE a text file in the built-in editor.
. /usr/lib/harness-os/runtime-path
cd "$HOME" || exit 1
-export HARNESS_OS=1
-exec /usr/bin/foot --app-id=harness-files --title=Files \
- --config=/usr/share/harness-os/foot.ini "$HARNESS_TUI_BIN" files "${1:-$HOME}"
+export HARNESS_OS=1 HARNESS_FILES_LAUNCH=/usr/lib/harness-os/files
+config=/usr/share/harness-os/foot.ini
+case ${1:-} in
+ --open)
+ shift
+ exec /usr/bin/foot --app-id=harness-open --title=Open --config="$config" \
+ -o initial-window-mode=windowed --window-size-chars=130x34 \
+ "$HARNESS_TUI_BIN" files --open "${1:-$HOME}" ;;
+ --root|--edit)
+ exec /usr/bin/foot --app-id=harness-files --title=Files --config="$config" \
+ "$HARNESS_TUI_BIN" files "$1" "${2:?}" ;;
+ *)
+ exec /usr/bin/foot --app-id=harness-files --title=Files --config="$config" \
+ "$HARNESS_TUI_BIN" files "${1:-$HOME}" ;;
+esac
diff --git a/os/root/usr/share/harness-os/AGENTS.md b/os/root/usr/share/harness-os/AGENTS.md
index 310d67498..1d208f51c 100644
--- a/os/root/usr/share/harness-os/AGENTS.md
+++ b/os/root/usr/share/harness-os/AGENTS.md
@@ -105,7 +105,8 @@ is required.
install scripts for Claude Code, Codex and OpenCode. When another package needs
an install script, approve that package explicitly; keep npm's other defaults.
- `Super+b` opens/focuses Chromium or returns to hn; `Super+e` does the same for
- the file manager window (`hn files DIR`); `Super+Enter` focuses hn;
+ the file manager window (`hn files DIR`); `Super+o` asks for a folder or text
+ file to open there; `Super+Enter` focuses hn;
`Super+l` locks the screen. `sudo systemctl poweroff` shuts down cleanly.
- Print/`Super+p` saves a full screenshot and Shift+Print/`Super+r` a region to
`~/Pictures/Screenshots`, also copied to the clipboard. When the user mentions
diff --git a/os/root/usr/share/harness-os/labwc/rc.xml b/os/root/usr/share/harness-os/labwc/rc.xml
index 735ec5a20..72b444015 100644
--- a/os/root/usr/share/harness-os/labwc/rc.xml
+++ b/os/root/usr/share/harness-os/labwc/rc.xml
@@ -53,6 +53,8 @@
</else>
</action>
</keybind>
+ <!-- Super+o asks for a folder or a file in a new file manager window. -->
+ <keybind key="W-o"><action name="Execute" command="/usr/lib/harness-os/files --open" /></keybind>
<keybind key="W-m">
<action name="Execute" command="hn os-action connect" />
<action name="ForEach"><query identifier="hn" /><then><action name="Raise" /><action name="Focus" /></then></action>
@@ -75,6 +77,8 @@
<windowRules>
<windowRule identifier="hn" serverDecoration="no" />
<windowRule identifier="harness-files" serverDecoration="no" />
+ <!-- The Open dialog draws its own frame; labwc centres a new window by default. -->
+ <windowRule identifier="harness-open" serverDecoration="no" />
<windowRule identifier="chromium*" type="normal" serverDecoration="no"><action name="Maximize" /></windowRule>
</windowRules>
</labwc_config>
diff --git a/os/root/usr/share/harness-os/tmux.conf b/os/root/usr/share/harness-os/tmux.conf
index fb4cbd760..c497696dd 100644
--- a/os/root/usr/share/harness-os/tmux.conf
+++ b/os/root/usr/share/harness-os/tmux.conf
@@ -6,6 +6,12 @@ bind W os-action wifi
bind U new-window -n Updates '/usr/bin/harness updates'
# Keep hn's normal installed status bar. A new tab is immediately a terminal.
set -g @hn-new-window shell
+# Only the tab in front (*) is bold. Unread output (#) and a bell (!) keep their markers but
+# not the bold, which read as a second selected tab; `default` makes tmux's status-format skip
+# those styles altogether.
+set -g window-status-current-style bold
+set -g window-status-activity-style default
+set -g window-status-bell-style default
set -g @hn-animations off
set -g exit-empty off
set -g exit-unattached off
diff --git a/os/tests/test_lock_and_screenshot.py b/os/tests/test_lock_and_screenshot.py
index 97cab541a..993569bbf 100644
--- a/os/tests/test_lock_and_screenshot.py
+++ b/os/tests/test_lock_and_screenshot.py
@@ -60,6 +60,14 @@ class SessionLock(unittest.TestCase):
self.assertRegex(style, r'window \{\s*background-color: #000000;')
+class StatusBar(unittest.TestCase):
+ def test_only_the_tab_in_front_is_bold(self):
+ conf = (ROOT / 'usr/share/harness-os/tmux.conf').read_text().splitlines()
+ self.assertIn('set -g window-status-activity-style default', conf)
+ self.assertIn('set -g window-status-bell-style default', conf)
+ self.assertIn('set -g window-status-current-style bold', conf)
+
+
class FileManager(unittest.TestCase):
def test_super_e_runs_or_raises_its_own_window_like_the_browser(self):
keyboard = ET.parse(RC).getroot().find('keyboard')
@@ -74,10 +82,24 @@ class FileManager(unittest.TestCase):
rules = ET.parse(RC).getroot().find('windowRules')
self.assertTrue([r for r in rules if r.get('identifier') == 'harness-files' and r.get('serverDecoration') == 'no'])
+ def test_super_o_asks_for_a_folder_or_file_in_a_new_window(self):
+ self.assertEqual(bindings()['W-o'], ['/usr/lib/harness-os/files --open'])
+ script = (ROOT / 'usr/lib/harness-os/files').read_text()
+ # A small dialog of its own (centred, no server frame) that launches the explorer or editor
+ # windows back through this script.
+ self.assertIn('--app-id=harness-open', script)
+ self.assertIn('-o initial-window-mode=windowed --window-size-chars=130x34', script)
+ self.assertIn('HARNESS_FILES_LAUNCH=/usr/lib/harness-os/files', script)
+ self.assertIn('"$HARNESS_TUI_BIN" files "$1" "${2:?}"', script)
+ rules = ET.parse(RC).getroot().find('windowRules')
+ self.assertTrue([r for r in rules if r.get('identifier') == 'harness-open' and r.get('serverDecoration') == 'no'])
+
def test_window_runs_hn_files_in_the_screen_look(self):
script = (ROOT / 'usr/lib/harness-os/files').read_text()
self.assertIn('--app-id=harness-files', script)
- self.assertIn('--config=/usr/share/harness-os/foot.ini "$HARNESS_TUI_BIN" files', script)
+ self.assertIn('config=/usr/share/harness-os/foot.ini', script)
+ self.assertIn('--app-id=harness-files --title=Files --config="$config"', script)
+ self.assertIn('"$HARNESS_TUI_BIN" files "${1:-$HOME}"', script)
subprocess.run(['sh', '-n', ROOT / 'usr/lib/harness-os/files'], check=True)