asdu 0.4.2__tar.gz

asdu-0.4.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The asdu contributors
+
+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.

asdu-0.4.2/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include tests *.py *.jsonl

asdu-0.4.2/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: asdu
+Version: 0.4.2
+Summary: A terminal disk-usage browser for Codex, Claude, and OMP sessions
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tekkac/asdu
+Project-URL: Repository, https://github.com/tekkac/asdu
+Project-URL: Issues, https://github.com/tekkac/asdu/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: send2trash>=1.8.3
+Dynamic: license-file
+
+# asdu
+
+```text
+        █████╗ ███████╗██████╗ ██╗   ██╗
+       ██╔══██╗██╔════╝██╔══██╗██║   ██║
+       ███████║███████╗██║  ██║██║   ██║
+       ██╔══██║╚════██║██║  ██║██║   ██║
+       ██║  ██║███████║██████╔╝╚██████╔╝
+       ╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝
+
+            agent session disk usage
+```
+
+`asdu` shows where Codex, Claude, and OMP sessions use disk space.
+
+It works like a file browser. Start in a folder, inspect its sessions, and move
+up or down the directory tree. Everything stays local.
+
+## Install
+
+Install with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install asdu
+asdu
+```
+
+Update an existing installation:
+
+```sh
+uv tool upgrade asdu
+```
+
+## Use
+
+Run `asdu` inside any project:
+
+```sh
+asdu
+```
+
+Start somewhere else:
+
+```sh
+asdu --project ~/
+```
+
+The initial view shows folders. Press `g` for one flat list, then sources
+of sessions in the current folder. Press `t` to show session trees; they open
+folded.
+
+```text
+ asdu  ~/Code/demo                                                         143.9 MiB  12 sessions  size↓
+    74.2 MiB  ████████████      5  /api
+    38.1 MiB  ██████▏░░░░░      3  /docs
+
+›   23.5 MiB  ████████████  codex   main    now       ▸ Fix flaky tests (+2)
+     8.1 MiB  ████▏░░░░░░░  claude  main    12m ago   Review the release notes
+
+ codex 019bcb82-bef5-7503 | 2026-09-09 11:52 | ~/.codex/sessions/…jsonl
+ Enter open  Backspace back  a action  t tree  / find  g group  f source  F type  s sort   ? help  q quit
+```
+
+- Arrow keys select rows. In trees, `↑↓` select siblings and `←→` move between
+  parents and children.
+- `Enter` opens a folder or session brief.
+- `Backspace` goes back or moves to the parent folder.
+- `/` or `Ctrl-F` searches every scanned session by title, folder, or ID.
+- `g` switches between folder, source, and all-session views.
+- `f` filters by source.
+- `F` filters by session type: main, child, review, or `?` when unknown.
+- `s` changes the sort order.
+- `t` toggles trees. `Space` folds one branch and `z` folds or opens all.
+- `a` shows the actions supported by the selected source.
+- `r` rescans.
+- `q` quits.
+
+Press `?` for help. Run `asdu --help` for command-line options.
+
+## Session briefs
+
+Press `Enter` on a session to see its folder, size, ID, activity, recent request,
+last reply, and resume command.
+
+```text
+Center the login form
+
+18.2 MiB  claude main  2h ago
+Folder: /demo/web-app
+24 messages across 384 events; 0 compactions.
+
+╭ Latest request
+│ Why did the login page disappear?
+│
+├ Last reply
+│ The login page is back and the form is centered.
+│
+├ First request
+│ Move the form two pixels to the left.
+╰
+
+ID: demo-css-001
+Resume: claude --resume demo-css-001
+```
+
+## Session actions
+
+Browsing never changes a session. Press `a` to review an action before it runs.
+
+Codex archive and restore use Codex itself. Codex delete is permanent. Claude
+sessions can move to the system Trash. Tree actions include folded descendants.
+Active Claude sessions are refused.
+
+Successful actions append a content-free record to
+`$XDG_STATE_HOME/asdu/actions.jsonl`, normally
+`~/.local/state/asdu/actions.jsonl`.
+
+## Contributing
+
+Bug reports, UI improvements, and new session sources are welcome. Keep changes
+small and use fictional session data in tests.
+
+```sh
+uv run pytest
+uv run ruff check .
+```
+
+New sources start read-only. Add file-changing actions only when their lifecycle
+is understood and tested.
+
+## License
+
+[MIT](LICENSE)

asdu-0.4.2/README.md

@@ -0,0 +1,133 @@
+# asdu
+
+```text
+        █████╗ ███████╗██████╗ ██╗   ██╗
+       ██╔══██╗██╔════╝██╔══██╗██║   ██║
+       ███████║███████╗██║  ██║██║   ██║
+       ██╔══██║╚════██║██║  ██║██║   ██║
+       ██║  ██║███████║██████╔╝╚██████╔╝
+       ╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝
+
+            agent session disk usage
+```
+
+`asdu` shows where Codex, Claude, and OMP sessions use disk space.
+
+It works like a file browser. Start in a folder, inspect its sessions, and move
+up or down the directory tree. Everything stays local.
+
+## Install
+
+Install with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install asdu
+asdu
+```
+
+Update an existing installation:
+
+```sh
+uv tool upgrade asdu
+```
+
+## Use
+
+Run `asdu` inside any project:
+
+```sh
+asdu
+```
+
+Start somewhere else:
+
+```sh
+asdu --project ~/
+```
+
+The initial view shows folders. Press `g` for one flat list, then sources
+of sessions in the current folder. Press `t` to show session trees; they open
+folded.
+
+```text
+ asdu  ~/Code/demo                                                         143.9 MiB  12 sessions  size↓
+    74.2 MiB  ████████████      5  /api
+    38.1 MiB  ██████▏░░░░░      3  /docs
+
+›   23.5 MiB  ████████████  codex   main    now       ▸ Fix flaky tests (+2)
+     8.1 MiB  ████▏░░░░░░░  claude  main    12m ago   Review the release notes
+
+ codex 019bcb82-bef5-7503 | 2026-09-09 11:52 | ~/.codex/sessions/…jsonl
+ Enter open  Backspace back  a action  t tree  / find  g group  f source  F type  s sort   ? help  q quit
+```
+
+- Arrow keys select rows. In trees, `↑↓` select siblings and `←→` move between
+  parents and children.
+- `Enter` opens a folder or session brief.
+- `Backspace` goes back or moves to the parent folder.
+- `/` or `Ctrl-F` searches every scanned session by title, folder, or ID.
+- `g` switches between folder, source, and all-session views.
+- `f` filters by source.
+- `F` filters by session type: main, child, review, or `?` when unknown.
+- `s` changes the sort order.
+- `t` toggles trees. `Space` folds one branch and `z` folds or opens all.
+- `a` shows the actions supported by the selected source.
+- `r` rescans.
+- `q` quits.
+
+Press `?` for help. Run `asdu --help` for command-line options.
+
+## Session briefs
+
+Press `Enter` on a session to see its folder, size, ID, activity, recent request,
+last reply, and resume command.
+
+```text
+Center the login form
+
+18.2 MiB  claude main  2h ago
+Folder: /demo/web-app
+24 messages across 384 events; 0 compactions.
+
+╭ Latest request
+│ Why did the login page disappear?
+│
+├ Last reply
+│ The login page is back and the form is centered.
+│
+├ First request
+│ Move the form two pixels to the left.
+╰
+
+ID: demo-css-001
+Resume: claude --resume demo-css-001
+```
+
+## Session actions
+
+Browsing never changes a session. Press `a` to review an action before it runs.
+
+Codex archive and restore use Codex itself. Codex delete is permanent. Claude
+sessions can move to the system Trash. Tree actions include folded descendants.
+Active Claude sessions are refused.
+
+Successful actions append a content-free record to
+`$XDG_STATE_HOME/asdu/actions.jsonl`, normally
+`~/.local/state/asdu/actions.jsonl`.
+
+## Contributing
+
+Bug reports, UI improvements, and new session sources are welcome. Keep changes
+small and use fictional session data in tests.
+
+```sh
+uv run pytest
+uv run ruff check .
+```
+
+New sources start read-only. Add file-changing actions only when their lifecycle
+is understood and tested.
+
+## License
+
+[MIT](LICENSE)

asdu-0.4.2/asdu.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: asdu
+Version: 0.4.2
+Summary: A terminal disk-usage browser for Codex, Claude, and OMP sessions
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tekkac/asdu
+Project-URL: Repository, https://github.com/tekkac/asdu
+Project-URL: Issues, https://github.com/tekkac/asdu/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: send2trash>=1.8.3
+Dynamic: license-file
+
+# asdu
+
+```text
+        █████╗ ███████╗██████╗ ██╗   ██╗
+       ██╔══██╗██╔════╝██╔══██╗██║   ██║
+       ███████║███████╗██║  ██║██║   ██║
+       ██╔══██║╚════██║██║  ██║██║   ██║
+       ██║  ██║███████║██████╔╝╚██████╔╝
+       ╚═╝  ╚═╝╚══════╝╚═════╝  ╚═════╝
+
+            agent session disk usage
+```
+
+`asdu` shows where Codex, Claude, and OMP sessions use disk space.
+
+It works like a file browser. Start in a folder, inspect its sessions, and move
+up or down the directory tree. Everything stays local.
+
+## Install
+
+Install with [uv](https://docs.astral.sh/uv/):
+
+```sh
+uv tool install asdu
+asdu
+```
+
+Update an existing installation:
+
+```sh
+uv tool upgrade asdu
+```
+
+## Use
+
+Run `asdu` inside any project:
+
+```sh
+asdu
+```
+
+Start somewhere else:
+
+```sh
+asdu --project ~/
+```
+
+The initial view shows folders. Press `g` for one flat list, then sources
+of sessions in the current folder. Press `t` to show session trees; they open
+folded.
+
+```text
+ asdu  ~/Code/demo                                                         143.9 MiB  12 sessions  size↓
+    74.2 MiB  ████████████      5  /api
+    38.1 MiB  ██████▏░░░░░      3  /docs
+
+›   23.5 MiB  ████████████  codex   main    now       ▸ Fix flaky tests (+2)
+     8.1 MiB  ████▏░░░░░░░  claude  main    12m ago   Review the release notes
+
+ codex 019bcb82-bef5-7503 | 2026-09-09 11:52 | ~/.codex/sessions/…jsonl
+ Enter open  Backspace back  a action  t tree  / find  g group  f source  F type  s sort   ? help  q quit
+```
+
+- Arrow keys select rows. In trees, `↑↓` select siblings and `←→` move between
+  parents and children.
+- `Enter` opens a folder or session brief.
+- `Backspace` goes back or moves to the parent folder.
+- `/` or `Ctrl-F` searches every scanned session by title, folder, or ID.
+- `g` switches between folder, source, and all-session views.
+- `f` filters by source.
+- `F` filters by session type: main, child, review, or `?` when unknown.
+- `s` changes the sort order.
+- `t` toggles trees. `Space` folds one branch and `z` folds or opens all.
+- `a` shows the actions supported by the selected source.
+- `r` rescans.
+- `q` quits.
+
+Press `?` for help. Run `asdu --help` for command-line options.
+
+## Session briefs
+
+Press `Enter` on a session to see its folder, size, ID, activity, recent request,
+last reply, and resume command.
+
+```text
+Center the login form
+
+18.2 MiB  claude main  2h ago
+Folder: /demo/web-app
+24 messages across 384 events; 0 compactions.
+
+╭ Latest request
+│ Why did the login page disappear?
+│
+├ Last reply
+│ The login page is back and the form is centered.
+│
+├ First request
+│ Move the form two pixels to the left.
+╰
+
+ID: demo-css-001
+Resume: claude --resume demo-css-001
+```
+
+## Session actions
+
+Browsing never changes a session. Press `a` to review an action before it runs.
+
+Codex archive and restore use Codex itself. Codex delete is permanent. Claude
+sessions can move to the system Trash. Tree actions include folded descendants.
+Active Claude sessions are refused.
+
+Successful actions append a content-free record to
+`$XDG_STATE_HOME/asdu/actions.jsonl`, normally
+`~/.local/state/asdu/actions.jsonl`.
+
+## Contributing
+
+Bug reports, UI improvements, and new session sources are welcome. Keep changes
+small and use fictional session data in tests.
+
+```sh
+uv run pytest
+uv run ruff check .
+```
+
+New sources start read-only. Add file-changing actions only when their lifecycle
+is understood and tested.
+
+## License
+
+[MIT](LICENSE)

asdu-0.4.2/asdu.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+LICENSE
+MANIFEST.in
+README.md
+asdu.py
+asdu_browser.py
+asdu_sessions.py
+asdu_tui.py
+asdu_views.py
+pyproject.toml
+asdu.egg-info/PKG-INFO
+asdu.egg-info/SOURCES.txt
+asdu.egg-info/dependency_links.txt
+asdu.egg-info/entry_points.txt
+asdu.egg-info/requires.txt
+asdu.egg-info/top_level.txt
+asdu_sources/__init__.py
+asdu_sources/claude.py
+asdu_sources/codex.py
+asdu_sources/omp.py
+tests/smoke_install.py
+tests/test_asdu.py
+tests/test_pty.py
+tests/test_sources.py
+tests/fixtures/asdu/claude-test.jsonl
+tests/fixtures/asdu/omp-test.jsonl
+tests/fixtures/asdu/rollout-codex.jsonl

asdu-0.4.2/asdu.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

asdu-0.4.2/asdu.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+asdu = asdu:main

asdu-0.4.2/asdu.egg-info/requires.txt

@@ -0,0 +1 @@
+send2trash>=1.8.3

asdu-0.4.2/asdu.egg-info/top_level.txt

@@ -0,0 +1,6 @@
+asdu
+asdu_browser
+asdu_sessions
+asdu_sources
+asdu_tui
+asdu_views

asdu-0.4.2/asdu.py

@@ -0,0 +1,198 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["send2trash>=1.8.3"]
+# ///
+"""Command-line entry point for the local agent-session disk browser."""
+
+from __future__ import annotations
+
+import argparse
+import curses
+import os
+import sys
+from collections.abc import Callable
+from pathlib import Path
+
+import asdu_sessions as store
+import asdu_sources as sources_api
+import asdu_tui as ui
+import asdu_views as view
+
+__version__ = "0.4.2"
+
+
+def default_root(variable: str, directory: str, leaf: str) -> Path:
+    home = Path(os.environ.get(variable) or Path.home() / directory)
+    return home.expanduser() / leaf
+
+
+def main() -> int:
+    try:
+        return run_main()
+    except curses.error as error:
+        print(f"asdu: terminal error: {error}", file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        ui.clear_terminal()
+        return 130
+
+
+def parser() -> argparse.ArgumentParser:
+    result = argparse.ArgumentParser(
+        description="ncdu-style browser for local agent session storage."
+    )
+    result.add_argument("--version", action="version", version=f"asdu {__version__}")
+    result.add_argument(
+        "command",
+        nargs="?",
+        choices=("browse", "summary", "digest"),
+        default="browse",
+    )
+    result.add_argument(
+        "--codex-root",
+        type=Path,
+        default=default_root("CODEX_HOME", ".codex", "sessions"),
+        help="Codex session storage directory",
+    )
+    result.add_argument(
+        "--claude-root",
+        type=Path,
+        default=default_root("CLAUDE_CONFIG_DIR", ".claude", "projects"),
+        help="Claude session storage directory",
+    )
+    result.add_argument(
+        "--omp-root",
+        type=Path,
+        default=Path.home() / ".omp" / "agent" / "sessions",
+        help="OMP session storage directory (read-only)",
+    )
+    result.add_argument(
+        "--source",
+        choices=("codex", "claude", "omp"),
+        action="append",
+        help="Repeat to select sources; default is all available",
+    )
+    result.add_argument(
+        "--project",
+        type=Path,
+        help="Start in this directory instead of the current directory",
+    )
+    result.add_argument(
+        "--group",
+        choices=("folder", "source", "all"),
+        default="folder",
+        help="Browse by folder, source, or all sessions",
+    )
+    result.add_argument(
+        "--sort", choices=("size", "updated", "count", "name"), default="size"
+    )
+    result.add_argument(
+        "--session", help="With 'digest', an exact session ID or unique ID prefix"
+    )
+    result.add_argument(
+        "--no-progress", action="store_true", help="Suppress scan progress"
+    )
+    result.add_argument(
+        "--ascii",
+        action="store_true",
+        help="Use plain ASCII boxes, tree markers, and ncdu-style size bars",
+    )
+    result.add_argument(
+        "--no-color",
+        action="store_true",
+        help="Disable colors; retain bold, dim, and selection (also respects NO_COLOR)",
+    )
+    return result
+
+
+def run_main() -> int:
+    argument_parser = parser()
+    args = argument_parser.parse_args()
+    view.ASCII_UI = args.ascii
+    args.group = {"folder": "cwd"}.get(args.group, args.group)
+    args.sort = {"updated": "date"}.get(args.sort, args.sort)
+    if args.command == "summary" and args.group == "all":
+        argument_parser.error(
+            "summary cannot be grouped by all sessions; use folder or source"
+        )
+    if args.group == "all" and args.sort == "count":
+        argument_parser.error(
+            "--sort count applies to folder and source groups, not sessions"
+        )
+
+    adapters = sources_api.source_adapters(
+        args.codex_root, args.claude_root, args.omp_root
+    )
+    sources = tuple(dict.fromkeys(args.source or adapters))
+    source_roots = {
+        source: adapters[source].root
+        for source in sources
+        if adapters[source].root.exists()
+    }
+    if args.source:
+        for source in sources:
+            root = adapters[source].root
+            if not root.exists():
+                argument_parser.error(f"{source} session root does not exist: {root}")
+    elif not source_roots:
+        argument_parser.error(
+            "no supported session roots found; pass --codex-root, --claude-root, or --omp-root"
+        )
+    start = (args.project or Path.cwd()).resolve()
+
+    def scan_current(
+        render: Callable[[str, int, int, int, int], None] | None = None,
+    ) -> list[store.Session]:
+        progress = ui.ScanProgress(
+            render is not None
+            or (
+                not args.no_progress
+                and args.command == "browse"
+                and sys.stderr.isatty()
+            ),
+            render,
+        )
+        try:
+            return sources_api.scan(sources, adapters, progress)
+        finally:
+            progress.finish()
+
+    sessions = scan_current()
+    if args.command == "summary":
+        scoped = (
+            sessions
+            if start == Path("/")
+            else [session for session in sessions if store.in_scope(session, start)]
+        )
+        view.print_summary(scoped, args.group, args.sort)
+    elif args.command == "digest":
+        if not args.session:
+            argument_parser.error("digest requires --session SESSION_ID")
+        matches = [
+            session
+            for session in sessions
+            if session.session_id.startswith(args.session)
+        ]
+        if not matches:
+            argument_parser.error(f"no session begins with: {args.session}")
+        if len(matches) > 1:
+            argument_parser.error(
+                f"session prefix is ambiguous ({len(matches)} matches); provide more characters"
+            )
+        print(view.session_brief(matches[0], sessions))
+    else:
+        ui.tui(
+            sessions,
+            args.group,
+            args.sort,
+            start,
+            scan_current,
+            no_color=args.no_color,
+            source_roots=source_roots,
+        )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())