claudecm 0.1.0__tar.gz

claudecm-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+.venv/
+build/
+dist/
+*.egg-info/
+.uv-cache/
+uv.lock

claudecm-0.1.0/CLAUDE.md

@@ -0,0 +1,98 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+`ccm` is a CLI + Textual TUI for managing Claude Code's on-disk data under
+`~/.claude/projects/` (projects, session JSONL files, memory). End-user docs
+live in `README.md`.
+
+## Common commands
+
+This repo uses **uv** for everything. Python 3.10+.
+
+```bash
+uv sync --extra dev                          # install + dev deps (pytest)
+uv run ccm <subcommand>                      # run inside project venv
+uv run pytest -q                             # run the test suite
+uv run pytest tests/core/test_paths.py::test_naive_decode_strips_leading_dash  # single test
+uv tool install . --force --reinstall        # (re)install the `ccm` global tool
+```
+
+When testing TUI behavior, prefer the headless `App.run_test()` pattern:
+
+```python
+async with app.run_test(size=(188, 49)) as pilot:
+    await pilot.pause(0.4)
+    await pilot.press("m")
+```
+
+The interactive TUI needs a real TTY, so a sandboxed `ccm` will hang/crash —
+always exercise it through `run_test()` or ask the user to test live.
+
+## Architecture
+
+Three layers, deliberately separated so the domain code stays UI-agnostic:
+
+- **`src/ccm/core/`** — pure domain. `projects`, `sessions`, `memory`,
+  `stats`, `export`. No `typer`, no `textual` imports here.
+- **`src/ccm/cli/`** — Typer commands, one module per topic
+  (`projects.py` = ls/show/rm, `sessions.py` = sessions/view/rm-session/export,
+  `memory.py`, `stats.py`). `_app.py` holds the single `app = typer.Typer()`
+  instance; `cli/__init__.py` imports every command module purely for the
+  decorator side-effects so `ccm = "ccm.cli:app"` works.
+- **`src/ccm/tui/`** — Textual app. `screens.py` (MainScreen, SessionView,
+  MemoryView, ConfirmScreen), `widgets.py` (HeaderBar + option factories),
+  `_markup.py` (`safe()`/`styled()` helpers), `__init__.py` (`CCMApp`).
+
+`palette.py` and `paths.py` sit at the top of `src/ccm/` because both `cli/`
+and `tui/` depend on them.
+
+## Non-obvious gotchas
+
+These bit us during development — don't relearn them:
+
+- **Project dir names are lossy.** `~/.claude/projects/-home-quoctang-my-projects-ccm`
+  could decode to `/home/quoctang/my/projects/ccm` or `/home/quoctang/my_projects/ccm`
+  — Claude Code replaces both `/` and `_` with `-`. `paths.real_cwd_from_sessions()`
+  reads the actual `cwd` field from the first session JSONL; the naive `-` → `/`
+  fallback in `paths.naive_decode()` is only used when no session exists.
+
+- **JSONL `message` field is Python `repr`, not JSON.** It's a single-quoted
+  dict literal. `core.sessions._parse_message_field` uses `ast.literal_eval`.
+  Don't try `json.loads` on it.
+
+- **Don't define `_render` on a Textual screen/widget you write.** `Widget._render`
+  is internal and Textual calls it to get the `Visual` for the screen. Naming a
+  helper `_render` shadows it and Textual gets a `rich.text.Text` instead of a
+  `Visual`, crashing rendering. Helpers in `screens.py` are named `_build_body`.
+
+- **Don't shadow `Widget._size`.** Textual's `widget.outer_size` reads from
+  `_size`. `HeaderBar` prefixes its instance attrs with `_hb_` (`_hb_idx`,
+  `_hb_projects`, ...) for this reason. Any new widget should follow suit.
+
+- **Don't call `self.update(...)` from `on_mount` with a freshly-built renderable
+  if you also set up an interval.** It races with `Static`'s visual init and
+  leaves `_visual=None`. Pattern in `HeaderBar`: seed initial content via
+  `super().__init__(self._build())`, then `set_interval` from `on_mount` — never
+  call `update()` synchronously from `on_mount`.
+
+- **Markup escaping needs `tui._markup.safe()`, not `rich.markup.escape`.**
+  The stock escape only escapes `[tag]`-shaped runs; real session content has
+  bare `[` (e.g. next to box-drawing) that still trips the parser. `safe()`
+  escapes every `[` and `\`. Use `styled(text, style)` for the standard
+  `[<style>]<safe text>[/]` pattern — it centralizes the escape contract.
+
+- **Don't filter Textual system commands by callback.** The Screenshot system
+  command's callback is an anonymous lambda — title (`cmd.title == "Screenshot"`)
+  is the only stable handle. `CCMApp.get_system_commands` does this filter.
+
+## Testing
+
+- `tests/conftest.py` exposes a `tmp_claude_home` fixture that swaps `Path.home()`
+  to a tmp dir with `.claude/projects/` pre-created — use it for tests that
+  touch project enumeration.
+- `pyproject.toml` sets `pythonpath = ["src"]` so test files can `from ccm...`
+  directly without installing.
+

claudecm-0.1.0/LICENSE

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

claudecm-0.1.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: claudecm
+Version: 0.1.0
+Summary: Claude Code Manager — manage Claude Code projects, sessions, and memory
+Project-URL: Homepage, https://github.com/QuocTang/ccm
+Project-URL: Repository, https://github.com/QuocTang/ccm
+Project-URL: Issues, https://github.com/QuocTang/ccm/issues
+Project-URL: Changelog, https://github.com/QuocTang/ccm/releases
+Author: QuocTang
+License: MIT
+License-File: LICENSE
+Keywords: anthropic,claude,claude-code,cli,manager,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Software Development
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: rich>=13.7
+Requires-Dist: textual>=0.79
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="assets/logo.png" alt="ccm" height="160" />
+
+**Claude Code Manager** — a CLI + TUI for everything Claude Code stores under `~/.claude/projects/`.
+
+[![License: MIT](https://img.shields.io/github/license/QuocTang/ccm.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![uv](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fastral-sh%2Fuv%2Fmain%2Fassets%2Fbadge%2Fv0.json)](https://docs.astral.sh/uv/)
+[![Stars](https://img.shields.io/github/stars/QuocTang/ccm.svg?style=social)](https://github.com/QuocTang/ccm/stargazers)
+
+List projects, browse sessions, view / delete / export them, inspect memory
+files, see disk-usage stats — without `cd`-ing into a directory full of
+URL-encoded path names.
+
+</div>
+
+---
+
+## Quick start
+
+```bash
+uv tool install git+https://github.com/QuocTang/ccm
+ccm                  # launches the TUI
+ccm ls               # subcommand mode
+ccm stats            # disk-usage dashboard
+```
+
+> Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).
+
+## Why ccm
+
+`~/.claude/projects/` accumulates fast: every Claude Code session writes a
+JSONL file, every project keeps its own memory directory, and the folder names
+are a one-way path encoding (`/home/q/my_projects/foo` →
+`-home-q-my-projects-foo`). Going in with `ls` and `rm` is painful.
+
+- **One pane to navigate them all** — projects on the left, sessions on the right, Claude-style spinner up top.
+- **Subcommands for scripting** — `ccm ls --sort size -n 10`, `ccm export <project> -f md`, `ccm stats`.
+- **Decodes folder names correctly** — by reading the real `cwd` from inside each session's JSONL, not by replacing `-` with `/` and hoping.
+- **Knows about memory and PRs** — surfaces `memory/*.md`, counts messages by type, picks up custom session titles.
+- **No daemon, no config** — operates directly on the on-disk layout Claude Code already uses.
+
+## Installation
+
+<details>
+<summary><b>From source (latest)</b></summary>
+
+```bash
+git clone https://github.com/QuocTang/ccm
+cd ccm
+uv tool install .            # global, available as `ccm`
+# or for dev work:
+uv sync --extra dev
+uv run ccm --help
+```
+
+</details>
+
+<details>
+<summary><b>Without cloning</b></summary>
+
+```bash
+uv tool install git+https://github.com/QuocTang/ccm
+```
+
+</details>
+
+<details>
+<summary><b>Run without installing (one-off)</b></summary>
+
+```bash
+uvx --from git+https://github.com/QuocTang/ccm ccm ls
+```
+
+</details>
+
+## Usage
+
+```bash
+ccm                         # launch TUI (default when no args)
+ccm ls                      # list projects (sorted by recent activity)
+ccm ls -s size -n 10        # sort by size, top 10
+ccm show <project>          # detail for one project
+ccm sessions <project>      # list sessions of a project
+ccm view <project> <sess>   # render messages of a session
+ccm rm <project>            # delete a project directory (with confirm)
+ccm rm-session <p> <s>      # delete one session
+ccm export <p> [<s>] -f md  # export to markdown (or -f json | raw)
+ccm memory <project>        # view memory files
+ccm memory <p> --show NAME  # print one memory file
+ccm memory <p> --rm NAME    # delete one memory file
+ccm stats                   # disk usage dashboard
+ccm tui                     # launch TUI explicitly
+```
+
+`<project>` accepts an encoded dir name, the real `cwd` path, the basename
+(e.g. `my-project`), or any unique substring of either.
+
+`<session>` accepts the full UUID or a unique prefix (the 8-char head shown
+by `ccm sessions` is usually enough).
+
+### TUI keys
+
+| Key          | Action                               |
+| ------------ | ------------------------------------ |
+| `↑/↓` `j/k`  | Move cursor                          |
+| `h/l` `←/→`  | Focus projects / sessions pane       |
+| `Tab`        | Switch panes                         |
+| `Enter`      | Drill in (project → sessions → view) |
+| `m`          | Show memory for highlighted project  |
+| `d`          | Delete focused project / session     |
+| `r`          | Refresh                              |
+| `q` `Ctrl+C` | Quit (or back inside a sub-screen)   |
+
+Inside a delete-confirm modal: `y` / `Enter` to confirm, `n` / `Esc` to cancel.
+
+## Architecture
+
+Three layers, deliberately separated so domain code stays UI-agnostic.
+
+```mermaid
+flowchart LR
+    User([Terminal user])
+    subgraph ccm
+        direction TB
+        CLI["cli/<br/><sub>typer subcommands</sub>"]
+        TUI["tui/<br/><sub>textual app</sub>"]
+        CORE["core/<br/><sub>projects · sessions · memory · stats · export</sub>"]
+        SHARED["palette.py · paths.py<br/><sub>shared theme & path helpers</sub>"]
+    end
+    Disk[("~/.claude/projects/<br/>JSONL sessions + memory/")]
+
+    User -- "ccm <subcommand>" --> CLI
+    User -- "ccm (no args)" --> TUI
+    CLI --> CORE
+    TUI --> CORE
+    CLI -.-> SHARED
+    TUI -.-> SHARED
+    CORE --> Disk
+```
+
+The lossy folder-name encoding is the one bit that requires care: Claude Code
+replaces both `/` and `_` with `-`, so `paths.real_cwd_from_sessions()` reads
+the actual `cwd` field from the first session JSONL inside each directory.
+The naive `-` → `/` replacement is only a fallback for empty projects.
+
+## Development
+
+```bash
+uv sync --extra dev                                           # install + pytest
+uv run pytest -q                                              # run all tests
+uv run pytest tests/core/test_paths.py -k naive_decode        # one test
+uv tool install . --force --reinstall                         # rebuild global `ccm`
+```
+
+See [`CLAUDE.md`](CLAUDE.md) for architecture notes and the textual / typer
+gotchas we hit (lossy path encoding, `Widget._size` shadowing, markup escaping,
+etc).
+
+## Contributing
+
+PRs welcome. Keep the three-layer split (`core` stays UI-agnostic), run
+`uv run pytest -q` before pushing, and follow the gotchas in `CLAUDE.md` if you
+touch `tui/`.
+
+## Contributors
+
+<a href="https://github.com/QuocTang/ccm/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=QuocTang/ccm" alt="Contributors" />
+</a>
+
+## License
+
+[MIT](LICENSE) © QuocTang
+
+## Star history
+
+[![Star History Chart](https://api.star-history.com/svg?repos=QuocTang/ccm&type=Date)](https://star-history.com/#QuocTang/ccm&Date)

claudecm-0.1.0/README.md

@@ -0,0 +1,179 @@
+<div align="center">
+
+<img src="assets/logo.png" alt="ccm" height="160" />
+
+**Claude Code Manager** — a CLI + TUI for everything Claude Code stores under `~/.claude/projects/`.
+
+[![License: MIT](https://img.shields.io/github/license/QuocTang/ccm.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![uv](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fastral-sh%2Fuv%2Fmain%2Fassets%2Fbadge%2Fv0.json)](https://docs.astral.sh/uv/)
+[![Stars](https://img.shields.io/github/stars/QuocTang/ccm.svg?style=social)](https://github.com/QuocTang/ccm/stargazers)
+
+List projects, browse sessions, view / delete / export them, inspect memory
+files, see disk-usage stats — without `cd`-ing into a directory full of
+URL-encoded path names.
+
+</div>
+
+---
+
+## Quick start
+
+```bash
+uv tool install git+https://github.com/QuocTang/ccm
+ccm                  # launches the TUI
+ccm ls               # subcommand mode
+ccm stats            # disk-usage dashboard
+```
+
+> Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).
+
+## Why ccm
+
+`~/.claude/projects/` accumulates fast: every Claude Code session writes a
+JSONL file, every project keeps its own memory directory, and the folder names
+are a one-way path encoding (`/home/q/my_projects/foo` →
+`-home-q-my-projects-foo`). Going in with `ls` and `rm` is painful.
+
+- **One pane to navigate them all** — projects on the left, sessions on the right, Claude-style spinner up top.
+- **Subcommands for scripting** — `ccm ls --sort size -n 10`, `ccm export <project> -f md`, `ccm stats`.
+- **Decodes folder names correctly** — by reading the real `cwd` from inside each session's JSONL, not by replacing `-` with `/` and hoping.
+- **Knows about memory and PRs** — surfaces `memory/*.md`, counts messages by type, picks up custom session titles.
+- **No daemon, no config** — operates directly on the on-disk layout Claude Code already uses.
+
+## Installation
+
+<details>
+<summary><b>From source (latest)</b></summary>
+
+```bash
+git clone https://github.com/QuocTang/ccm
+cd ccm
+uv tool install .            # global, available as `ccm`
+# or for dev work:
+uv sync --extra dev
+uv run ccm --help
+```
+
+</details>
+
+<details>
+<summary><b>Without cloning</b></summary>
+
+```bash
+uv tool install git+https://github.com/QuocTang/ccm
+```
+
+</details>
+
+<details>
+<summary><b>Run without installing (one-off)</b></summary>
+
+```bash
+uvx --from git+https://github.com/QuocTang/ccm ccm ls
+```
+
+</details>
+
+## Usage
+
+```bash
+ccm                         # launch TUI (default when no args)
+ccm ls                      # list projects (sorted by recent activity)
+ccm ls -s size -n 10        # sort by size, top 10
+ccm show <project>          # detail for one project
+ccm sessions <project>      # list sessions of a project
+ccm view <project> <sess>   # render messages of a session
+ccm rm <project>            # delete a project directory (with confirm)
+ccm rm-session <p> <s>      # delete one session
+ccm export <p> [<s>] -f md  # export to markdown (or -f json | raw)
+ccm memory <project>        # view memory files
+ccm memory <p> --show NAME  # print one memory file
+ccm memory <p> --rm NAME    # delete one memory file
+ccm stats                   # disk usage dashboard
+ccm tui                     # launch TUI explicitly
+```
+
+`<project>` accepts an encoded dir name, the real `cwd` path, the basename
+(e.g. `my-project`), or any unique substring of either.
+
+`<session>` accepts the full UUID or a unique prefix (the 8-char head shown
+by `ccm sessions` is usually enough).
+
+### TUI keys
+
+| Key          | Action                               |
+| ------------ | ------------------------------------ |
+| `↑/↓` `j/k`  | Move cursor                          |
+| `h/l` `←/→`  | Focus projects / sessions pane       |
+| `Tab`        | Switch panes                         |
+| `Enter`      | Drill in (project → sessions → view) |
+| `m`          | Show memory for highlighted project  |
+| `d`          | Delete focused project / session     |
+| `r`          | Refresh                              |
+| `q` `Ctrl+C` | Quit (or back inside a sub-screen)   |
+
+Inside a delete-confirm modal: `y` / `Enter` to confirm, `n` / `Esc` to cancel.
+
+## Architecture
+
+Three layers, deliberately separated so domain code stays UI-agnostic.
+
+```mermaid
+flowchart LR
+    User([Terminal user])
+    subgraph ccm
+        direction TB
+        CLI["cli/<br/><sub>typer subcommands</sub>"]
+        TUI["tui/<br/><sub>textual app</sub>"]
+        CORE["core/<br/><sub>projects · sessions · memory · stats · export</sub>"]
+        SHARED["palette.py · paths.py<br/><sub>shared theme & path helpers</sub>"]
+    end
+    Disk[("~/.claude/projects/<br/>JSONL sessions + memory/")]
+
+    User -- "ccm <subcommand>" --> CLI
+    User -- "ccm (no args)" --> TUI
+    CLI --> CORE
+    TUI --> CORE
+    CLI -.-> SHARED
+    TUI -.-> SHARED
+    CORE --> Disk
+```
+
+The lossy folder-name encoding is the one bit that requires care: Claude Code
+replaces both `/` and `_` with `-`, so `paths.real_cwd_from_sessions()` reads
+the actual `cwd` field from the first session JSONL inside each directory.
+The naive `-` → `/` replacement is only a fallback for empty projects.
+
+## Development
+
+```bash
+uv sync --extra dev                                           # install + pytest
+uv run pytest -q                                              # run all tests
+uv run pytest tests/core/test_paths.py -k naive_decode        # one test
+uv tool install . --force --reinstall                         # rebuild global `ccm`
+```
+
+See [`CLAUDE.md`](CLAUDE.md) for architecture notes and the textual / typer
+gotchas we hit (lossy path encoding, `Widget._size` shadowing, markup escaping,
+etc).
+
+## Contributing
+
+PRs welcome. Keep the three-layer split (`core` stays UI-agnostic), run
+`uv run pytest -q` before pushing, and follow the gotchas in `CLAUDE.md` if you
+touch `tui/`.
+
+## Contributors
+
+<a href="https://github.com/QuocTang/ccm/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=QuocTang/ccm" alt="Contributors" />
+</a>
+
+## License
+
+[MIT](LICENSE) © QuocTang
+
+## Star history
+
+[![Star History Chart](https://api.star-history.com/svg?repos=QuocTang/ccm&type=Date)](https://star-history.com/#QuocTang/ccm&Date)

claudecm-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "claudecm"
+version = "0.1.0"
+description = "Claude Code Manager — manage Claude Code projects, sessions, and memory"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "QuocTang" }]
+requires-python = ">=3.10"
+keywords = ["claude", "claude-code", "cli", "tui", "anthropic", "manager"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Environment :: Console :: Curses",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Terminals",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13.7",
+    "textual>=0.79",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+]
+
+[project.urls]
+Homepage = "https://github.com/QuocTang/ccm"
+Repository = "https://github.com/QuocTang/ccm"
+Issues = "https://github.com/QuocTang/ccm/issues"
+Changelog = "https://github.com/QuocTang/ccm/releases"
+
+[project.scripts]
+ccm = "ccm.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ccm"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

claudecm-0.1.0/src/ccm/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

claudecm-0.1.0/src/ccm/__main__.py

@@ -0,0 +1,6 @@
+"""Allow `python -m ccm` as an alternative to the `ccm` console script."""
+
+from .cli import app
+
+if __name__ == "__main__":
+    app()

claudecm-0.1.0/src/ccm/cli/__init__.py

@@ -0,0 +1,12 @@
+"""CLI package — re-exports the Typer app and triggers command registration.
+
+Importing this package is enough to register every `@app.command` decorator,
+which is what the `ccm = "ccm.cli:app"` entry point relies on.
+"""
+
+from ._app import app
+
+# Import for side effects — each module attaches commands to `app`.
+from . import _root, projects, sessions, memory, stats  # noqa: E402,F401
+
+__all__ = ["app"]

claudecm-0.1.0/src/ccm/cli/_app.py

@@ -0,0 +1,10 @@
+"""The Typer application instance shared by all command modules."""
+
+import typer
+
+app = typer.Typer(
+    name="ccm",
+    help="Claude Code Manager — manage Claude Code projects, sessions, and memory.",
+    no_args_is_help=False,
+    add_completion=False,
+)

claudecm-0.1.0/src/ccm/cli/_common.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+import typer
+from rich.console import Console
+
+from ..core.projects import find_project
+from ..core.sessions import SessionSummary, find_session
+from ..palette import CORAL, DANGER, DIM
+
+console = Console()
+
+
+def fmt_time(dt: datetime | None) -> str:
+    if dt is None:
+        return "-"
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=timezone.utc)
+    delta = datetime.now(timezone.utc) - dt
+    secs = int(delta.total_seconds())
+    if secs < 60:
+        return f"{secs}s ago"
+    if secs < 3600:
+        return f"{secs // 60}m ago"
+    if secs < 86400:
+        return f"{secs // 3600}h ago"
+    days = secs // 86400
+    if days < 30:
+        return f"{days}d ago"
+    return dt.strftime("%Y-%m-%d")
+
+
+def require_project(identifier: str):
+    p = find_project(identifier)
+    if not p:
+        console.print(f"[{DANGER}]No project matches[/{DANGER}] '{identifier}'.")
+        console.print(
+            f"[{DIM}]Hint: run[/{DIM}] [bold {CORAL}]ccm ls[/bold {CORAL}] "
+            f"[{DIM}]to see available projects.[/{DIM}]"
+        )
+        raise typer.Exit(2)
+    return p
+
+
+def require_session(project, session_id: str) -> SessionSummary:
+    s = find_session(project.path, session_id)
+    if not s:
+        console.print(
+            f"[{DANGER}]No session matches[/{DANGER}] '{session_id}' in {project.real_cwd}."
+        )
+        raise typer.Exit(2)
+    return s