sessionview 0.0.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
sessionview/__init__.py
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: sessionview
|
|
3
|
+
Version: 0.0.1
|
|
4
|
+
Summary: sessionview - a sidebar for tmux: your projects (sessions) and your agents (seats), here and on remote hosts. Name reserved; the tool follows.
|
|
5
|
+
Project-URL: Homepage, https://github.com/mbailey/session
|
|
6
|
+
Author: Mike Bailey
|
|
7
|
+
License-Expression: GPL-3.0-or-later
|
|
8
|
+
Classifier: Development Status :: 1 - Planning
|
|
9
|
+
Requires-Python: >=3.11
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
|
|
12
|
+
# Herd
|
|
13
|
+
|
|
14
|
+
A sidebar for tmux, in the spirit of herdr: your projects (tmux sessions)
|
|
15
|
+
and your agents (seats), here and on remote hosts, one click away, with a
|
|
16
|
+
right-click menu built from what is installed. Session's TUI — a
|
|
17
|
+
controller and view for the `session` tools, drawn beside tmux.
|
|
18
|
+
|
|
19
|
+
`sessionview` 0.0.1 on PyPI reserves the name; the tool follows (Mike, approved by mail 00:25 Thu 2026-09-10).
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
herd [SESSION] # in this terminal: sidebar left, SESSION attached
|
|
23
|
+
# right (a private outer tmux holds the two panes)
|
|
24
|
+
prefix H # the same sidebar as a popup in any tmux client
|
|
25
|
+
|
|
26
|
+
Read [SPEC.md](SPEC.md) first: what Herd is, the rules of the view, the
|
|
27
|
+
contract with `session`, the plugin manifest, config, measured limits.
|
|
28
|
+
This repo is the **reference implementation** (Mike, 18:23 Sun
|
|
29
|
+
2026-09-06: "a working reference implementation ... it can be a life
|
|
30
|
+
raft") — session integrates from the spec; this stays comparable and
|
|
31
|
+
runnable.
|
|
32
|
+
|
|
33
|
+
## Layout
|
|
34
|
+
|
|
35
|
+
bin/tmux-sidebar the view, the clicks, the menus (Python 3.11+, stdlib)
|
|
36
|
+
bin/herd the front door (the frame) + the sidebar supervisor
|
|
37
|
+
bin/herd-frame the frame: outer tmux, sidebar pane + client pane
|
|
38
|
+
bin/herd-session a project session with code / git / project / tasks tabs
|
|
39
|
+
bin/herd-newtab the tab bar's "+"
|
|
40
|
+
tmux/herd.conf the herd look, session-scoped (sourced with S= and HERD_ROOT=)
|
|
41
|
+
tmux/tabs-top.conf the same look, global (source-file it from ~/.tmux.conf)
|
|
42
|
+
config/config.json every default, explicit; ~/.sessionview/config.json is made from it
|
|
43
|
+
plugins/*/ herd-plugin.toml (+ scripts): session, voicemode, taskmaster
|
|
44
|
+
|
|
45
|
+
Paths resolve from the checkout (`HERD_ROOT`); state lives in
|
|
46
|
+
`~/.local/state/herd` (`HERD_STATE`). Needs: tmux ≥ 3.7, Python ≥ 3.11,
|
|
47
|
+
`session` on PATH; `tm` and the voicemode plugin are optional (their menu
|
|
48
|
+
items appear only when they are installed).
|
|
49
|
+
|
|
50
|
+
## Install
|
|
51
|
+
|
|
52
|
+
git clone ms2:git/repos/sessionview.git ~/Code/failmode/mbailey/sessionview
|
|
53
|
+
ln -s ~/Code/failmode/mbailey/sessionview/bin/{herd,herd-frame,tmux-sidebar,herd-session} ~/.local/bin/
|
|
54
|
+
herd
|
|
55
|
+
|
|
56
|
+
## Keys and clicks
|
|
57
|
+
|
|
58
|
+
- sidebar: click a project or seat → go there; right-click → its menu;
|
|
59
|
+
`new` → a session picker (type to filter, ↑↓, enter); the store name →
|
|
60
|
+
pick a store; `all · grouped` on the agents heading are toggles; `q`
|
|
61
|
+
reloads, `Q` quits, esc backs out of any view
|
|
62
|
+
- tab bar: click selects, drag reorders, `+` new tab; a close `×` when
|
|
63
|
+
`@herd_tab_close` is set (`HERD_TAB_CLOSE=1 herd`)
|
|
64
|
+
- menu: ↑↓ / j k move, the letter or enter picks, esc closes
|
|
65
|
+
|
|
66
|
+
Built by Pip, Fri 2026-09-04 – Sun 2026-09-06, from Mike's asks by voice,
|
|
67
|
+
with Cora reading herdr's own window for the colours.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
sessionview/__init__.py,sha256=NliJNp4bZ0Y0G7ejDaLzzzkiWAGj5YNxWjK0y2xZmpU,91
|
|
2
|
+
sessionview-0.0.1.dist-info/METADATA,sha256=woEdnTNBxnDuBdpcK0t9sQjUll5vGVvCBTtbpo_Okvc,3257
|
|
3
|
+
sessionview-0.0.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
|
|
4
|
+
sessionview-0.0.1.dist-info/RECORD,,
|