claude-code-log 1.3.0__tar.gz → 1.4.0__tar.gz

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/.github/workflows/ci.yml

@@ -20,6 +20,12 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        # Full history so test/test_commit_linkifier.py's
+        # TestIntegrationLocalRepo can resolve SHAs older than the
+        # current tip (`git branch -r --contains` reads local refs
+        # only and needs the commits in the object DB).
+        fetch-depth: 0
 
     - name: Install uv
       uses: astral-sh/setup-uv@v4

claude_code_log-1.4.0/.github/workflows/docs.yml

@@ -0,0 +1,68 @@
+name: Docs
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+# Allow the deploy job to publish to GitHub Pages.
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Avoid overlapping deploys; let an in-progress run finish.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+env:
+  # Silence the Material-for-MkDocs vendor banner about a future MkDocs 2.0.
+  DISABLE_MKDOCS_2_WARNING: "true"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install docs dependencies
+        run: uv sync --group docs
+
+      - name: Build site (strict)
+        run: uv run mkdocs build --strict
+
+      - name: Upload site as artifact (downloadable preview)
+        uses: actions/upload-artifact@v7
+        with:
+          name: site-preview
+          path: site
+          retention-days: 14
+
+      - name: Upload Pages artifact
+        if: github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    # Only publish from main; PRs just run the strict build above.
+    if: github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/.gitignore

@@ -147,6 +147,8 @@ venv.bak/
 
 # mkdocs documentation
 /site
+# Locally-generated TUI screenshots (regenerated at build time by gen-files)
+docs/assets/tui/
 
 # mypy
 .mypy_cache/
@@ -187,11 +189,10 @@ test/test_data/*.html
 .local.code-workspace
 local.ps1
 
-# Generated documentation examples (uploaded to GitHub releases instead)
-docs/claude-code-log-transcript.html
-docs/cache/
 
 # Integration test data - exclude generated cache/HTML, keep JSONL files
 test/test_data/real_projects/*/cache/
 test/test_data/real_projects/*/*.html
 test/test_data/real_projects/index.html
+# SQLite cache the CLI drops into a projects dir when run against test data
+claude-code-log-cache.db

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/CHANGELOG.md

@@ -6,6 +6,54 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [1.4.0] - 2026-06-03
+
+### Changed
+
+- **Fix sed**
+- **Add MkDocs documentation site with live TUI reference (#197)**
+- **Relax Textual constraint from `==` to `>=` (#196)**
+- **Add `--version` flag to the CLI (#195)**
+- **Fix AskUserQuestion result rendering + highlight chosen options (#180) (#189)**
+- **Derive render_session_id from the SessionTree, not a loop variable (#190)**
+- **Fix collapsible body overlapping preceding content in tool cards (#153) (#187)**
+- **Extract compute_session_data + compute_project_aggregates (C9b) (#188)**
+- **Add C9a characterization tests for session-scan call sites (#186)**
+- **Route converter summary + ai-title extraction through shared helpers (#185)**
+- **status: Wave B fully merged; Wave C kickoff (C8/C9a/C9b stacked, C10 dropped, decisions locked)**
+- **Compute branch preview once from the DAG-line (#184)**
+- **status: #184 fully validated (CI 11/11, CodeRabbit clean) — ready to merge**
+- **docs: keep simplification status note self-contained to project scope**
+- **status: correct #184 state; move GitHub CI/CodeRabbit ops to github guideline**
+- **status: reverse-order stacked-PR lift recipe CONFIRMED on #184**
+- **Factor session-header construction out of _render_messages (#183)**
+- **status: #183/#184 rebased + CodeRabbit forced (#183 clean, #184 2 doc fixes); record @coderabbitai + reverse-order workarounds**
+- **Dedup requestId tokens in pagination cache-miss fallback (#182)**
+- **status: Wave B track complete — opp 7 PR #184 up, all monk-approved; add merge sequence**
+- **status: note stacked-PR CI/CodeRabbit defers to merge-time**
+- **status: opp 1 green (#182, awaiting merge); opp 6 #183 in review; opp 7 in progress**
+- **status: opp 1 -> PR #182 (in review); opp 6 in progress**
+- **Add live-status section to simplification plan**
+- **Add converter/renderer simplification plan**
+- **Move detail-visibility predicate onto MessageContent (#181)**
+- **Sync rendering-architecture.md §5 with the current pipeline (#178)**
+- **Extract inline junction-forward-link block into a named pass (#177)**
+- **Co-locate the away-summary detail rule on AwaySummaryMessage (#176)**
+- **Remove vestigial progress-chain parent repair (#175)**
+- **plugins: dev-docs gaps + public helper API + ToolResult example (Phase 2) (#173)**
+- **Implement unified plugin system from RFC #166 (#169)**
+- **Render Read tool results with pygments via structured payload (closes #170) (#172)**
+- **work/: triage against shipped main (#171)**
+- **Always regenerate projects index so variant-flag toggles refresh links (#168)**
+- **RFC: plugin system (unified message-transformer mechanism) (#166)**
+- **Per-message timestamps in Markdown output (#160) (#165)**
+- **Support non-GitHub forges via static map + `--git-link` fallback (#156) (#164)**
+- **Obsidian-friendly output: --output dir + --expand-paths + --filter-path (#151) (#155)**
+- **Linkify commit SHAs in rendered Markdown + HTML — closes #156 (#161)**
+- **CSS clean-ups (issue #153) (#163)**
+- **Cross-link TaskOutput / TaskUpdate headers back to their spawn (#154) (#158)**
+
+
 ## [1.3.0] - 2026-05-14
 
 ### Changed

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/CLAUDE.md

@@ -107,9 +107,16 @@ with pointers to the deep-dive docs:
 - [dev-docs/teammates.md](dev-docs/teammates.md) - Teammates feature deep-dive
 - [dev-docs/message-hierarchy.md](dev-docs/message-hierarchy.md) - Fold/unfold state machine
 - [dev-docs/implementing-a-tool-renderer.md](dev-docs/implementing-a-tool-renderer.md) - How-to: add a new tool
+- [dev-docs/plugins.md](dev-docs/plugins.md) - Plugin system reference + author guide
 
 User-facing docs live in [docs/](docs/); plans and TODOs live in [work/](work/).
 
+A documentation site (MkDocs + Material) is published to GitHub Pages from
+`docs/` + `mkdocs.yml`. The CLI reference is rendered live from Click, and the
+TUI reference (keybindings + screenshots) is auto-generated at build time. See
+the "Documentation Site" section of @CONTRIBUTING.md. Preview with
+`just docs-serve`; strict build with `just docs-build`.
+
 ### Keeping dev-docs/ in sync
 
 `dev-docs/` is **as-built reference** — the code is the authoritative

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/CONTRIBUTING.md

@@ -206,6 +206,47 @@ kill -USR1 $(pgrep -f claude-code-log | head -1)
 
 The handler is installed in `cli.py` via `faulthandler.register(SIGUSR1)`. POSIX-only; no-op on Windows. Unlike `py-spy`, it needs no root and no extra install.
 
+## Documentation Site
+
+The project publishes a documentation site to GitHub Pages, built with
+[MkDocs](https://www.mkdocs.org/) and the
+[Material](https://squidfunk.github.io/mkdocs-material/) theme. The site
+configuration is `mkdocs.yml`; pages live under `docs/`.
+
+```bash
+# Install docs dependencies
+uv sync --group docs
+
+# Live-reload preview at http://127.0.0.1:8000
+just docs-serve
+
+# Strict build (fails on broken links/nav — same as CI)
+just docs-build
+```
+
+Key points:
+
+- **CLI reference** (`docs/reference/cli.md`) is rendered live from the Click
+  command via the `mkdocs-click` plugin — no manual upkeep.
+- **TUI reference** (`reference/tui.md`) is generated at build time by
+  `docs/gen_pages.py` (a `mkdocs-gen-files` script): it introspects the Textual
+  `BINDINGS` for the keybindings tables (`scripts/generate_tui_docs.py`) and
+  captures SVG screenshots of the running TUI
+  (`scripts/generate_tui_screenshots.py`). Both scripts are runnable standalone.
+- **Example output** (`example.md` + `examples/transcript.html`) is rendered at
+  build time from a bundled sample project
+  (`scripts/generate_example_output.py`, also `just example`) — no private data
+  or release asset involved. Generation is fault-tolerant so a render hiccup
+  can't block the build.
+- **Development** section surfaces `dev-docs/` (symlinked as `docs/development`).
+  `CONTRIBUTING.md` and `CHANGELOG.md` are symlinked in as `docs/contributing.md`
+  and `docs/changelog.md`. A build hook (`docs/hooks.py`) rewrites links to repo
+  source files (e.g. `../claude_code_log/cli.py`) into GitHub URLs so the strict
+  build stays green.
+- Deployment is automated by `.github/workflows/docs.yml`: PRs run a strict
+  build; pushes to `main` deploy to Pages. The repo's **Settings → Pages →
+  Source** must be set to **GitHub Actions** (one-time).
+
 ## Architecture
 
 Start with [dev-docs/application_model.md](dev-docs/application_model.md)

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-log
-Version: 1.3.0
+Version: 1.4.0
 Summary: Convert Claude Code transcript JSONL files to HTML
 Project-URL: Homepage, https://github.com/daaain/claude-code-log
 Project-URL: Issues, https://github.com/daaain/claude-code-log/issues
@@ -18,7 +18,7 @@ Requires-Dist: mistune>=3.1.4
 Requires-Dist: packaging>=25.0
 Requires-Dist: pydantic>=2.12.0
 Requires-Dist: pygments>=2.19.2
-Requires-Dist: textual==6.5.0
+Requires-Dist: textual>=6.5.0
 Requires-Dist: toml>=0.10.2
 Description-Content-Type: text/markdown
 
@@ -40,7 +40,7 @@ TUI demo:
 
 This tool generates clean, minimalist HTML pages showing user prompts and assistant responses chronologically. It's designed to create a readable log of your Claude Code interactions with support for both individual files and entire project hierarchies.
 
-📄 **[View Example HTML Output](https://github.com/daaain/claude-code-log/releases/latest/download/claude-code-log-transcript.html)** - Download a real example generated from this project's development (large file, ~100 MB)
+📄 **[View Example HTML Output](https://daaain.github.io/claude-code-log/example/)** - A real example generated from a sample of this project's development, regenerated on every docs build
 
 ## Quickstart
 
@@ -188,6 +188,21 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--compact` merges consecutive same-type sections in Markdown so runs of assistant responses share one heading instead of repeating `### 🤖 Assistant:` for each.
 
+### Linking Commit SHAs
+
+Plain `7c2e6f6`-shaped tokens in transcript prose get turned into clickable commit links when the SHA is reachable from a local remote-tracking branch. **github.com**, **gitlab.com**, and **bitbucket.org** work out of the box. For self-hosted forges (in-house GitLab, Gitea, Forgejo, …), supply a URL template via `--git-link`:
+
+```bash
+# Self-hosted GitLab
+claude-code-log /path/to/transcript --git-link 'https://{host}/{path}/-/commit/{sha}'
+
+# Same thing via env var (useful for TUI / repeated invocations)
+export CLAUDE_CODE_LOG_GIT_LINK='https://{host}/{path}/-/commit/{sha}'
+claude-code-log --tui
+```
+
+Placeholders: `{host}`, `{path}`, `{sha}`. The template fires only when the static map doesn't already know the host, so a mix of GitHub repos + self-hosted GitLab gets correct links from both. SHAs not reachable from any local remote-tracking ref render as plain text — local-only work-in-progress commits never produce broken links.
+
 ## Project Hierarchy Output
 
 When processing all projects, the tool generates:

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/README.md

@@ -16,7 +16,7 @@ TUI demo:
 
 This tool generates clean, minimalist HTML pages showing user prompts and assistant responses chronologically. It's designed to create a readable log of your Claude Code interactions with support for both individual files and entire project hierarchies.
 
-📄 **[View Example HTML Output](https://github.com/daaain/claude-code-log/releases/latest/download/claude-code-log-transcript.html)** - Download a real example generated from this project's development (large file, ~100 MB)
+📄 **[View Example HTML Output](https://daaain.github.io/claude-code-log/example/)** - A real example generated from a sample of this project's development, regenerated on every docs build
 
 ## Quickstart
 
@@ -164,6 +164,21 @@ claude-code-log /path/to/project --detail low --format md --compact
 
 `--compact` merges consecutive same-type sections in Markdown so runs of assistant responses share one heading instead of repeating `### 🤖 Assistant:` for each.
 
+### Linking Commit SHAs
+
+Plain `7c2e6f6`-shaped tokens in transcript prose get turned into clickable commit links when the SHA is reachable from a local remote-tracking branch. **github.com**, **gitlab.com**, and **bitbucket.org** work out of the box. For self-hosted forges (in-house GitLab, Gitea, Forgejo, …), supply a URL template via `--git-link`:
+
+```bash
+# Self-hosted GitLab
+claude-code-log /path/to/transcript --git-link 'https://{host}/{path}/-/commit/{sha}'
+
+# Same thing via env var (useful for TUI / repeated invocations)
+export CLAUDE_CODE_LOG_GIT_LINK='https://{host}/{path}/-/commit/{sha}'
+claude-code-log --tui
+```
+
+Placeholders: `{host}`, `{path}`, `{sha}`. The template fires only when the static map doesn't already know the host, so a mix of GitHub repos + self-hosted GitLab gets correct links from both. SHAs not reachable from any local remote-tracking ref render as plain text — local-only work-in-progress commits never produce broken links.
+
 ## Project Hierarchy Output
 
 When processing all projects, the tool generates:

{claude_code_log-1.3.0 → claude_code_log-1.4.0}/claude_code_log/cli.py

@@ -468,13 +468,99 @@ def _clear_output_files(
         click.echo(f"Warning: Failed to clear {ext_upper} files: {e}")
 
 
+# Placeholders accepted by ``--git-link`` templates. Mirrors
+# ``resolve_sha`` in claude_code_log.git_remote — keep in sync.
+_GIT_LINK_ALLOWED_PLACEHOLDERS = frozenset({"host", "path", "sha"})
+
+
+def _validate_git_link_template(template: str) -> None:
+    """Validate a ``--git-link`` template eagerly; raise ``click.UsageError`` on issues.
+
+    Two checks:
+
+    1. ``{sha}`` must be present (it's the only mandatory field —
+       the resolver's whole job is to substitute the commit SHA).
+    2. All placeholders must be in ``_GIT_LINK_ALLOWED_PLACEHOLDERS``.
+       Catches typos like ``{hsot}`` before they reach
+       ``template.format()`` (which would raise ``KeyError`` at
+       render time). The resolver has a try/except guarding the
+       env-var-only path; this validator is the loud-error path for
+       CLI users.
+
+    Uses ``string.Formatter().parse()`` rather than regex so the
+    same parser Python uses for ``str.format`` decides what counts
+    as a placeholder.
+    """
+    import string
+
+    parsed_fields = [
+        field
+        for _, field, _, _ in string.Formatter().parse(template)
+        if field is not None
+    ]
+    if "" in parsed_fields:
+        raise click.UsageError(
+            "--git-link template uses an anonymous positional placeholder ({}). "
+            "Use a named placeholder ({host}, {path}, or {sha}) instead "
+            f"(got: {template!r})."
+        )
+    fields = set(parsed_fields)
+    unknown = fields - _GIT_LINK_ALLOWED_PLACEHOLDERS
+    if unknown:
+        raise click.UsageError(
+            f"--git-link template uses unknown placeholder(s): "
+            f"{', '.join('{' + f + '}' for f in sorted(unknown))}. "
+            f"Allowed: {{host}}, {{path}}, {{sha}}."
+        )
+    if "sha" not in fields:
+        raise click.UsageError(
+            "--git-link template must contain a {sha} placeholder "
+            f"(got: {template!r}). Example: "
+            "'https://{host}/{path}/-/commit/{sha}'."
+        )
+
+
 @click.command()
+@click.version_option(version=get_library_version(), prog_name="claude-code-log")
 @click.argument("input_path", type=click.Path(path_type=Path), required=False)
 @click.option(
     "-o",
     "--output",
     type=click.Path(path_type=Path),
-    help="Output file path (default: input file with format extension, or combined_transcripts.{html,md} for directories)",
+    help=(
+        "Output destination. With a recognised file suffix "
+        "(.html/.md/.markdown/.json) treated as a single output file; "
+        "otherwise treated as a directory root (and now also honoured "
+        "for --all-projects, where outputs land at "
+        "<output>/<project>/...). Pair with --expand-paths to project "
+        "back to the real on-disk tree."
+    ),
+)
+@click.option(
+    "--expand-paths",
+    is_flag=True,
+    help=(
+        "When set with --output and --all-projects, expand each "
+        "project's flat encoded dir name (e.g. '-home-joe-project-A') "
+        "back to its real path under <output>/. Resolves the encoded "
+        "name via the cache's recorded `cwd`, falling back to a peek "
+        "of the first JSONL when the cache is empty. Useful for "
+        "projecting transcripts into Obsidian-style Markdown vaults."
+    ),
+)
+@click.option(
+    "--filter-path",
+    type=str,
+    default=None,
+    help=(
+        "Restrict --all-projects to projects matching a path prefix. "
+        "With --expand-paths, the prefix is matched against the "
+        "expanded real path AND truncated from the destination "
+        "(`/home/joe/project/A` with --filter-path /home/joe lands at "
+        "<output>/project/A/). Without --expand-paths, matches the "
+        "flat encoded dir name (e.g. '-home-joe' selects projects "
+        "starting with '-home-joe-')."
+    ),
 )
 @click.option(
     "--open-browser",
@@ -499,7 +585,25 @@ def _clear_output_files(
 @click.option(
     "--no-individual-sessions",
     is_flag=True,
-    help="Skip generating individual session HTML files (only create combined transcript)",
+    help=(
+        "Skip generating individual session files (combined transcript only). "
+        "Back-compat alias for --combined only."
+    ),
+)
+@click.option(
+    "--combined",
+    "combined",
+    type=click.Choice(["yes", "no", "only"], case_sensitive=False),
+    default=None,
+    help=(
+        "Control combined-vs-individual transcript generation: "
+        "'yes' = both combined and per-session files (default for --all-projects); "
+        "'no' = only per-session files (recommended for Obsidian / vault use — "
+        "combined is dead weight); "
+        "'only' = only the combined file (= --no-individual-sessions). "
+        "When unset, defaults to 'no' under --expand-paths (Obsidian mode), "
+        "else 'yes'."
+    ),
 )
 @click.option(
     "--no-cache",
@@ -578,6 +682,29 @@ def _clear_output_files(
         "Markdown-only — a no-op for HTML."
     ),
 )
+@click.option(
+    "--git-link",
+    "git_link",
+    default=None,
+    envvar="CLAUDE_CODE_LOG_GIT_LINK",
+    metavar="TEMPLATE",
+    help=(
+        "URL template for resolving commit SHAs on forges not in the built-in "
+        "map (github.com, gitlab.com, bitbucket.org). Placeholders: {host}, "
+        "{path}, {sha}. Example for self-hosted GitLab: "
+        "--git-link 'https://{host}/{path}/-/commit/{sha}'. Can also be set "
+        "via the CLAUDE_CODE_LOG_GIT_LINK env var."
+    ),
+)
+@click.option(
+    "--no-timestamps",
+    is_flag=True,
+    help=(
+        "Suppress per-message timestamp lines in Markdown output "
+        "(#160). Markdown-only — a warning is emitted (but not an "
+        "error) if combined with --format html / --format json."
+    ),
+)
 @click.option(
     "--debug",
     is_flag=True,
@@ -587,6 +714,9 @@ def _clear_output_files(
 def main(
     input_path: Optional[Path],
     output: Optional[Path],
+    expand_paths: bool,
+    filter_path: Optional[str],
+    combined: Optional[str],
     open_browser: bool,
     from_date: Optional[str],
     to_date: Optional[str],
@@ -603,6 +733,8 @@ def main(
     session_id: Optional[str],
     detail: str,
     compact: bool,
+    git_link: Optional[str],
+    no_timestamps: bool,
     debug: bool,
 ) -> None:
     """Convert Claude transcript JSONL files to HTML or Markdown.
@@ -613,9 +745,101 @@ def main(
     # can be diagnosed with `kill -USR1 <pid>` without root or restart.
     _install_stack_dump_signal()
 
+    # Custom-forge URL template: validate eagerly with a loud error,
+    # then pin to the env var so the resolver (which reads the env at
+    # render time) picks it up. Doing this at env-var level keeps the
+    # resolver decoupled from Click; the env var is the underlying
+    # contract, the CLI flag is a convenience that sets it.
+    if git_link is not None:
+        _validate_git_link_template(git_link)
+        os.environ["CLAUDE_CODE_LOG_GIT_LINK"] = git_link
+
     # Configure logging to show warnings and above
     logging.basicConfig(level=logging.WARNING, format="%(levelname)s: %(message)s")
 
+    # Resolve --combined default and back-compat with --no-individual-sessions.
+    # `--combined` semantics:
+    #   yes  → write combined transcript AND per-session files
+    #   no   → write per-session files only (Obsidian-friendly)
+    #   only → write combined transcript only (= --no-individual-sessions)
+    # Default: yes, except when --expand-paths is set (Obsidian mode → no).
+    if combined is None:
+        combined = "no" if expand_paths else "yes"
+    else:
+        combined = combined.lower()
+    if no_individual_sessions:
+        if combined == "no":
+            raise click.BadParameter(
+                "--no-individual-sessions conflicts with --combined no "
+                "(both attempt to skip per-session files but --no-individual-sessions "
+                "implies combined-only). Pick one.",
+                param_hint="--no-individual-sessions",
+            )
+        # `--no-individual-sessions` is a strict alias for `--combined only`;
+        # honour it for back-compat (and prefer this over an unset --combined).
+        combined = "only"
+    # Derived flags actually consumed downstream.
+    write_combined = combined in ("yes", "only")
+    write_individual = combined in ("yes", "no")
+
+    # Loud rejection of relative `--filter-path` when paired with
+    # `--expand-paths` (#151). Without this, a user typing
+    # `--filter-path home/joe` (forgetting the leading `/`) would
+    # match against an absolute resolved path via `Path.relative_to`,
+    # which raises ValueError for *any* mismatch including
+    # "argument is relative" — so the silent failure mode is "every
+    # project skipped". Reject up-front instead.
+    #
+    # `path_looks_absolute` is host-OS-agnostic (accepts POSIX `/`
+    # OR Windows `C:\` form), so a Linux-recorded `/home/joe`
+    # processed on Windows still passes the guard.
+    from .utils import path_looks_absolute as _path_looks_absolute
+
+    if filter_path and expand_paths and not _path_looks_absolute(filter_path):
+        raise click.BadParameter(
+            f"--filter-path must be an absolute path when --expand-paths is set; "
+            f"got {filter_path!r}",
+            param_hint="--filter-path",
+        )
+
+    # Warn early if Obsidian-friendly flags (#151) were passed in a
+    # context where they're no-ops. `--all-projects` (explicit or
+    # implicit via no input_path) is the only mode that consumes them;
+    # `--output` must be a directory (file-suffixed output goes
+    # through the single-file path which doesn't honour these flags).
+    from .utils import output_path_is_file as _output_path_is_file
+
+    will_run_all_projects = all_projects or input_path is None
+    if (expand_paths or filter_path) and tui:
+        click.echo(
+            "Warning: --expand-paths / --filter-path are ignored in --tui mode.",
+            err=True,
+        )
+    elif (expand_paths or filter_path) and not will_run_all_projects:
+        click.echo(
+            "Warning: --expand-paths / --filter-path require --all-projects "
+            "(or omitting INPUT_PATH); ignoring.",
+            err=True,
+        )
+    elif (expand_paths or filter_path) and (
+        output is None or _output_path_is_file(output)
+    ):
+        click.echo(
+            "Warning: --expand-paths / --filter-path require --output to be a "
+            "directory (no recognised file suffix); ignoring.",
+            err=True,
+        )
+
+    # `--no-timestamps` is Markdown-only (#160). Warn (not error) when
+    # paired with HTML/JSON so the flag is benignly ignored rather than
+    # silently misapplied.
+    if no_timestamps and output_format not in ("md", "markdown"):
+        click.echo(
+            f"Warning: --no-timestamps is Markdown-only; ignoring under "
+            f"--format {output_format}.",
+            err=True,
+        )
+
     from .models import DetailLevel
 
     detail_level = DetailLevel(detail.lower())
@@ -779,6 +1003,7 @@ def main(
                 image_export_mode,
                 detail=detail_level,
                 compact=compact,
+                no_timestamps=no_timestamps,
             )
             click.echo(f"Successfully exported session to {output_path}")
             if open_browser:
@@ -813,17 +1038,32 @@ def main(
                 raise FileNotFoundError(f"Projects directory not found: {input_path}")
 
             click.echo(f"Processing all projects in {input_path}...")
+            # `--output` for `--all-projects` (#151): pass a *directory*
+            # to project per-project outputs into. File-suffixed values
+            # are routed to the single-file path elsewhere; here we
+            # only honour directory-shaped `--output`.
+            from .utils import output_path_is_file
+
+            output_dir_for_projects: Optional[Path] = None
+            if output is not None and not output_path_is_file(output):
+                output_dir_for_projects = output
+
             output_path = process_projects_hierarchy(
                 input_path,
                 from_date,
                 to_date,
                 not no_cache,
-                not no_individual_sessions,
+                write_individual,
                 output_format,
                 image_export_mode,
                 page_size=page_size,
                 detail=detail_level,
                 compact=compact,
+                output_dir=output_dir_for_projects,
+                expand_paths=expand_paths,
+                filter_path=filter_path,
+                write_combined=write_combined,
+                no_timestamps=no_timestamps,
             )
 
             # Count processed projects
@@ -872,7 +1112,7 @@ def main(
             output,
             from_date,
             to_date,
-            not no_individual_sessions,
+            write_individual,
             not no_cache,
             image_export_mode=image_export_mode,
             page_size=page_size,
@@ -881,12 +1121,14 @@ def main(
             # User's `-o` path is a one-off export, not a cached artifact:
             # don't occupy a cache slot keyed by an arbitrary destination.
             update_cache=output is None,
+            write_combined=write_combined,
+            no_timestamps=no_timestamps,
         )
         if input_path.is_file():
             click.echo(f"Successfully converted {input_path} to {output_path}")
         else:
             jsonl_count = len(list(input_path.glob("*.jsonl")))
-            if not no_individual_sessions:
+            if write_individual:
                 ext = get_file_extension(output_format)
                 session_files = list(input_path.glob(f"session-*.{ext}"))
                 click.echo(