claude-multi-usage 0.1.0__tar.gz

claude_multi_usage-0.1.0/LICENSE

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

claude_multi_usage-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: claude-multi-usage
+Version: 0.1.0
+Summary: Claude Code usage dashboard across multiple devices
+Author: nuhgnod
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hunknownn/claude-multi-usage
+Project-URL: Repository, https://github.com/hunknownn/claude-multi-usage
+Project-URL: Issues, https://github.com/hunknownn/claude-multi-usage/issues
+Keywords: claude,cli,dashboard,usage,anthropic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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 :: Libraries :: Python Modules
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Requires-Dist: click>=8.0
+Dynamic: license-file

claude_multi_usage-0.1.0/README.md

@@ -0,0 +1,2 @@
+# claude-multi-usage
+claude-multi-usage

claude_multi_usage-0.1.0/claude_multi_usage/cli.py

@@ -0,0 +1,85 @@
+"""CLI entry point for claude-multi-usage."""
+
+import click
+
+from .parser import load_usage_data
+from .dashboard import render_dashboard, make_projects_table, make_models_table, Console
+
+
+@click.group(invoke_without_command=True)
+@click.pass_context
+def main(ctx):
+    """Claude Code usage dashboard across multiple devices."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(dashboard)
+
+
+@main.command()
+@click.option("--days", "-d", default=14, help="Number of days to show in chart")
+def dashboard(days: int):
+    """Show the full usage dashboard."""
+    data = load_usage_data()
+    render_dashboard(data, days=days)
+
+
+@main.command()
+def today():
+    """Show today's usage summary."""
+    from datetime import datetime
+    from rich.table import Table
+    from rich.panel import Panel
+    from .dashboard import format_tokens
+
+    console = Console()
+    data = load_usage_data()
+    today_str = datetime.now().strftime("%Y-%m-%d")
+
+    activity = next((a for a in data.daily_activity if a.date == today_str), None)
+    tokens_data = next((t for t in data.daily_model_tokens if t.date == today_str), None)
+
+    if not activity:
+        console.print(f"[dim]No usage data for today ({today_str})[/dim]")
+        return
+
+    table = Table(show_header=False, box=None, padding=(0, 2))
+    table.add_column("label", style="dim")
+    table.add_column("value", style="bold cyan")
+
+    table.add_row("Date", today_str)
+    table.add_row("Sessions", str(activity.session_count))
+    table.add_row("Messages", str(activity.message_count))
+    table.add_row("Tool Calls", str(activity.tool_call_count))
+
+    if tokens_data:
+        for model, tokens in tokens_data.tokens_by_model.items():
+            short = model.split("-202")[0] if "-202" in model else model
+            table.add_row(f"Tokens ({short})", format_tokens(tokens))
+        table.add_row("Total Tokens", format_tokens(tokens_data.total_tokens))
+
+    console.print()
+    console.print(Panel(table, title=f"Today - {data.hostname}", border_style="blue"))
+    console.print()
+
+
+@main.command()
+def projects():
+    """Show project usage breakdown."""
+    console = Console()
+    data = load_usage_data()
+    console.print()
+    console.print(make_projects_table(data, limit=20))
+    console.print()
+
+
+@main.command()
+def models():
+    """Show model usage breakdown."""
+    console = Console()
+    data = load_usage_data()
+    console.print()
+    console.print(make_models_table(data))
+    console.print()
+
+
+if __name__ == "__main__":
+    main()

claude_multi_usage-0.1.0/claude_multi_usage/dashboard.py

@@ -0,0 +1,188 @@
+"""Rich-based terminal dashboard for Claude Code usage."""
+
+from __future__ import annotations
+
+from datetime import datetime, timedelta
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.columns import Columns
+
+from .parser import UsageData
+
+
+def format_tokens(n: int) -> str:
+    if n >= 1_000_000:
+        return f"{n / 1_000_000:.1f}M"
+    if n >= 1_000:
+        return f"{n / 1_000:.1f}K"
+    return str(n)
+
+
+def make_summary_panel(data: UsageData) -> Panel:
+    """Overall summary stats."""
+    table = Table(show_header=False, box=None, padding=(0, 2))
+    table.add_column("label", style="dim")
+    table.add_column("value", style="bold cyan")
+
+    table.add_row("Hostname", data.hostname)
+    table.add_row("Total Sessions", str(data.total_sessions))
+    table.add_row("Total Messages", f"{data.total_messages:,}")
+
+    if data.first_session_date:
+        first = data.first_session_date[:10]
+        table.add_row("First Session", first)
+
+    total_output = sum(m.output_tokens for m in data.model_usage)
+    table.add_row("Total Output Tokens", format_tokens(total_output))
+
+    return Panel(table, title="Summary", border_style="blue")
+
+
+def make_daily_chart(data: UsageData, days: int = 14) -> Panel:
+    """Daily usage bar chart for recent days."""
+    activities = data.daily_activity[-days:]
+    if not activities:
+        return Panel("No data", title="Daily Usage")
+
+    max_tokens = 1
+    token_map: dict[str, int] = {}
+    for dt in data.daily_model_tokens:
+        token_map[dt.date] = dt.total_tokens
+
+    # 날짜 범위를 채워서 빈 날도 표시
+    all_dates: list[tuple[str, int, int, int]] = []
+    if activities:
+        start = datetime.strptime(activities[0].date, "%Y-%m-%d")
+        end = datetime.strptime(activities[-1].date, "%Y-%m-%d")
+        act_map = {a.date: a for a in activities}
+
+        current = start
+        while current <= end:
+            d = current.strftime("%Y-%m-%d")
+            a = act_map.get(d)
+            tokens = token_map.get(d, 0)
+            msgs = a.message_count if a else 0
+            sessions = a.session_count if a else 0
+            all_dates.append((d, tokens, msgs, sessions))
+            if tokens > max_tokens:
+                max_tokens = tokens
+            current += timedelta(days=1)
+
+    # 최근 N일만
+    all_dates = all_dates[-days:]
+
+    bar_width = 30
+    lines = []
+    for date_str, tokens, msgs, sessions in all_dates:
+        short_date = date_str[5:]  # MM-DD
+        filled = int((tokens / max_tokens) * bar_width) if max_tokens > 0 else 0
+        bar = "█" * filled + "░" * (bar_width - filled)
+
+        if tokens > 0:
+            line = f"  {short_date}  {bar}  {format_tokens(tokens):>6}  ({msgs} msgs, {sessions} sess)"
+        else:
+            line = f"  {short_date}  {'░' * bar_width}  {'':>6}"
+        lines.append(line)
+
+    return Panel("\n".join(lines), title=f"Daily Tokens (last {days} days)", border_style="green")
+
+
+def make_hourly_heatmap(data: UsageData) -> Panel:
+    """24-hour session heatmap."""
+    if not data.hour_counts:
+        return Panel("No data", title="Hourly Activity")
+
+    max_count = max(data.hour_counts.values()) if data.hour_counts else 1
+    blocks = "  ░░▒▒▓▓██"
+    styles = ["dim", "green", "yellow", "red", "bold red"]
+
+    table = Table(box=None, padding=(0, 0), show_header=True, header_style="dim")
+    for h in range(24):
+        table.add_column(f"{h:02d}", justify="center", width=4)
+
+    cells = []
+    for h in range(24):
+        count = data.hour_counts.get(h, 0)
+        if count == 0:
+            idx = 0
+        else:
+            idx = min(int((count / max_count) * 4) + 1, 4)
+        block = blocks[idx * 2:idx * 2 + 2]
+        style = styles[idx]
+        cells.append(f"[{style}]{block}[/{style}]")
+
+    table.add_row(*cells)
+
+    # 수치 행
+    count_cells = []
+    for h in range(24):
+        count = data.hour_counts.get(h, 0)
+        count_cells.append(f"[dim]{count}[/dim]" if count > 0 else "[dim]·[/dim]")
+    table.add_row(*count_cells)
+
+    return Panel(table, title="Hourly Sessions (all time)", border_style="yellow")
+
+
+def make_projects_table(data: UsageData, limit: int = 10) -> Panel:
+    """Top projects by session count."""
+    table = Table(box=None, padding=(0, 1))
+    table.add_column("#", style="dim", width=3)
+    table.add_column("Project", style="bold")
+    table.add_column("Sessions", justify="right", style="cyan")
+    table.add_column("Last Used", style="dim")
+
+    for i, project in enumerate(data.projects[:limit], 1):
+        last = project.last_seen.strftime("%Y-%m-%d") if project.last_seen else "-"
+        table.add_row(str(i), project.name, str(project.session_count), last)
+
+    return Panel(table, title=f"Top Projects (total {len(data.projects)})", border_style="magenta")
+
+
+def make_models_table(data: UsageData) -> Panel:
+    """Model usage breakdown."""
+    table = Table(box=None, padding=(0, 1))
+    table.add_column("Model", style="bold")
+    table.add_column("Output", justify="right", style="cyan")
+    table.add_column("Cache Read", justify="right", style="green")
+    table.add_column("Cache Create", justify="right", style="yellow")
+
+    for m in sorted(data.model_usage, key=lambda x: x.output_tokens, reverse=True):
+        # 모델명 짧게
+        short_name = m.model.split("-202")[0] if "-202" in m.model else m.model
+        table.add_row(
+            short_name,
+            format_tokens(m.output_tokens),
+            format_tokens(m.cache_read_tokens),
+            format_tokens(m.cache_creation_tokens),
+        )
+
+    return Panel(table, title="Model Usage", border_style="red")
+
+
+def render_dashboard(data: UsageData, days: int = 14) -> None:
+    """Render the full dashboard."""
+    console = Console()
+
+    today = datetime.now().strftime("%Y-%m-%d")
+    title = f"Claude Usage Dashboard  ──  {data.hostname}  ──  {today}"
+    console.print()
+    console.rule(f"[bold blue]{title}[/bold blue]")
+    console.print()
+
+    # Summary + Models side by side
+    console.print(Columns([make_summary_panel(data), make_models_table(data)], equal=True))
+    console.print()
+
+    # Daily chart
+    console.print(make_daily_chart(data, days=days))
+    console.print()
+
+    # Hourly heatmap
+    console.print(make_hourly_heatmap(data))
+    console.print()
+
+    # Projects
+    console.print(make_projects_table(data))
+    console.print()

claude_multi_usage-0.1.0/claude_multi_usage/parser.py

@@ -0,0 +1,203 @@
+"""Parse Claude Code local data from ~/.claude"""
+
+from __future__ import annotations
+
+import json
+import socket
+from dataclasses import dataclass, field
+from datetime import datetime
+from pathlib import Path
+from typing import Optional
+
+
+CLAUDE_DIR = Path.home() / ".claude"
+STATS_FILE = CLAUDE_DIR / "stats-cache.json"
+HISTORY_FILE = CLAUDE_DIR / "history.jsonl"
+PROJECTS_DIR = CLAUDE_DIR / "projects"
+
+
+@dataclass
+class DailyActivity:
+    date: str
+    message_count: int
+    session_count: int
+    tool_call_count: int
+
+
+@dataclass
+class DailyModelTokens:
+    date: str
+    tokens_by_model: dict[str, int]
+
+    @property
+    def total_tokens(self) -> int:
+        return sum(self.tokens_by_model.values())
+
+
+@dataclass
+class ModelUsage:
+    model: str
+    input_tokens: int
+    output_tokens: int
+    cache_read_tokens: int
+    cache_creation_tokens: int
+
+
+@dataclass
+class ProjectSummary:
+    name: str
+    session_count: int
+    first_seen: datetime | None = None
+    last_seen: datetime | None = None
+
+
+@dataclass
+class UsageData:
+    hostname: str
+    daily_activity: list[DailyActivity] = field(default_factory=list)
+    daily_model_tokens: list[DailyModelTokens] = field(default_factory=list)
+    model_usage: list[ModelUsage] = field(default_factory=list)
+    projects: list[ProjectSummary] = field(default_factory=list)
+    hour_counts: dict[int, int] = field(default_factory=dict)
+    total_sessions: int = 0
+    total_messages: int = 0
+    first_session_date: str | None = None
+
+
+def get_hostname() -> str:
+    return socket.gethostname()
+
+
+def parse_stats_cache() -> dict | None:
+    if not STATS_FILE.exists():
+        return None
+    with open(STATS_FILE) as f:
+        return json.load(f)
+
+
+def _deduplicate_project_name(name: str) -> str:
+    """Remove duplicate path segments from project names.
+
+    e.g., 'apr-backend-assignment-apr-backend-assignment' -> 'apr-backend-assignment'
+          'url-jarvis-url-jarvis-docs' -> 'url-jarvis/docs'
+    """
+    # 이름을 반으로 나눠서 앞뒤가 같으면 중복
+    length = len(name)
+    for split_pos in range(1, length):
+        prefix = name[:split_pos]
+        rest = name[split_pos:]
+        if rest.startswith("-" + prefix):
+            suffix = rest[len(prefix) + 1:]
+            if suffix:
+                return prefix + "/" + suffix
+            return prefix
+    return name
+
+
+def parse_projects() -> list[ProjectSummary]:
+    """Parse project directories to get project summaries."""
+    if not PROJECTS_DIR.exists():
+        return []
+
+    projects = []
+    for project_dir in sorted(PROJECTS_DIR.iterdir()):
+        if not project_dir.is_dir():
+            continue
+
+        raw_name = project_dir.name
+        # 경로 형식: -Users-gimdonghun-workspace-project-subdir
+        # "workspace" 이후 부분을 추출하고 중복 제거
+        parts = raw_name.split("-")
+        try:
+            ws_idx = parts.index("workspace")
+            path_parts = "-".join(parts[ws_idx + 1:]) if ws_idx + 1 < len(parts) else raw_name
+            # 경로 구분자로 분리 후 중복 제거 (e.g., "apr-backend-assignment-apr-backend-assignment")
+            # 실제 디렉토리 구조 기반으로 의미 있는 이름 추출
+            segments = path_parts.split("-")
+            # 연속된 동일 패턴 제거
+            project_name = _deduplicate_project_name(path_parts)
+        except ValueError:
+            project_name = raw_name
+
+        if not project_name or project_name.startswith("-Users"):
+            project_name = raw_name.rsplit("-", 1)[-1] or "home"
+
+        # "url-jarvis/-docs" → "url-jarvis-docs"
+        project_name = project_name.replace("/-", "-")
+
+        if not project_name:
+            continue
+
+        # 세션 파일(.jsonl) 개수 = 세션 수
+        session_files = list(project_dir.glob("*.jsonl"))
+        session_count = len(session_files)
+
+        # 첫/마지막 세션 시간 (파일 수정시간 기준)
+        first_seen = None
+        last_seen = None
+        if session_files:
+            mtimes = [f.stat().st_mtime for f in session_files]
+            first_seen = datetime.fromtimestamp(min(mtimes))
+            last_seen = datetime.fromtimestamp(max(mtimes))
+
+        projects.append(ProjectSummary(
+            name=project_name,
+            session_count=session_count,
+            first_seen=first_seen,
+            last_seen=last_seen,
+        ))
+
+    return sorted(projects, key=lambda p: p.session_count, reverse=True)
+
+
+def load_usage_data() -> UsageData:
+    """Load all usage data from local Claude Code files."""
+    hostname = get_hostname()
+    stats = parse_stats_cache()
+
+    if stats is None:
+        return UsageData(hostname=hostname)
+
+    daily_activity = [
+        DailyActivity(
+            date=d["date"],
+            message_count=d["messageCount"],
+            session_count=d["sessionCount"],
+            tool_call_count=d["toolCallCount"],
+        )
+        for d in stats.get("dailyActivity", [])
+    ]
+
+    daily_model_tokens = [
+        DailyModelTokens(
+            date=d["date"],
+            tokens_by_model=d["tokensByModel"],
+        )
+        for d in stats.get("dailyModelTokens", [])
+    ]
+
+    model_usage = [
+        ModelUsage(
+            model=model,
+            input_tokens=usage["inputTokens"],
+            output_tokens=usage["outputTokens"],
+            cache_read_tokens=usage["cacheReadInputTokens"],
+            cache_creation_tokens=usage["cacheCreationInputTokens"],
+        )
+        for model, usage in stats.get("modelUsage", {}).items()
+    ]
+
+    hour_counts = {int(k): v for k, v in stats.get("hourCounts", {}).items()}
+    projects = parse_projects()
+
+    return UsageData(
+        hostname=hostname,
+        daily_activity=daily_activity,
+        daily_model_tokens=daily_model_tokens,
+        model_usage=model_usage,
+        projects=projects,
+        hour_counts=hour_counts,
+        total_sessions=stats.get("totalSessions", 0),
+        total_messages=stats.get("totalMessages", 0),
+        first_session_date=stats.get("firstSessionDate"),
+    )

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: claude-multi-usage
+Version: 0.1.0
+Summary: Claude Code usage dashboard across multiple devices
+Author: nuhgnod
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hunknownn/claude-multi-usage
+Project-URL: Repository, https://github.com/hunknownn/claude-multi-usage
+Project-URL: Issues, https://github.com/hunknownn/claude-multi-usage/issues
+Keywords: claude,cli,dashboard,usage,anthropic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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 :: Libraries :: Python Modules
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Requires-Dist: click>=8.0
+Dynamic: license-file

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+claude_multi_usage/__init__.py
+claude_multi_usage/cli.py
+claude_multi_usage/dashboard.py
+claude_multi_usage/parser.py
+claude_multi_usage.egg-info/PKG-INFO
+claude_multi_usage.egg-info/SOURCES.txt
+claude_multi_usage.egg-info/dependency_links.txt
+claude_multi_usage.egg-info/entry_points.txt
+claude_multi_usage.egg-info/requires.txt
+claude_multi_usage.egg-info/top_level.txt

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-usage = claude_multi_usage.cli:main

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/requires.txt

@@ -0,0 +1,2 @@
+rich>=13.0
+click>=8.0

claude_multi_usage-0.1.0/claude_multi_usage.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+claude_multi_usage
+dist

claude_multi_usage-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-multi-usage"
+version = "0.1.0"
+description = "Claude Code usage dashboard across multiple devices"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+    { name = "nuhgnod" },
+]
+keywords = ["claude", "cli", "dashboard", "usage", "anthropic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "rich>=13.0",
+    "click>=8.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/hunknownn/claude-multi-usage"
+Repository = "https://github.com/hunknownn/claude-multi-usage"
+Issues = "https://github.com/hunknownn/claude-multi-usage/issues"
+
+[project.scripts]
+claude-usage = "claude_multi_usage.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]

claude_multi_usage-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+