pi-sessions-tui 0.1.0__tar.gz

pi_sessions_tui-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+# a newer push supersedes a pending run on the same branch
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install pytest
+      - name: Test
+        run: pytest -v

pi_sessions_tui-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

pi_sessions_tui-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Environments
+.venv/
+venv/
+
+# Tooling
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+
+# OS
+.DS_Store
+
+# Claude Code local settings
+.claude/
+
+# pi-sessions live documents
+_session_*.md
+_session_*.html
+_session_*_files/
+
+# generated by extras/make-nord-light-theme.py
+nord-light.theme

pi_sessions_tui-0.1.0/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+## [0.1.0] — 2026-11-04
+
+First release. pi-sessions is a fork of
+[ccsessions](https://github.com/miskiewiczm/ccsessions) 0.4.0 by Marek
+Miśkiewicz (MIT), adapted from Claude Code to the
+[pi](https://github.com/earendil-works/pi) coding agent. The history of
+ccsessions is kept in this repository.
+
+### Changed from ccsessions
+- Reads pi sessions (`~/.pi/agent/sessions/--<cwd>--/<timestamp>_<id>.jsonl`,
+  format v3) instead of `~/.claude/projects`. The sessions root follows pi's
+  own settings (`PI_CODING_AGENT_SESSION_DIR`, `PI_CODING_AGENT_DIR`), or
+  `PI_SESSIONS_ROOT`.
+- pi keeps no session index: titles (`/name`), first prompt, working directory,
+  token and cost totals are read from the session file and cached per file
+  (mtime + size).
+- pi keeps no record of running sessions: ● means modified in the last
+  `PI_SESSIONS_LIVE_SECONDS` (default 120).
+- Resume runs `pi --session <file>` (`PI_SESSIONS_PI_BIN` picks the command,
+  `PI_SESSIONS_RESUME_ROOT` rewrites the path for a pi running in a container).
+- Preview and export follow the active branch of pi's session tree, and show
+  `!` commands, compactions and displayed extension messages.
+- Project archive is `sessions-archive/` next to the sessions root; session
+  delete can go through `trash` (`PI_SESSIONS_TRASH=1`).
+- Command `pisessions`, package `pi-sessions-tui`, settings in
+  `~/.config/pi-sessions/`, cache in `~/.cache/pi-sessions/`, env vars
+  `PI_SESSIONS_*` instead of `CCSESSIONS_*`.
+
+### Added
+- Cost (USD, as recorded by pi) in the details pane and Markdown export.
+- Model, fork origin (⑂) and branch count for each session.
+- Resizable panes: drag the bars between panes; sizes are remembered per
+  layout (wide / narrow), double-click a bar to reset it, "Reset layout" in the
+  command palette.
+- The focused pane's border uses the accent colour.
+
+### Removed
+- Claude Code specifics: `sessions-index.json`, sessions whose file lives on
+  another machine (✕), sidechains, git branch, worktree labels, legacy alias
+  keys.
+
+### Fixed
+- The details pane advertised `w` for the live document; the key is `l`.
+- A session id read from a crafted session header can no longer steer where
+  the live document is written.

pi_sessions_tui-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Marek Miśkiewicz (ccsessions)
+Copyright (c) 2026 Psychobarge (pi-sessions)
+
+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.

pi_sessions_tui-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.5
+Name: pi-sessions-tui
+Version: 0.1.0
+Summary: Terminal UI for browsing, previewing, resuming and managing pi coding agent sessions
+Project-URL: Homepage, https://github.com/psychobarge/pi-sessions
+Project-URL: Issues, https://github.com/psychobarge/pi-sessions/issues
+Author: Psychobarge, Marek Miśkiewicz
+License: MIT
+License-File: LICENSE
+Keywords: pi,pi-coding-agent,sessions,terminal,textual,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: textual>=0.80
+Description-Content-Type: text/markdown
+
+# pi-sessions
+
+A fast terminal UI for browsing, previewing, resuming and managing
+[pi](https://github.com/earendil-works/pi) coding agent sessions.
+
+A fork of [ccsessions](https://github.com/miskiewiczm/ccsessions) by Marek
+Miśkiewicz, which does the same for Claude Code. The full behaviour is
+specified in [SPECS.md](SPECS.md); changes from ccsessions are listed in
+[CHANGELOG.md](CHANGELOG.md).
+
+## Features
+
+- **Project & session browser** — every pi project on your machine, newest
+  first, with recently-active indicators (●), fork markers (⑂), message
+  counts, token usage and cost
+- **Conversation preview** — the tail of the active branch, rendered with
+  roles, Markdown for pi's replies, tool calls (⚙), `!` commands (⌘) and
+  compaction markers, without opening pi
+- **One-key resume** — `r` replaces the TUI with `pi --session <file>` in the
+  session's working directory; `c` copies the command to the clipboard (OSC 52)
+- **Archive & delete** — move sessions out of `pi --resume` (reversibly) or
+  delete them for good, per session or per project, with confirmation dialogs
+- **Resizable panes** — drag the bars between panes with the mouse; sizes
+  are remembered per layout across runs (`~/.config/pi-sessions/settings.json`)
+- **Export** — Markdown with YAML front matter (ready for Quarto/Pandoc) or the
+  raw JSONL, never overwriting an existing file
+- **Live document** — `l` keeps `_session_<id>.md` in sync with a running
+  session, so a live-reloading renderer can show it with LaTeX rendered
+- **Fast** — session metadata is cached per file (mtime + size), scanning runs
+  off the UI thread, previews read only the tail of large files
+
+## Requirements
+
+- Python ≥ 3.10
+- pi installed (`pi` on PATH — needed only for resuming)
+- macOS or Linux
+
+## Installation
+
+```bash
+pipx install pi-sessions-tui        # or: uv tool install pi-sessions-tui
+```
+
+Both install the `pisessions` command.
+
+Or from a clone:
+
+```bash
+git clone https://github.com/psychobarge/pi-sessions
+pip install -e pi-sessions
+```
+
+## Usage
+
+```bash
+pisessions
+```
+
+| Key | Action |
+| --- | --- |
+| `j` / `k` / arrows | Move within the focused pane |
+| `Tab` / `Shift+Tab` | Switch panes |
+| `r` | Resume the selected session (in place) |
+| `c` | Copy the resume command to the clipboard |
+| `a` | Archive ↔ restore session · archive ↔ restore project |
+| `d` | Delete session / project (with confirmation) |
+| `n` | Rename project (set a display alias) |
+| `e` | Export the session (Markdown or raw JSONL) |
+| `l` | Follow the session in a live Markdown document |
+| `/` | Filter the focused list (projects or sessions) |
+| `p` | Command palette (change theme) |
+| `Ctrl+R` | Rescan now (a rescan also runs automatically) |
+| `q` | Quit |
+
+`a` and `d` act on the **session** when the Sessions pane is focused and on
+the whole **project** when the Projects pane is focused.
+
+pi keeps no record of running sessions, so ● means *modified in the last
+`PI_SESSIONS_LIVE_SECONDS` seconds* (default 120). Sessions marked this way
+cannot be archived or deleted.
+
+## Configuration
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `PI_SESSIONS_ROOT` | pi's own (`PI_CODING_AGENT_SESSION_DIR`, `$PI_CODING_AGENT_DIR/sessions`, `~/.pi/agent/sessions`) | Where to read sessions |
+| `PI_SESSIONS_PI_BIN` | `pi` | Command used to resume |
+| `PI_SESSIONS_RESUME_ROOT` | — | Rewrite the sessions root in resume commands, for a pi that sees it elsewhere (container) |
+| `PI_SESSIONS_LIVE_SECONDS` | `120` | Recently-active threshold |
+| `PI_SESSIONS_TRASH` | `0` | Delete through the `trash` command |
+| `PI_SESSIONS_LIVE_DIR` | session cwd | Where live documents go (use a plain directory for Quarto projects) |
+| `PI_SESSIONS_REFRESH_SECONDS` | `10` | Auto-refresh interval, `0` disables |
+| `PI_SESSIONS_THEME` | saved choice, else `ansi-dark` | Textual theme |
+| `PI_SESSIONS_CODE_THEME` | follows the theme | Pygments style for code blocks |
+| `PI_SESSIONS_NERD_FONT`, `PI_SESSIONS_EYE`, `PI_SESSIONS_EYE_OFF` | — | Live-document glyphs |
+
+Settings and project aliases live in `~/.config/pi-sessions/`, the cache in
+`~/.cache/pi-sessions/`.
+
+### pi in a container
+
+If pi runs in Docker with its agent directory in a named volume, the host
+cannot see the sessions. Bind-mount a host directory over the container's
+sessions directory (e.g. `-v ~/.pi/agent/sessions:/root/.pi/agent/sessions`),
+then set `PI_SESSIONS_RESUME_ROOT=/root/.pi/agent/sessions` so resume
+commands use the path pi sees.
+
+## How it works
+
+pi stores each session as `<sessions root>/--<encoded cwd>--/<timestamp>_<id>.jsonl`:
+a header line, then entries linked into a tree. pi-sessions reads those files
+and never modifies them. Archiving a session moves it into an `archived/`
+subdirectory, which pi does not list. Archiving a project moves its directory
+to `sessions-archive/` next to the sessions root. Everything happens locally;
+no network requests.
+
+## Development
+
+```bash
+pip install -e . --group dev
+pytest
+```
+
+## License
+
+[MIT](LICENSE)

pi_sessions_tui-0.1.0/README.md

@@ -0,0 +1,126 @@
+# pi-sessions
+
+A fast terminal UI for browsing, previewing, resuming and managing
+[pi](https://github.com/earendil-works/pi) coding agent sessions.
+
+A fork of [ccsessions](https://github.com/miskiewiczm/ccsessions) by Marek
+Miśkiewicz, which does the same for Claude Code. The full behaviour is
+specified in [SPECS.md](SPECS.md); changes from ccsessions are listed in
+[CHANGELOG.md](CHANGELOG.md).
+
+## Features
+
+- **Project & session browser** — every pi project on your machine, newest
+  first, with recently-active indicators (●), fork markers (⑂), message
+  counts, token usage and cost
+- **Conversation preview** — the tail of the active branch, rendered with
+  roles, Markdown for pi's replies, tool calls (⚙), `!` commands (⌘) and
+  compaction markers, without opening pi
+- **One-key resume** — `r` replaces the TUI with `pi --session <file>` in the
+  session's working directory; `c` copies the command to the clipboard (OSC 52)
+- **Archive & delete** — move sessions out of `pi --resume` (reversibly) or
+  delete them for good, per session or per project, with confirmation dialogs
+- **Resizable panes** — drag the bars between panes with the mouse; sizes
+  are remembered per layout across runs (`~/.config/pi-sessions/settings.json`)
+- **Export** — Markdown with YAML front matter (ready for Quarto/Pandoc) or the
+  raw JSONL, never overwriting an existing file
+- **Live document** — `l` keeps `_session_<id>.md` in sync with a running
+  session, so a live-reloading renderer can show it with LaTeX rendered
+- **Fast** — session metadata is cached per file (mtime + size), scanning runs
+  off the UI thread, previews read only the tail of large files
+
+## Requirements
+
+- Python ≥ 3.10
+- pi installed (`pi` on PATH — needed only for resuming)
+- macOS or Linux
+
+## Installation
+
+```bash
+pipx install pi-sessions-tui        # or: uv tool install pi-sessions-tui
+```
+
+Both install the `pisessions` command.
+
+Or from a clone:
+
+```bash
+git clone https://github.com/psychobarge/pi-sessions
+pip install -e pi-sessions
+```
+
+## Usage
+
+```bash
+pisessions
+```
+
+| Key | Action |
+| --- | --- |
+| `j` / `k` / arrows | Move within the focused pane |
+| `Tab` / `Shift+Tab` | Switch panes |
+| `r` | Resume the selected session (in place) |
+| `c` | Copy the resume command to the clipboard |
+| `a` | Archive ↔ restore session · archive ↔ restore project |
+| `d` | Delete session / project (with confirmation) |
+| `n` | Rename project (set a display alias) |
+| `e` | Export the session (Markdown or raw JSONL) |
+| `l` | Follow the session in a live Markdown document |
+| `/` | Filter the focused list (projects or sessions) |
+| `p` | Command palette (change theme) |
+| `Ctrl+R` | Rescan now (a rescan also runs automatically) |
+| `q` | Quit |
+
+`a` and `d` act on the **session** when the Sessions pane is focused and on
+the whole **project** when the Projects pane is focused.
+
+pi keeps no record of running sessions, so ● means *modified in the last
+`PI_SESSIONS_LIVE_SECONDS` seconds* (default 120). Sessions marked this way
+cannot be archived or deleted.
+
+## Configuration
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `PI_SESSIONS_ROOT` | pi's own (`PI_CODING_AGENT_SESSION_DIR`, `$PI_CODING_AGENT_DIR/sessions`, `~/.pi/agent/sessions`) | Where to read sessions |
+| `PI_SESSIONS_PI_BIN` | `pi` | Command used to resume |
+| `PI_SESSIONS_RESUME_ROOT` | — | Rewrite the sessions root in resume commands, for a pi that sees it elsewhere (container) |
+| `PI_SESSIONS_LIVE_SECONDS` | `120` | Recently-active threshold |
+| `PI_SESSIONS_TRASH` | `0` | Delete through the `trash` command |
+| `PI_SESSIONS_LIVE_DIR` | session cwd | Where live documents go (use a plain directory for Quarto projects) |
+| `PI_SESSIONS_REFRESH_SECONDS` | `10` | Auto-refresh interval, `0` disables |
+| `PI_SESSIONS_THEME` | saved choice, else `ansi-dark` | Textual theme |
+| `PI_SESSIONS_CODE_THEME` | follows the theme | Pygments style for code blocks |
+| `PI_SESSIONS_NERD_FONT`, `PI_SESSIONS_EYE`, `PI_SESSIONS_EYE_OFF` | — | Live-document glyphs |
+
+Settings and project aliases live in `~/.config/pi-sessions/`, the cache in
+`~/.cache/pi-sessions/`.
+
+### pi in a container
+
+If pi runs in Docker with its agent directory in a named volume, the host
+cannot see the sessions. Bind-mount a host directory over the container's
+sessions directory (e.g. `-v ~/.pi/agent/sessions:/root/.pi/agent/sessions`),
+then set `PI_SESSIONS_RESUME_ROOT=/root/.pi/agent/sessions` so resume
+commands use the path pi sees.
+
+## How it works
+
+pi stores each session as `<sessions root>/--<encoded cwd>--/<timestamp>_<id>.jsonl`:
+a header line, then entries linked into a tree. pi-sessions reads those files
+and never modifies them. Archiving a session moves it into an `archived/`
+subdirectory, which pi does not list. Archiving a project moves its directory
+to `sessions-archive/` next to the sessions root. Everything happens locally;
+no network requests.
+
+## Development
+
+```bash
+pip install -e . --group dev
+pytest
+```
+
+## License
+
+[MIT](LICENSE)