xed-tui 1.0.24__tar.gz

xed_tui-1.0.24/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+github: []
+# Weitere Funding-Optionen folgen
+# custom: ["https://collective-context.org/sponsor"]

xed_tui-1.0.24/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug Report
+about: "Report a bug — Fehler melden · All languages welcome / Alle Sprachen willkommen"
+title: "[BUG] "
+labels: bug
+assignees: ''
+---
+
+## Description / Beschreibung
+
+<!-- EN: What happened? / DE: Was ist passiert? -->
+
+## Steps to reproduce / Schritte zur Reproduktion
+
+1.
+2.
+3.
+
+## Expected behavior / Erwartetes Verhalten
+
+<!-- EN: What did you expect? / DE: Was hast du erwartet? -->
+
+## Environment / Umgebung
+
+- OS:
+- Python version / Python-Version:
+- XED /TUI version / Version:
+
+## Additional context / Weitere Infos
+
+<!-- Screenshots, logs, etc. -->

xed_tui-1.0.24/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature Request
+about: "Suggest a feature — Feature vorschlagen · All languages welcome / Alle Sprachen willkommen"
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+---
+
+## Summary / Zusammenfassung
+
+<!-- EN: What feature do you want? / DE: Welches Feature möchtest du? -->
+
+## Problem it solves / Problem das es löst
+
+<!-- EN: What problem does this solve? / DE: Welches Problem löst das? -->
+
+## Proposed solution / Vorgeschlagene Lösung
+
+<!-- EN: How should it work? / DE: Wie soll es funktionieren? -->
+
+## Alternatives considered / Alternativen
+
+<!-- EN: What else did you consider? / DE: Was hast du sonst überlegt? -->

xed_tui-1.0.24/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,13 @@
+---
+name: Question / Frage
+about: "Ask a question — Frage stellen · All languages welcome / Alle Sprachen willkommen"
+title: "[Q] "
+labels: question
+assignees: ''
+---
+
+## Question / Frage
+
+<!-- EN: Ask away! / DE: Stell deine Frage! -->
+
+<!-- Tip: For general discussions → https://github.com/XED-dev/TUI/discussions -->

xed_tui-1.0.24/.github/workflows/build-deb.yml

@@ -0,0 +1,52 @@
+name: Build .deb package
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build xed-tui_*.deb
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # required to attach .deb to GitHub Release
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set version from tag
+        run: echo "VERSION=${GITHUB_REF_NAME#v}" >> $GITHUB_ENV
+
+      - name: Assemble .deb tree
+        run: |
+          mkdir -p deb-build/DEBIAN
+          mkdir -p deb-build/usr/lib/xed-tui
+          mkdir -p deb-build/usr/bin
+
+          # Control file with version injected
+          sed "s/^Version:.*/Version: $VERSION/" \
+            packaging/deb/DEBIAN/control > deb-build/DEBIAN/control
+
+          # Python source
+          cp src/xed_tui/xed_tui_v1.py deb-build/usr/lib/xed-tui/
+          cp src/xed_tui/__init__.py    deb-build/usr/lib/xed-tui/
+          cp src/xed_tui/__main__.py    deb-build/usr/lib/xed-tui/
+
+          # Shell wrapper — printf avoids heredoc indentation (shebang must be column 0)
+          printf '#!/bin/sh\nexec python3 /usr/lib/xed-tui/__main__.py "$@"\n' \
+            > deb-build/usr/bin/xed-tui
+          chmod +x deb-build/usr/bin/xed-tui
+
+      - name: Build .deb
+        run: dpkg-deb --build deb-build "xed-tui_${VERSION}_all.deb"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: deb-package
+          path: "*.deb"
+
+      - name: Attach .deb to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: "*.deb"

xed_tui-1.0.24/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv tool install ruff
+      - run: ruff check src/
+
+  smoke:
+    name: Smoke test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.11", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install
+        run: pip install .
+
+      - name: --help exits cleanly
+        run: xed-tui --help
+
+      - name: Python module runs
+        run: python -m xed_tui --help

xed_tui-1.0.24/.github/workflows/publish-npm.yml

@@ -0,0 +1,42 @@
+name: Publish to npm
+
+on:
+  # Disabled: npm adds no value for a Python-only curses tool.
+  # Primary distribution: pip/uv (PyPI) + brew + .deb
+  # Re-enable if a JS ecosystem use case emerges.
+  workflow_dispatch:  # manual trigger only
+
+jobs:
+  publish:
+    name: Build & publish @xed-dev/tui to npm
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Sync version tag → package.json
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          # Convert v1.022 → 1.022.0 for npm (semver requires 3 parts)
+          NPM_VERSION="${VERSION}.0"
+          cd npm
+          node -e "
+            const fs = require('fs');
+            const p = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+            p.version = '${NPM_VERSION}';
+            fs.writeFileSync('package.json', JSON.stringify(p, null, 2) + '\n');
+          "
+
+      - name: Copy Python source into npm/lib/
+        run: cp src/xed_tui/xed_tui_v1.py npm/lib/xed_tui_v1.py
+
+      - name: Publish to npm
+        run: npm publish --access public
+        working-directory: npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

xed_tui-1.0.24/.github/workflows/publish-pypi.yml

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Build & publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # OIDC trusted publishing — no API token needed
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

xed_tui-1.0.24/.github/workflows/update-homebrew.yml

@@ -0,0 +1,53 @@
+name: Update Homebrew Tap
+
+on:
+  workflow_run:
+    workflows: ["Publish to PyPI"]
+    types: [completed]
+
+jobs:
+  update-tap:
+    name: Bump xed-tui formula in homebrew-xed tap
+    runs-on: ubuntu-latest
+    # Only run if PyPI publish succeeded
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Fetch URL + SHA256 from PyPI JSON API
+        run: |
+          TAG="${{ github.event.workflow_run.head_branch }}"
+          VERSION="${TAG#v}"
+          # Retry up to 5× — PyPI may need a moment after publish
+          for i in 1 2 3 4 5; do
+            PYPI=$(curl -fsSL "https://pypi.org/pypi/xed-tui/json") && break
+            echo "Attempt $i: waiting for PyPI..."
+            sleep 60
+          done
+          # PyPI normalises versions (1.022 → 1.22), so always read from API
+          URL=$(echo "$PYPI" | python3 -c "import sys,json; d=json.load(sys.stdin); print([u['url'] for u in d['urls'] if u['url'].endswith('.tar.gz')][0])")
+          SHA=$(echo "$PYPI" | python3 -c "import sys,json; d=json.load(sys.stdin); print([u['digests']['sha256'] for u in d['urls'] if u['url'].endswith('.tar.gz')][0])")
+          PYPI_VERSION=$(echo "$PYPI" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['info']['version'])")
+          echo "VERSION=$PYPI_VERSION" >> $GITHUB_ENV
+          echo "SHA256=$SHA"           >> $GITHUB_ENV
+          echo "URL=$URL"              >> $GITHUB_ENV
+
+      - name: Patch formula
+        run: |
+          sed -i \
+            -e "s|url \".*\"|url \"$URL\"|" \
+            -e "s|sha256 \".*\"|sha256 \"$SHA256\"|" \
+            packaging/homebrew/xed-tui.rb
+
+      - name: Push updated formula to homebrew-xed tap
+        uses: cpina/github-action-push-to-another-repository@main
+        env:
+          API_TOKEN_GITHUB: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        with:
+          source-directory: packaging/homebrew
+          destination-github-username: XED-dev
+          destination-repository-name: homebrew-xed
+          target-directory: Formula
+          target-branch: main
+          commit-message: "chore: bump xed-tui to ${{ env.VERSION }}"

xed_tui-1.0.24/.gitignore

@@ -0,0 +1,25 @@
+CLAUDE.md
+.claude/
+
+# Python
+*.pyc
+*.pyo
+__pycache__/
+.venv/
+.venv-*/
+*.egg-info/
+dist/
+build/
+
+# npm
+node_modules/
+npm/node_modules/
+npm/lib/xed_tui_v1.py
+
+# macOS
+.DS_Store
+
+# Build artifacts
+*.deb
+*.exe
+*.zip

xed_tui-1.0.24/AGENTS.md

@@ -0,0 +1,104 @@
+# AGENTS.md — XED /TUI
+> Required reading for all AI agents working in this repository.
+> German source: `de/AGENTS.md` — this file is an AI translation.
+> Last updated: March 2026
+
+---
+
+## PROJECT
+
+**XED /TUI** — a mutt-style session browser for Claude Code.
+Terminal-first. No cloud service. No proprietary lock-in.
+Built by [Collective Context (CC)](https://collective-context.org) · License: MIT
+
+**Primary audience:** Developers, web agencies and freelancers in the DACH region —
+and everyone using Claude Code in the terminal.
+
+---
+
+## RULES (non-negotiable)
+
+1. **JAIL:** Write only within this repository — no access to other paths.
+2. **NO SUDO.** Ever.
+3. **NO TERMINAL COMMANDS WITHOUT EXPLICIT APPROVAL.**
+   Allowed without approval: Read tool + Write tool. Nothing else.
+4. **NO CREDENTIALS IN CODE.** Use `os.environ[]` only.
+5. **WAIT:** After every question, wait for a response. Never work ahead.
+6. **When in doubt: STOP. Ask. Wait.**
+7. **Always reference issues:** Every fix commit must include an issue number.
+
+---
+
+## LANGUAGE POLICY
+
+**Source:** `de/` — always written first, in German.
+**Release:** Root directory — AI-translated to English.
+**Rule:** Never edit root-level docs directly.
+           Always update `de/` first, then translate.
+
+**Translation command:**
+```
+"Translate de/README.md to English → README.md. Keep code blocks unchanged."
+```
+
+**Future languages** (same pattern):
+- `fr/` — French (AI translation from EN or DE)
+- `ja/` — Japanese
+- `es/` — Spanish
+
+---
+
+## WORKFLOW: Lab → Release
+
+```
+fb-data (private lab)             XED-dev/TUI (public)
+──────────────────────────        ──────────────────────────
+Daily development            →    Milestone reached → code sync
+Write DE docs in de/         →    AI translates → root (EN)
+                                  Community feedback via Issues
+                                  Issues → postbox/todo.md
+                                  → flows back into the lab
+```
+
+**Code sync:** Only at milestones — no daily pushes.
+**Docs sync:** With every content update, translate DE → EN and commit both together.
+
+---
+
+## POSTBOX
+
+```
+postbox/todo.md       ← Community issues flowing into the lab
+postbox/done.md       ← Audit log: issue number → commit hash (required!)
+postbox/cron.md       ← Planned milestones + releases
+postbox/attachments/  ← Complex feature specs
+```
+
+**No commit hash in done.md = task is not considered done.**
+
+---
+
+## COMMIT FORMAT
+
+```
+feat:     New features
+fix:      Bug fixes (#issue-number)
+docs:     Documentation (DE + EN always committed together)
+release:  New release tag
+chore:    Maintenance
+```
+
+---
+
+## ROLES
+
+| Role | Who | Responsibility |
+|---|---|---|
+| **SysOps** | Maintainer | Approvals, prioritization, merge reviews |
+| **Lab Agent** | Claude Code (fb-data) | Development, fixes |
+| **Release Agent** | Claude Code (xed/) | Translation, docs, release commits |
+| **Scanner** | Gemini CLI | Scans issues → writes to postbox/todo.md — NEVER fixes |
+
+---
+
+*Standard: https://agents.md (Linux Foundation) · Project: https://collective-context.org*

xed_tui-1.0.24/CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+> German version: [de/CHANGELOG.md](de/CHANGELOG.md)
+
+All notable changes are documented here.
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning: `MAJOR.MINOR`
+
+---
+
+## [1.0.24] — unreleased
+
+### Added
+- `install.sh` — one-command installer: `curl -fsSL https://tui.xed.dev/install.sh | bash`
+- GitHub Pages at `https://tui.xed.dev` (CNAME + docs/)
+- CI workflow: ruff linting + smoke test on Ubuntu/macOS × Python 3.11/3.13
+
+### Changed
+- Versioning: 3-part semver (`MAJOR.MINOR.PATCH`) — `pyproject.toml` reads `VERSION` from script via hatchling regex (single source of truth)
+- Quickstart rewritten: 3-step flow mirroring Claude Code installation
+
+### Fixed
+- Renamed `xed-tui_v1.py` → `xed_tui_v1.py` (valid Python module name — removes `importlib.util` workaround)
+- `termios`/`tty` conditional import for Windows compatibility (`print_paged` falls back to plain print)
+- `.deb` shell wrapper shebang: replaced YAML heredoc with `printf` (leading whitespace bug)
+- Removed npm from user-facing docs (workflow disabled)
+
+## [1.0.23] — skipped
+*Internal semver migration. Not published.*
+
+## [1.22] — 2026-03-09
+*Previously tagged as `v1.022` — PyPI normalized the version.*
+
+### Added
+- `Ctrl+E` — Settings overlay: configure editor (`auto` / `msedit` / `nano` / custom) and default app (`auto` / `typora` / custom)
+- `[E]` respects `editor_pref` setting; `[O]` respects `open_pref` setting
+- Settings persisted in `continue.json` across sessions and hot-reloads
+- Help texts updated in all 5 languages (DE / EN / FR / JA / ES)
+- Status bar: `[^E]Set` shortcut hint
+
+## [1.021] — 2026-03-07
+
+### Added
+- Multi-language help overlay (DE / EN / FR / JA / ES), switchable with `←→` or number keys `1–5`
+- Language preference persisted in `continue.json`
+
+## [1.020] — 2026-03-06
+
+### Added
+- `[#]` Tags: per-session labels stored in `memory/tags.json`
+- Tag filter: `/#tag` in search mode filters sessions by tag
+- Token counter: `output_tokens` displayed as `42k` in sessions panel
+
+## [1.018] — 2026-03-05
+
+### Fixed
+- Empty reader panel on startup when saved `focus != "threads"` (explicit `preview_reader()` before event loop)
+
+## [1.017] — 2026-03-04
+
+### Fixed
+- `flush_table()`: column widths via visible length, ignoring Markdown markers
+
+## [1.016] — 2026-03-03
+
+### Added
+- Markdown table rendering with box-drawing: `┌─┬─┐` / `│ cell │` / `└─┴─┘`
+- `A_ITALIC` with ncurses 6.1+ fallback to underline
+
+## [1.010] — 2026-02-28
+
+### Added
+- `--continue` / `Ctrl+R`: full state persisted to `~/.local/share/xed-tui/continue.json`
+- Markdown rendering: h1/h2/h3, bold, inline code, italic, hrule, code blocks, tables, blockquotes
+- Token counter, full-text search `[/]`, Notes-Sync (`.sync` sidecar)
+- `[a]` Agent launch, `[r]` Resume-to-clipboard, Unicode input via `get_wch()`
+
+## [1.001] — 2026-02-20
+
+### Added
+- Initial release: 4-panel curses TUI for Claude Code sessions (`~/.claude/projects/`)
+- Projects, Sessions, Reader (JSONL → Markdown), Notes panels
+- vim-style navigation, `[t]` title, `[d]` delete, `[e]` editor, `[c]` clipboard
+- New note prefill with session transcript + `.sync` sidecar
+
+---
+
+*Development history: [fb-data](https://github.com/edikte/fb-data/commits/main/scripts/bin/XED-TUI/)*

xed_tui-1.0.24/CONTRIBUTING.md

@@ -0,0 +1,52 @@
+# Contributing to XED /TUI
+> German source: [de/CONTRIBUTING.md](de/CONTRIBUTING.md) — this file is an AI translation.
+
+All languages welcome — English is the release language of this file.
+
+---
+
+## How to contribute
+
+### Report a bug
+→ [Issues → Bug Report](https://github.com/XED-dev/TUI/issues/new?template=bug_report.md)
+
+Please include:
+- OS + Python version
+- What did you expect? What happened?
+- How to reproduce?
+
+### Suggest a feature
+→ [Issues → Feature Request](https://github.com/XED-dev/TUI/issues/new?template=feature_request.md)
+
+### Ask a question
+→ [Discussions → Q&A](https://github.com/XED-dev/TUI/discussions)
+
+### Contribute code
+
+1. Open an issue and describe your idea
+2. Wait for feedback from the maintainer
+3. Fork + create a branch: `feature/my-feature`
+4. Write code (comment in your native language — that's fine!)
+5. Open a pull request referencing the issue
+
+---
+
+## Language policy
+
+- **Code comments:** Any language — your native tongue is welcome
+- **Docs (`de/`):** German (source files)
+- **Docs (root):** English (AI translation)
+- **Issues + Discussions:** Any language — we respond in English or German
+
+---
+
+## Development workflow
+
+The daily lab is [fb-data (private)](https://github.com/edikte/fb-data).
+Code flows into this repo at milestones.
+
+Issues here → `postbox/todo.md` → lab → fix → release
+
+---
+
+*Collective Context (CC) · License: MIT*

xed_tui-1.0.24/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Collective Context (CC) — https://collective-context.org
+
+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.