agent-session-manager 0.6.0__py3-none-any.whl

agent_session_manager-0.6.0.dist-info/METADATA

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: agent-session-manager
+Version: 0.6.0
+Summary: Manage Claude Code & Codex sessions, cost, and data from your terminal
+Project-URL: Homepage, https://github.com/Bae-ChangHyun/agent-session-manager
+Project-URL: Repository, https://github.com/Bae-ChangHyun/agent-session-manager
+Project-URL: Issues, https://github.com/Bae-ChangHyun/agent-session-manager/issues
+Author-email: bch <bch@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,claude,claude-code,codex,openai,session-manager,terminal,textual
+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 :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: claude-agent-sdk>=0.1.40
+Requires-Dist: send2trash>=1.8.0
+Requires-Dist: textual>=1.0.0
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# agent-session-manager
+
+**One terminal dashboard for everything Claude Code and Codex leave behind.**
+See cost, browse sessions, and clean up `~/.claude` and `~/.codex` — side by side, with a Claude / Codex filter.
+
+[![Python](https://img.shields.io/badge/Python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org)
+[![Built with Textual](https://img.shields.io/badge/Built%20with-Textual-5A2CA0?style=flat-square)](https://github.com/Textualize/textual)
+[![License](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-orange?style=flat-square)](#)
+[![Status](https://img.shields.io/badge/Status-Personal--use-lightgrey?style=flat-square)](#)
+
+`asm` · **[한국어](README.ko.md)**
+
+</div>
+
+---
+
+> **⚠️ Heads up**
+> This is a personal tool that reads and edits the **internal data of Claude Code and OpenAI Codex** (`~/.claude`, `~/.codex`). Every delete goes to the OS trash and is logged, but you should still back up before bulk operations. Not affiliated with Anthropic or OpenAI.
+
+---
+
+## What it is
+
+If you live in **Claude Code** and **Codex**, the two of them quietly fill `~/.claude` and `~/.codex` with session transcripts, cost logs, debug files, task lists, and snapshots. After a few weeks it's impossible to tell which projects burned the most tokens, or which files are orphaned and safe to delete.
+
+**agent-session-manager** (`asm`) puts all of it in one terminal dashboard. Both agents show up together, and a single keystroke filters the view to **All / Claude / Codex** so you can compare spend or drill into one tool.
+
+### 💡 Why it exists
+
+- **Problem:** cost and session data for two different coding agents live in two opaque directories with no shared view.
+- **Solution:** one TUI that reads both, prices every model accurately, and lets you clean up safely — to the trash, with recovery snapshots.
+
+---
+
+## Demo
+
+The combined dashboard (cost across both agents, source-tagged rows), then the
+same view filtered to **Claude** and to **Codex**:
+
+<img src="docs/demo.gif" alt="asm demo" width="820"/>
+
+---
+
+## ✨ Features
+
+### Combined dashboard
+- **Cost across both agents** with an in-app source filter — press `s` for All / Claude / Codex
+- Per-model token & cost breakdown (Opus / Sonnet / Haiku / GPT-5.x), each row tagged by source
+- Daily / weekly / monthly usage tables and a Top-10 project cost chart
+- Accurate, current pricing from a LiteLLM-sourced rate table (new Opus/GPT models priced correctly, not at stale rates)
+
+### Claude management
+- **Projects:** tree from `.claude.json`, expand to preview session conversations, trash sessions, remove projects from config
+- **Orphan cleanup:** detect and bulk-clean sessions, file-history, debug, and task entries with no matching project
+- **Duplicate sessions:** find the same session copied across projects and delete individual copies
+- **Migration:** copy sessions between projects (originals preserved), with paths auto-rewritten
+
+### Codex sessions
+- Browse `~/.codex` rollout sessions grouped by working directory
+- Preview conversations and trash individual sessions
+
+### Safe by default
+- Every delete goes to the **OS trash** and is recorded in an audit log
+- **Recovery snapshots** are taken before trashing (Claude and Codex)
+- Backups for Claude (config / settings / plugins / sessions / full) and Codex (sessions, excluding huge caches), with auto safety-backup and rollback on restore
+
+---
+
+## How it works
+
+```
+   ~/.claude  ┐
+              ├──►  asm  ──►  one dashboard  ──►  filter: All / Claude / Codex
+   ~/.codex   ┘              (cost · sessions · cleanup · backup)
+```
+
+`asm` reads both data directories directly — no daemon, no config. Claude data is grouped by project; Codex sessions are grouped by working directory. Pricing is computed from each session's recorded token usage.
+
+| Path | What's there |
+|:---|:---|
+| `~/.claude.json` · `~/.claude/projects/` | Claude projects, costs, session JSONL |
+| `~/.claude/file-history/` · `debug/` · `tasks/` | Snapshots, debug logs, per-session task lists |
+| `~/.codex/sessions/` | Codex rollout session files |
+| `~/.asm/backups/` · `trash-log.jsonl` | Backups (auto-migrated from old `~/.cc-tui`) and the deletion audit log |
+
+---
+
+## 🛠️ Tech Stack
+
+- **TUI:** [Textual](https://github.com/Textualize/textual) + [Rich](https://github.com/Textualize/rich)
+- **Safety:** [send2trash](https://github.com/arsenetar/send2trash) (OS trash, not `rm`)
+- **Sessions:** [claude-agent-sdk](https://pypi.org/project/claude-agent-sdk/) with a JSONL fallback parser
+- **Python:** 3.11+
+
+---
+
+## 🚀 Getting started
+
+### Install (recommended)
+
+```bash
+# uv
+uv tool install agent-session-manager
+
+# pip
+pip install agent-session-manager
+```
+
+Both install a single `asm` command. On first run, data from the previous `~/.cc-tui` location is migrated to `~/.asm` automatically.
+
+<details>
+<summary><strong>Run from source</strong></summary>
+
+```bash
+git clone https://github.com/Bae-ChangHyun/agent-session-manager.git
+cd agent-session-manager
+uv sync && uv run asm
+```
+
+</details>
+
+### Usage
+
+```bash
+asm                       # Launch — shows Claude + Codex together
+asm --source codex        # Start with the dashboard filtered to Codex
+asm --path /your/project  # Limit to one Claude project
+asm --lang ko             # Korean UI  (or set ASM_LANG=ko)
+asm --no-update-check     # Skip the startup update check
+```
+
+Both sources are always available; `--source` only sets the dashboard's initial filter, which you change anytime with `s`.
+
+### Keyboard
+
+| Key | Action |
+|:---:|:---|
+| `F1`–`F6` | Switch tabs |
+| `s` | Dashboard source filter (All / Claude / Codex) |
+| `Tab` / `Shift+Tab` · `1` `2` `3` | Dashboard period (Daily / Weekly / Monthly) |
+| `d` / `D` | Trash selected / all orphaned |
+| `Space` · `Enter` | Toggle selection · Preview conversation |
+| `r` · `q` | Refresh all · Quit |
+
+### Staying up to date
+
+When a newer release is on PyPI, `asm` offers a `y/N` upgrade prompt on startup (via `uv tool` or `pip`). It's skipped in non-interactive shells and when offline.
+
+---
+
+## 🗺️ Roadmap
+
+- [ ] Codex session **restore** (backup / list / delete exist today; restore does not)
+- [ ] Per-source disk-usage and retention hints in the data overview
+- [ ] Publish to PyPI as `agent-session-manager`
+
+---
+
+## ⚠️ Status & scope
+
+- **Personal / pre-release**, under active development.
+- Operates directly on Claude Code and Codex internal data — **back up before bulk deletes**.
+- Deletes go to the OS trash with recovery snapshots; nothing is `rm`'d in place.
+- No warranty. Not affiliated with Anthropic or OpenAI.
+
+---
+
+## 📄 License
+
+[MIT](LICENSE)
+
+<div align="center">
+<br/>
+Made with <b>Claude Code</b> · and now <b>Codex</b> too
+</div>

agent_session_manager-0.6.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+asm/__init__.py,sha256=WyFNSRBKH4_6iRXbX936ujatR-T_FCKPTp25rai8Bhc,89
+asm/__main__.py,sha256=xKVLV0RY53oAXg8nqbTkL2HTrT-Y0KdxC3Y-VuxcsZ0,1417
+asm/app.py,sha256=ujwcASjLz3CJXYXm9PsdDXnJRvONLY_qvQsTAv-U7p0,6468
+asm/i18n.py,sha256=2JZ8uDZppxhqcWUMeG5DjkHM5XeJz05kaWtA1ZLGrFw,29155
+asm/models.py,sha256=sb9aV3Mjl9KyPDMDJXD9xa5vKcHnL5_lil6L16RvuKM,5406
+asm/utils.py,sha256=8eKIXa3ShgkHylbxkfa_j3PBqGNh2HEQ0JcTudNrDBw,327
+asm/screens/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+asm/screens/backups.py,sha256=OR9uXWXePMURKCR6BBdROa54l0vnbz5fjDIqfNlgCxs,27214
+asm/screens/codex_sessions.py,sha256=YMU-hKVnNQLfqZSctdoI9-HwWyz5BmUuOb9pRrzHbOg,8087
+asm/screens/confirm.py,sha256=33tt-INJOmsLhpnVam1RizKwiC_2kGNFdiRkdXmoKLQ,3265
+asm/screens/dashboard.py,sha256=oGowORORz8BTxGgggKx4aPES6AOlcwi8WtzFKeeV3bU,16791
+asm/screens/debug_todos.py,sha256=kxpbTwY8CyqUS1L9h9jAL9dzDv7YKC_y1fkESZATM9g,25094
+asm/screens/file_history.py,sha256=07EqI-aBTXebLg2RpEJ7TAYPx8dwfwQiwtX196LMI_M,13314
+asm/screens/input_dialog.py,sha256=9kW1wbUao9gPG5UQe6uAMnhEGsQghEKIsHlGU6qs8g8,1825
+asm/screens/migrate.py,sha256=_4mee3wrhagcm2k3IzZZCqurAT30gnCLwdACr6zJcO8,19444
+asm/screens/projects.py,sha256=zuA7wAaWSg5Sn7Uon9fy33U1Tedmh4cIJCrl534pisE,24834
+asm/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+asm/services/backup.py,sha256=QRKZTdU-aGC-4rBe0fvHRiZOXlxPlKYwXYPDLo5aRN4,20373
+asm/services/claude_data.py,sha256=VQr9hBI5Hgl3-uMDPqr7M16QN52o3VMjAPrwY0mladc,31275
+asm/services/cleaner.py,sha256=Z7vrn3ecbuSdfgt4PcV8xaVD5oUKI80ph9n4ivkGOoU,10891
+asm/services/codex_data.py,sha256=TsTeLjie5Zi0zTg94ez3YLFxhnk-queLMdYyRWjyes4,12731
+asm/services/migrate.py,sha256=Zj-KMyQ4f3WvlS9i7OSXsQrMDKx068EArEJe1eaU8Ug,7764
+asm/services/pricing.py,sha256=qCYSMsZoEmP9PDtdHeodwrYIyIeXqFpYysXsDM3C2rc,5377
+asm/services/recovery.py,sha256=gFk5Z9z9qmUtIVHygshLjVuRlr-C831q1HFnYBThY1w,5938
+asm/services/update.py,sha256=0u7DhBCTRjVQRnK2xdBJHVzcDiDBYXgVR6I33PlGpN8,3404
+asm/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+asm/widgets/action_bar.py,sha256=mALwZ1e_MS9LdAKs1A3XD4oCZMALF7mTEbRJSHBdL60,1370
+agent_session_manager-0.6.0.dist-info/METADATA,sha256=EU3Y35_Omwe26c2bggjqOFYNnBBHGo6SGjHFwZDN4IE,8312
+agent_session_manager-0.6.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+agent_session_manager-0.6.0.dist-info/entry_points.txt,sha256=Ch8AIzXYp9Jyp3R9ttm2mE1v1ipdDp0XEGOqA60UVl8,42
+agent_session_manager-0.6.0.dist-info/licenses/LICENSE,sha256=f2_s-scsQ4BeS_uuyLJZ6Aj5ah-pp1vox22S5whY95k,1076
+agent_session_manager-0.6.0.dist-info/RECORD,,

agent_session_manager-0.6.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

agent_session_manager-0.6.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+asm = asm.__main__:main

agent_session_manager-0.6.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 cc-tui 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.

asm/__init__.py

@@ -0,0 +1,3 @@
+"""asm: Terminal UI for managing Claude Code & Codex sessions."""
+
+__version__ = "0.5.0"

asm/__main__.py

@@ -0,0 +1,54 @@
+"""Entry point for asm."""
+
+import argparse
+
+from asm.app import CCTuiApp
+from asm.i18n import init_lang
+from asm.models import migrate_legacy_data_dir
+from asm.services.update import maybe_prompt_update
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="asm",
+        description="asm: manage Claude Code & Codex sessions, cost and data",
+    )
+    parser.add_argument(
+        "--path",
+        type=str,
+        default=None,
+        help="Specific project path to manage (default: global ~/.claude)",
+    )
+    parser.add_argument(
+        "--lang",
+        type=str,
+        default=None,
+        choices=["en", "ko"],
+        help="UI language (default: en, or set ASM_LANG env var)",
+    )
+    parser.add_argument(
+        "--source",
+        type=str,
+        default="all",
+        choices=["all", "claude", "codex"],
+        help="Initial dashboard source filter: all (default), claude, or codex. "
+             "Both sources are always shown; toggle in-app with 's'.",
+    )
+    parser.add_argument(
+        "--no-update-check",
+        action="store_true",
+        help="Skip the startup check for a newer release.",
+    )
+    args = parser.parse_args()
+
+    init_lang(args.lang)
+    migrate_legacy_data_dir()
+    if not args.no_update_check:
+        maybe_prompt_update()
+
+    app = CCTuiApp(target_path=args.path, source=args.source)
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

asm/app.py

@@ -0,0 +1,176 @@
+"""Main Textual application."""
+
+from pathlib import Path
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.widgets import Footer, Header, TabbedContent, TabPane
+
+from asm.i18n import t
+from asm.screens.backups import BackupsPane
+from asm.screens.codex_sessions import CodexSessionsPane
+from asm.screens.dashboard import DashboardPane
+from asm.screens.debug_todos import DebugTodosPane
+from asm.screens.file_history import FileHistoryPane
+from asm.screens.migrate import MigratePane
+from asm.screens.projects import ProjectsPane
+
+
+class CCTuiApp(App):
+    """asm — Claude Code & Codex session/data manager TUI."""
+
+    TITLE = "asm"
+    SUB_TITLE = "Claude Code & Codex session manager"
+
+    CSS = """
+    Screen {
+        background: $surface;
+    }
+    TabbedContent {
+        height: 1fr;
+    }
+    #main-tabs {
+        height: 1fr;
+    }
+    .pane-container {
+        height: 1fr;
+        padding: 1;
+    }
+    """
+
+    BINDINGS = [
+        Binding("tab", "tab_nav_next", "Next", show=False, priority=True),
+        Binding("shift+tab", "tab_nav_prev", "Previous", show=False, priority=True),
+        Binding("q", "quit", "Quit"),
+        Binding("r", "refresh", "Refresh"),
+        Binding("s", "dash_source", "Source", show=False),
+        Binding("1", "dash_daily", show=False),
+        Binding("2", "dash_weekly", show=False),
+        Binding("3", "dash_monthly", show=False),
+        Binding("f1", "tab('tab-dashboard')", "Dashboard"),
+        Binding("f2", "tab('tab-projects')", "Projects"),
+        Binding("f3", "tab('tab-file-history')", "File History"),
+        Binding("f4", "tab('tab-debug-todos')", "Debug/Todos"),
+        Binding("f5", "tab('tab-migrate')", "Migrate"),
+        Binding("f6", "tab('tab-backups')", "Backups"),
+    ]
+
+    def __init__(self, target_path: str | None = None, source: str = "all", **kwargs):
+        super().__init__(**kwargs)
+        if target_path:
+            self.target_path = str(Path(target_path).resolve())
+        else:
+            self.target_path = None
+        # Initial dashboard source filter (all | claude | codex). Both sources
+        # are always loaded; this only sets the dashboard's starting view.
+        self.source = source
+
+    @property
+    def target_encoded(self) -> str | None:
+        """Encoded project dir name for the target path."""
+        if self.target_path:
+            from asm.models import encode_path
+            return encode_path(self.target_path)
+        return None
+
+    def compose(self) -> ComposeResult:
+        if self.target_path:
+            self.sub_title = f"Project: {self.target_path}"
+        yield Header()
+        with TabbedContent(id="main-tabs"):
+            with TabPane(t("tab.dashboard"), id="tab-dashboard"):
+                yield DashboardPane()
+            # Claude-specific management tabs (operate on ~/.claude).
+            with TabPane(t("tab.projects"), id="tab-projects"):
+                yield ProjectsPane()
+            with TabPane(t("tab.file_history"), id="tab-file-history"):
+                yield FileHistoryPane()
+            with TabPane(t("tab.debug_todos"), id="tab-debug-todos"):
+                yield DebugTodosPane()
+            with TabPane(t("tab.migrate"), id="tab-migrate"):
+                yield MigratePane()
+            # Codex sessions (operate on ~/.codex); only shown when present.
+            if self._codex_available():
+                with TabPane(t("tab.codex_sessions"), id="tab-codex-sessions"):
+                    yield CodexSessionsPane()
+            with TabPane(t("tab.backups"), id="tab-backups"):
+                yield BackupsPane()
+        yield Footer()
+
+    @staticmethod
+    def _codex_available() -> bool:
+        from asm.services import codex_data
+        return codex_data.is_available()
+
+    def action_tab(self, tab_id: str) -> None:
+        """Switch to a specific tab by ID (ignored if the tab isn't present)."""
+        tabs = self.query_one("#main-tabs", TabbedContent)
+        try:
+            tabs.get_pane(tab_id)
+        except Exception:
+            return
+        tabs.active = tab_id
+
+    def on_tabbed_content_tab_activated(self, event: TabbedContent.TabActivated) -> None:
+        """Focus the dashboard pane when its tab opens so its shortcuts work."""
+        if event.tabbed_content.id != "main-tabs":
+            return
+        if event.tab.id == "tab-dashboard":
+            self.call_after_refresh(self._focus_dashboard)
+
+    def _focus_dashboard(self) -> None:
+        try:
+            self.query_one("DashboardPane").focus()
+        except Exception:
+            pass
+
+    def _dashboard_active(self) -> bool:
+        try:
+            return self.query_one("#main-tabs", TabbedContent).active == "tab-dashboard"
+        except Exception:
+            return False
+
+    def _dash(self, period: str | None) -> None:
+        if self._dashboard_active():
+            dash = self.query_one("DashboardPane")
+            dash.action_source_cycle() if period is None else dash.action_period(period)
+
+    def action_dash_source(self) -> None:
+        self._dash(None)
+
+    def action_dash_daily(self) -> None:
+        self._dash("daily")
+
+    def action_dash_weekly(self) -> None:
+        self._dash("weekly")
+
+    def action_dash_monthly(self) -> None:
+        self._dash("monthly")
+
+    def action_tab_nav_next(self) -> None:
+        """Handle Tab navigation, with dashboard period cycling override."""
+        tabs = self.query_one("#main-tabs", TabbedContent)
+        if tabs.active == "tab-dashboard":
+            self.query_one("DashboardPane").action_period_next()
+            return
+        self.screen.focus_next()
+
+    def action_tab_nav_prev(self) -> None:
+        """Handle reverse Tab navigation, with dashboard period cycling override."""
+        tabs = self.query_one("#main-tabs", TabbedContent)
+        if tabs.active == "tab-dashboard":
+            self.query_one("DashboardPane").action_period_prev()
+            return
+        self.screen.focus_previous()
+
+    def action_refresh(self) -> None:
+        """Refresh all panes that have refresh_data."""
+        from asm.services import codex_data
+        codex_data.refresh()
+        for pane in self.query(
+            "DashboardPane, ProjectsPane, CodexSessionsPane, FileHistoryPane, "
+            "DebugTodosPane, MigratePane, BackupsPane"
+        ):
+            if hasattr(pane, "refresh_data"):
+                pane.refresh_data()
+        self.notify(t("app.refreshed"))