leghorn 0.1__tar.gz

leghorn-0.1/.gitignore

@@ -0,0 +1,4 @@
+dist/
+__pycache__/
+*.pyc
+node_modules/

leghorn-0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 George M. Howard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

leghorn-0.1/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: leghorn
+Version: 0.1
+Summary: Full-screen live view of every Claude Code session, its git state, and your GitHub CI
+Project-URL: Homepage, https://github.com/gmhoward9289-ops/leghorn
+Project-URL: Issues, https://github.com/gmhoward9289-ops/leghorn/issues
+Author-email: "George M. Howard" <dev@swamplink.com>
+License: MIT
+License-File: LICENSE
+Keywords: ci,claude,claude-code,dashboard,git,monitoring,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# leghorn
+
+[![ci](https://github.com/gmhoward9289-ops/leghorn/actions/workflows/ci.yml/badge.svg)](https://github.com/gmhoward9289-ops/leghorn/actions/workflows/ci.yml)
+
+A full-screen live dashboard you leave open on a second monitor while many
+Claude Code sessions work: every live session joined to its worktree and
+**real git state**, your **GitHub CI and open PRs** with failures pinned until
+they go green, and a commit feed across every repo, newest first.
+
+```
+ leghorn  20 sessions · 2 shared · 1 uncommitted · 3 ci red        sort:attention  filter:all  15:26:53
+╭─ SESSIONS ───────────────────────────────────────────────╮ ╭─ COMMITS ──────────────────────────╮
+│◉  leghorn-fea  my-mcp-server        Needs Input  72%     │ │   9m tools  fix/build-cwd          │
+│●  session-a3   api-refactor         Idle         58%     │ │       fix(api): resolve paths agai…│
+│●  session-d8   web-frontend  ~2 ↑1  Processing   50%     │ │  25m web-frontend  origin/ci/pub   │
+╰──────────────────────────────────────────────────────────╯ │       Automate publishing on relea…│
+╭─ GITHUB ─────────────────────────────────────────────────╮ │  29m api-refactor                  │
+│ 17h ✗ my-mcp-server  Required PR Sections (fix/fields)   │ │       Add an in-program help panel │
+│ 17h ✗ my-mcp-server  #593 Add field selection ← sections │ │  41m tools                         │
+│ 17h ◍ tools          Graph Update (queued 17h)           │ │       Add a LOCAL MODELS panel     │
+│ 23m ✓ web-frontend   ci (ci/npm-and-tap-publish)         │ │   1h api-refactor  origin/feat/rel │
+│ 24m ✓ web-frontend   #18 Automate publishing  APPROVED   │ │       teach release_check to diff  │
+╰──────────────────────────────────────────────────────────╯ ╰────────────────────────────────────╯
+ q quit  r refresh  s sort  f filter  g git  tab pane  enter detail  ? help
+```
+
+Sessions that share a working tree are marked contested (◉) — two sessions in
+one checkout silently destroy each other's uncommitted work, and seeing it
+happen is the first step to not doing it. The GitHub pane ranks by what it
+costs to ignore: running first, then red (a failure must not scroll away),
+then stuck-in-queue, then everything else by freshness.
+
+Two files, stdlib only, Python 3.9+. macOS and Linux (curses). Read-only by
+construction: it runs `gh`, read-only git plumbing, and (if present)
+`claudectl`, and never writes to a tree, a registry or a session. Every data
+source is optional — missing pieces degrade to a labelled gap, never an error.
+
+## Install
+
+Homebrew (macOS and Linux):
+
+```bash
+brew install gmhoward9289-ops/tap/leghorn
+```
+
+npm:
+
+```bash
+npm install -g leghorn
+```
+
+pipx / pip:
+
+```bash
+pipx install leghorn
+```
+
+Debian and Ubuntu, from the signed apt repo — this also gets you `apt upgrade`:
+
+```bash
+curl -fsSL https://gmhoward9289-ops.github.io/leghorn/leghorn-archive-keyring.asc | sudo gpg --dearmor -o /usr/share/keyrings/leghorn-archive-keyring.gpg
+echo "deb [signed-by=/usr/share/keyrings/leghorn-archive-keyring.gpg] https://gmhoward9289-ops.github.io/leghorn stable main" | sudo tee /etc/apt/sources.list.d/leghorn.list
+sudo apt update
+sudo apt install leghorn
+```
+
+Or grab `leghorn_<version>_all.deb` from the
+[latest release](https://github.com/gmhoward9289-ops/leghorn/releases/latest)
+and `sudo apt install ./leghorn_<version>_all.deb`.
+
+## What it needs
+
+- **git** — for the per-tree state and the commit feed.
+- **gh** (authenticated) — for the GITHUB pane. Unauthenticated, the pane says
+  "cannot see github" rather than pretending nothing is happening; an empty
+  feed and a feed that cannot see are different facts.
+- **claudectl** (optional) — session status and context columns. Without it
+  you still get names, trees, branches and git state.
+
+Clones are discovered under `~/GitHub` (override: `LEGHORN_ROOT`).
+
+## Usage
+
+```bash
+leghorn                  # three panes, refreshing every 5s
+leghorn -i 2             # ...every 2s
+leghorn --no-github      # hide the GitHub pane (no gh calls at all)
+leghorn --no-commits     # hide the commit feed
+leghorn --github-interval 120   # slower gh sweeps
+```
+
+Keys: `q` quit · `r` refresh (including a gh sweep) · `s`/`f` cycle
+sort/filter · `tab` cycle panes · `j`/`k` move · `enter` detail ·
+`?` help — which explains what each screen and symbol *means*, not just the
+keys.
+
+The data layer is also a command of its own:
+
+```bash
+python3 -m ccboard            # one table of sessions, for a hook or a pipe
+python3 -m ccboard --github   # the CI/PR feed as plain text
+python3 -m ccboard --json     # records, for piping somewhere else
+```
+
+## Name
+
+The Leghorn is the chicken breed that spots everything first and is never
+quiet about it.
+
+## License
+
+MIT

leghorn-0.1/README.md

@@ -0,0 +1,112 @@
+# leghorn
+
+[![ci](https://github.com/gmhoward9289-ops/leghorn/actions/workflows/ci.yml/badge.svg)](https://github.com/gmhoward9289-ops/leghorn/actions/workflows/ci.yml)
+
+A full-screen live dashboard you leave open on a second monitor while many
+Claude Code sessions work: every live session joined to its worktree and
+**real git state**, your **GitHub CI and open PRs** with failures pinned until
+they go green, and a commit feed across every repo, newest first.
+
+```
+ leghorn  20 sessions · 2 shared · 1 uncommitted · 3 ci red        sort:attention  filter:all  15:26:53
+╭─ SESSIONS ───────────────────────────────────────────────╮ ╭─ COMMITS ──────────────────────────╮
+│◉  leghorn-fea  my-mcp-server        Needs Input  72%     │ │   9m tools  fix/build-cwd          │
+│●  session-a3   api-refactor         Idle         58%     │ │       fix(api): resolve paths agai…│
+│●  session-d8   web-frontend  ~2 ↑1  Processing   50%     │ │  25m web-frontend  origin/ci/pub   │
+╰──────────────────────────────────────────────────────────╯ │       Automate publishing on relea…│
+╭─ GITHUB ─────────────────────────────────────────────────╮ │  29m api-refactor                  │
+│ 17h ✗ my-mcp-server  Required PR Sections (fix/fields)   │ │       Add an in-program help panel │
+│ 17h ✗ my-mcp-server  #593 Add field selection ← sections │ │  41m tools                         │
+│ 17h ◍ tools          Graph Update (queued 17h)           │ │       Add a LOCAL MODELS panel     │
+│ 23m ✓ web-frontend   ci (ci/npm-and-tap-publish)         │ │   1h api-refactor  origin/feat/rel │
+│ 24m ✓ web-frontend   #18 Automate publishing  APPROVED   │ │       teach release_check to diff  │
+╰──────────────────────────────────────────────────────────╯ ╰────────────────────────────────────╯
+ q quit  r refresh  s sort  f filter  g git  tab pane  enter detail  ? help
+```
+
+Sessions that share a working tree are marked contested (◉) — two sessions in
+one checkout silently destroy each other's uncommitted work, and seeing it
+happen is the first step to not doing it. The GitHub pane ranks by what it
+costs to ignore: running first, then red (a failure must not scroll away),
+then stuck-in-queue, then everything else by freshness.
+
+Two files, stdlib only, Python 3.9+. macOS and Linux (curses). Read-only by
+construction: it runs `gh`, read-only git plumbing, and (if present)
+`claudectl`, and never writes to a tree, a registry or a session. Every data
+source is optional — missing pieces degrade to a labelled gap, never an error.
+
+## Install
+
+Homebrew (macOS and Linux):
+
+```bash
+brew install gmhoward9289-ops/tap/leghorn
+```
+
+npm:
+
+```bash
+npm install -g leghorn
+```
+
+pipx / pip:
+
+```bash
+pipx install leghorn
+```
+
+Debian and Ubuntu, from the signed apt repo — this also gets you `apt upgrade`:
+
+```bash
+curl -fsSL https://gmhoward9289-ops.github.io/leghorn/leghorn-archive-keyring.asc | sudo gpg --dearmor -o /usr/share/keyrings/leghorn-archive-keyring.gpg
+echo "deb [signed-by=/usr/share/keyrings/leghorn-archive-keyring.gpg] https://gmhoward9289-ops.github.io/leghorn stable main" | sudo tee /etc/apt/sources.list.d/leghorn.list
+sudo apt update
+sudo apt install leghorn
+```
+
+Or grab `leghorn_<version>_all.deb` from the
+[latest release](https://github.com/gmhoward9289-ops/leghorn/releases/latest)
+and `sudo apt install ./leghorn_<version>_all.deb`.
+
+## What it needs
+
+- **git** — for the per-tree state and the commit feed.
+- **gh** (authenticated) — for the GITHUB pane. Unauthenticated, the pane says
+  "cannot see github" rather than pretending nothing is happening; an empty
+  feed and a feed that cannot see are different facts.
+- **claudectl** (optional) — session status and context columns. Without it
+  you still get names, trees, branches and git state.
+
+Clones are discovered under `~/GitHub` (override: `LEGHORN_ROOT`).
+
+## Usage
+
+```bash
+leghorn                  # three panes, refreshing every 5s
+leghorn -i 2             # ...every 2s
+leghorn --no-github      # hide the GitHub pane (no gh calls at all)
+leghorn --no-commits     # hide the commit feed
+leghorn --github-interval 120   # slower gh sweeps
+```
+
+Keys: `q` quit · `r` refresh (including a gh sweep) · `s`/`f` cycle
+sort/filter · `tab` cycle panes · `j`/`k` move · `enter` detail ·
+`?` help — which explains what each screen and symbol *means*, not just the
+keys.
+
+The data layer is also a command of its own:
+
+```bash
+python3 -m ccboard            # one table of sessions, for a hook or a pipe
+python3 -m ccboard --github   # the CI/PR feed as plain text
+python3 -m ccboard --json     # records, for piping somewhere else
+```
+
+## Name
+
+The Leghorn is the chicken breed that spots everything first and is never
+quiet about it.
+
+## License
+
+MIT