agentop 0.2.0__tar.gz

agentop-0.2.0/LICENSE

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

agentop-0.2.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: agentop
+Version: 0.2.0
+Summary: A terminal UI tool for monitoring local AI coding agents (Claude Code, etc.)
+Author: Yuanhong Yu
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/dadwadw233/agentop
+Project-URL: Repository, https://github.com/dadwadw233/agentop
+Project-URL: Issues, https://github.com/dadwadw233/agentop/issues
+Keywords: ai,monitoring,tui,claude,agent
+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: Topic :: System :: Monitoring
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.88.0
+Requires-Dist: rich>=13.9.0
+Requires-Dist: psutil>=6.1.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: platformdirs>=4.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Dynamic: license-file
+
+# Agentop
+
+A terminal UI tool for monitoring local AI coding agents — like `nvtop`/`htop`, but for Claude/Codex.
+
+## Features
+
+- Real-time process monitoring (CPU, memory, uptime)
+- Claude Code usage + cost from local stats
+- Quota panels (beta) for Codex + Antigravity
+- Lightweight Textual TUI
+
+## Supported Agents
+
+| Agent | Process Monitor | Usage Stats | Quota | Status |
+|-------|----------------|-------------|-------|--------|
+| **Claude Code** | ✅ | ✅ | ✅ | Stable |
+| **Antigravity** | ⏳ | ⏳ | ✅ | Beta |
+| **OpenAI Codex** | ✅ | ✅ | ✅ | Beta |
+| **OpenCode** | ✅ | ✅ | ⏳ | Beta |
+
+## Supported Platforms (has been tested)
+
+- macOS
+- Linux
+
+## Installation (macOS / Linux)
+
+### PyPI
+```bash
+pip install agentop
+```
+
+### From source
+```bash
+pip install git+https://github.com/dadwadw233/agentop.git
+```
+
+## Quick Start
+
+```bash
+# TUI
+agentop
+
+# Or
+python3 -m agentop
+```
+
+Detailed stats:
+```bash
+python3 show_stats.py
+```
+
+## Data Sources
+
+- Claude stats: `~/.claude/stats-cache.json`
+- Codex usage/quota: `/usage` API via Codex auth (`~/.codex/auth.json`)
+- Antigravity quota: Google Cloud Code API via Antigravity auth (local state db)
+- OpenCode stats: `~/.local/share/opencode/storage/` (message + session directories)
+
+## Changelog
+
+### 0.2.0 (2026-01-25)
+
+**OpenCode Features:**
+- Fixed time filtering bug - now shows all historical data (not just today)
+- Added time range support (Today/Week/Month/All) for all views
+- Implemented lazy loading - only computes aggregates needed for current view
+- Added index cache for faster incremental parsing
+- Performance optimizations for large datasets
+
+**TUI Improvements:**
+- Redesigned overview dashboard with structured layout (Process Status, Session Stats, Token Usage)
+- Added progress bars for visual token usage comparison
+- Implemented pagination for handling large datasets
+- Dynamic page sizing based on available screen height
+- Enhanced table formatting with better alignment and smart truncation
+- Color gradients for usage intensity (cyan/magenta/blue)
+- Visual status indicators (🟢/⚪) with colored borders
+- Improved hint text with time range display and update timestamps
+- Consistent styling across all sub-views (Sessions, Projects, Models, Agents, Timeline)
+
+## Roadmap
+
+- More agents (TBD)
+- Config file (YAML)
+- History + export (CSV/JSON)
+- UI polish
+
+## Known Limitations
+
+- Claude stats can lag behind real time
+- Codex usage is fetched from the API (not local files)
+- Antigravity quota depends on account access
+- Antigravity refresh requires `ANTIGRAVITY_OAUTH_CLIENT_SECRET` or a fresh login
+- Proxy users: if you see “unknown scheme for proxy URL”, set `AGENTOP_DISABLE_PROXY=1` or install `httpx[socks]`
+
+## License
+
+MIT (see `LICENSE`)

agentop-0.2.0/README.md

@@ -0,0 +1,99 @@
+# Agentop
+
+A terminal UI tool for monitoring local AI coding agents — like `nvtop`/`htop`, but for Claude/Codex.
+
+## Features
+
+- Real-time process monitoring (CPU, memory, uptime)
+- Claude Code usage + cost from local stats
+- Quota panels (beta) for Codex + Antigravity
+- Lightweight Textual TUI
+
+## Supported Agents
+
+| Agent | Process Monitor | Usage Stats | Quota | Status |
+|-------|----------------|-------------|-------|--------|
+| **Claude Code** | ✅ | ✅ | ✅ | Stable |
+| **Antigravity** | ⏳ | ⏳ | ✅ | Beta |
+| **OpenAI Codex** | ✅ | ✅ | ✅ | Beta |
+| **OpenCode** | ✅ | ✅ | ⏳ | Beta |
+
+## Supported Platforms (has been tested)
+
+- macOS
+- Linux
+
+## Installation (macOS / Linux)
+
+### PyPI
+```bash
+pip install agentop
+```
+
+### From source
+```bash
+pip install git+https://github.com/dadwadw233/agentop.git
+```
+
+## Quick Start
+
+```bash
+# TUI
+agentop
+
+# Or
+python3 -m agentop
+```
+
+Detailed stats:
+```bash
+python3 show_stats.py
+```
+
+## Data Sources
+
+- Claude stats: `~/.claude/stats-cache.json`
+- Codex usage/quota: `/usage` API via Codex auth (`~/.codex/auth.json`)
+- Antigravity quota: Google Cloud Code API via Antigravity auth (local state db)
+- OpenCode stats: `~/.local/share/opencode/storage/` (message + session directories)
+
+## Changelog
+
+### 0.2.0 (2026-01-25)
+
+**OpenCode Features:**
+- Fixed time filtering bug - now shows all historical data (not just today)
+- Added time range support (Today/Week/Month/All) for all views
+- Implemented lazy loading - only computes aggregates needed for current view
+- Added index cache for faster incremental parsing
+- Performance optimizations for large datasets
+
+**TUI Improvements:**
+- Redesigned overview dashboard with structured layout (Process Status, Session Stats, Token Usage)
+- Added progress bars for visual token usage comparison
+- Implemented pagination for handling large datasets
+- Dynamic page sizing based on available screen height
+- Enhanced table formatting with better alignment and smart truncation
+- Color gradients for usage intensity (cyan/magenta/blue)
+- Visual status indicators (🟢/⚪) with colored borders
+- Improved hint text with time range display and update timestamps
+- Consistent styling across all sub-views (Sessions, Projects, Models, Agents, Timeline)
+
+## Roadmap
+
+- More agents (TBD)
+- Config file (YAML)
+- History + export (CSV/JSON)
+- UI polish
+
+## Known Limitations
+
+- Claude stats can lag behind real time
+- Codex usage is fetched from the API (not local files)
+- Antigravity quota depends on account access
+- Antigravity refresh requires `ANTIGRAVITY_OAUTH_CLIENT_SECRET` or a fresh login
+- Proxy users: if you see “unknown scheme for proxy URL”, set `AGENTOP_DISABLE_PROXY=1` or install `httpx[socks]`
+
+## License
+
+MIT (see `LICENSE`)

agentop-0.2.0/agentop/__init__.py

@@ -0,0 +1,5 @@
+"""Agentop - Terminal UI for monitoring AI coding agents."""
+
+__version__ = "0.1.2"
+__author__ = "Yuanhong Yu"
+__license__ = "MIT"

agentop-0.2.0/agentop/__main__.py

@@ -0,0 +1,13 @@
+"""Main entry point for Agentop."""
+
+from .ui.app import AgentopApp
+
+
+def main():
+    """Main entry point."""
+    app = AgentopApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

agentop-0.2.0/agentop/core/__init__.py

@@ -0,0 +1,23 @@
+"""Core modules for Agentop."""
+
+from .models import (
+    ProcessMetrics,
+    AgentMetrics,
+    ClaudeCodeMetrics,
+    OpenCodeTokenUsage,
+    OpenCodeMessage,
+    OpenCodeSession,
+    OpenCodeMetrics,
+)
+from .constants import AgentType
+
+__all__ = [
+    "ProcessMetrics",
+    "AgentMetrics",
+    "ClaudeCodeMetrics",
+    "OpenCodeTokenUsage",
+    "OpenCodeMessage",
+    "OpenCodeSession",
+    "OpenCodeMetrics",
+    "AgentType",
+]

agentop-0.2.0/agentop/core/constants.py

@@ -0,0 +1,80 @@
+"""Constants and enumerations."""
+
+from enum import Enum
+
+
+class AgentType(str, Enum):
+    """Supported agent types."""
+
+    CLAUDE_CODE = "claude_code"
+    COPILOT = "copilot"
+    CODEX = "codex"
+    OPENCODE = "opencode"
+
+
+# Process detection patterns
+AGENT_PATTERNS = {
+    AgentType.CLAUDE_CODE: {
+        "process_names": ["claude"],
+        "cmdline_patterns": [
+            r"\.local/bin/claude",
+            r"--model\s+claude-",
+        ],
+        "min_memory_mb": 50,
+    },
+    AgentType.CODEX: {
+        "process_names": ["codex"],
+        "cmdline_patterns": [
+            r"(?:^|/)codex(?:\s|$)",
+            r"\bopenai[-_ ]?codex\b",
+        ],
+        "min_memory_mb": 40,
+    },
+    AgentType.OPENCODE: {
+        "process_names": ["node"],
+        "cmdline_patterns": [
+            r"(?:^|/)node(?:\s+|$)",
+            r"\bopencode\b",
+        ],
+        "min_memory_mb": 100,
+    },
+}
+
+# Claude pricing (per 1M tokens)
+CLAUDE_PRICING = {
+    "claude-opus-4": {"input": 15.0, "output": 75.0},
+    "claude-sonnet-4": {"input": 3.0, "output": 15.0},
+    "claude-sonnet-3.5": {"input": 3.0, "output": 15.0},
+    "claude-haiku-4": {"input": 0.25, "output": 1.25},
+}
+
+# Default paths
+DEFAULT_CLAUDE_LOGS_DIR = "~/.claude-code/sessions/"
+DEFAULT_CODEX_STATS_FILES = [
+    "~/.codex/stats.json",
+    "~/.codex/usage.json",
+    "~/.codex/usage.jsonl",
+    "~/.openai/codex/stats.json",
+    "~/.openai/codex/usage.json",
+    "~/.openai/codex/usage.jsonl",
+    "~/.config/codex/stats.json",
+    "~/.config/codex/usage.json",
+    "~/.config/codex/usage.jsonl",
+    "~/.config/openai/codex/stats.json",
+    "~/.config/openai/codex/usage.json",
+    "~/.config/openai/codex/usage.jsonl",
+    "~/Library/Application Support/Codex/stats.json",
+    "~/Library/Application Support/OpenAI/Codex/stats.json",
+]
+DEFAULT_CODEX_LOGS_DIRS = [
+    "~/.codex/logs/",
+    "~/.codex/sessions/",
+    "~/.openai/codex/logs/",
+    "~/.openai/codex/sessions/",
+    "~/.config/codex/logs/",
+    "~/.config/codex/sessions/",
+    "~/Library/Application Support/Codex/logs/",
+    "~/Library/Application Support/Codex/sessions/",
+    "~/Library/Application Support/OpenAI/Codex/logs/",
+    "~/Library/Application Support/OpenAI/Codex/sessions/",
+]

agentop-0.2.0/agentop/core/models.py

@@ -0,0 +1,258 @@
+"""Data models for Agentop."""
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Optional, List
+from enum import Enum
+
+
+class ProcessStatus(str, Enum):
+    """Process status."""
+
+    RUNNING = "running"
+    SLEEPING = "sleeping"
+    IDLE = "idle"
+    ZOMBIE = "zombie"
+    STOPPED = "stopped"
+
+
+@dataclass
+class ProcessMetrics:
+    """Metrics for a single process."""
+
+    pid: int
+    name: str
+    cmdline: str
+    cpu_percent: float
+    memory_mb: float
+    memory_percent: float
+    num_threads: int
+    create_time: datetime
+    status: ProcessStatus
+
+    @property
+    def uptime(self) -> float:
+        """Return uptime in seconds."""
+        return (datetime.now() - self.create_time).total_seconds()
+
+
+@dataclass
+class TokenUsage:
+    """Token usage statistics."""
+
+    input_tokens: int = 0
+    output_tokens: int = 0
+
+    @property
+    def total_tokens(self) -> int:
+        """Total tokens used."""
+        return self.input_tokens + self.output_tokens
+
+
+@dataclass
+class OpenCodeTokenUsage:
+    """OpenCode-specific token usage statistics with cache and reasoning tokens."""
+
+    input_tokens: int = 0
+    output_tokens: int = 0
+    reasoning_tokens: int = 0
+    cache_read_tokens: int = 0
+    cache_write_tokens: int = 0
+
+    @property
+    def total_tokens(self) -> int:
+        """Total tokens used including reasoning and cache."""
+        return (
+            self.input_tokens
+            + self.output_tokens
+            + self.reasoning_tokens
+            + self.cache_read_tokens
+            + self.cache_write_tokens
+        )
+
+
+@dataclass
+class CostEstimate:
+    """Cost estimation."""
+
+    amount: float  # in USD
+    currency: str = "USD"
+
+
+@dataclass
+class RateLimitWindow:
+    """Rate limit window snapshot."""
+
+    used_percent: float
+    window_minutes: Optional[int] = None
+    resets_at: Optional[datetime] = None
+
+    @property
+    def remaining_percent(self) -> float:
+        """Percent remaining in this window."""
+        return max(0.0, 100.0 - self.used_percent)
+
+
+@dataclass
+class CreditsSnapshot:
+    """Credits snapshot."""
+
+    has_credits: bool
+    unlimited: bool
+    balance: Optional[str] = None
+
+
+@dataclass
+class RateLimitSnapshot:
+    """Rate limit snapshot with primary/secondary windows."""
+
+    primary: Optional[RateLimitWindow] = None
+    secondary: Optional[RateLimitWindow] = None
+    credits: Optional[CreditsSnapshot] = None
+    plan_type: Optional[str] = None
+    captured_at: Optional[datetime] = None
+
+
+@dataclass
+class AgentMetrics:
+    """Base metrics for any agent."""
+
+    agent_type: str
+    processes: List[ProcessMetrics] = field(default_factory=list)
+    is_active: bool = False
+    last_active: Optional[datetime] = None
+
+    @property
+    def total_cpu(self) -> float:
+        """Total CPU usage across all processes."""
+        return sum(p.cpu_percent for p in self.processes)
+
+    @property
+    def total_memory_mb(self) -> float:
+        """Total memory usage in MB."""
+        return sum(p.memory_mb for p in self.processes)
+
+    @property
+    def process_count(self) -> int:
+        """Number of processes."""
+        return len(self.processes)
+
+
+@dataclass
+class ClaudeCodeMetrics(AgentMetrics):
+    """Metrics specific to Claude Code."""
+
+    agent_type: str = "claude_code"
+
+    # Session info
+    active_sessions: int = 0
+    total_sessions_today: int = 0
+
+    # Token usage
+    tokens_today: TokenUsage = field(default_factory=TokenUsage)
+    tokens_this_month: TokenUsage = field(default_factory=TokenUsage)
+
+    # Cost
+    cost_today: CostEstimate = field(default_factory=lambda: CostEstimate(0.0))
+    cost_this_month: CostEstimate = field(default_factory=lambda: CostEstimate(0.0))
+
+    # Stats metadata
+    stats_last_updated: Optional[datetime] = None
+
+    # Rate limits (quota)
+    rate_limits: Optional[RateLimitSnapshot] = None
+    rate_limits_source: Optional[str] = None
+    rate_limits_error: Optional[str] = None
+
+
+@dataclass
+class CodexMetrics(AgentMetrics):
+    """Metrics specific to OpenAI Codex."""
+
+    agent_type: str = "codex"
+
+    # Session info
+    active_sessions: int = 0
+    total_sessions_today: int = 0
+
+    # Token usage
+    tokens_today: TokenUsage = field(default_factory=TokenUsage)
+    tokens_this_month: TokenUsage = field(default_factory=TokenUsage)
+
+    # Cost (optional if logs don't include pricing)
+    cost_today: Optional[CostEstimate] = None
+    cost_this_month: Optional[CostEstimate] = None
+
+    # Usage metadata
+    usage_source: Optional[str] = None
+
+    # Rate limits
+    rate_limits: Optional[RateLimitSnapshot] = None
+    rate_limits_source: Optional[str] = None
+    rate_limits_error: Optional[str] = None
+
+
+@dataclass
+class SessionData:
+    """Data from a single Claude Code session."""
+
+    session_id: str
+    start_time: datetime
+    end_time: Optional[datetime] = None
+    model: Optional[str] = None
+    tokens: TokenUsage = field(default_factory=TokenUsage)
+    cost: CostEstimate = field(default_factory=lambda: CostEstimate(0.0))
+    message_count: int = 0
+
+
+@dataclass
+class OpenCodeMessage:
+    """Data from a single OpenCode message."""
+
+    message_id: str
+    session_id: str
+    role: str
+    model_id: str
+    provider_id: str
+    agent: Optional[str] = None
+    project_path: Optional[str] = None
+    created_at: datetime = field(default_factory=datetime.now)
+    completed_at: Optional[datetime] = None
+    tokens: OpenCodeTokenUsage = field(default_factory=OpenCodeTokenUsage)
+
+
+@dataclass
+class OpenCodeSession:
+    """Data from a single OpenCode session."""
+
+    session_id: str
+    start_time: datetime
+    end_time: Optional[datetime] = None
+    model_id: Optional[str] = None
+    provider_id: Optional[str] = None
+    agent: Optional[str] = None
+    project_path: Optional[str] = None
+    tokens: OpenCodeTokenUsage = field(default_factory=OpenCodeTokenUsage)
+    message_count: int = 0
+
+
+@dataclass
+class OpenCodeMetrics(AgentMetrics):
+    """Metrics specific to OpenCode."""
+
+    agent_type: str = "opencode"
+
+    active_sessions: int = 0
+    total_sessions_today: int = 0
+
+    total_tokens: OpenCodeTokenUsage = field(default_factory=OpenCodeTokenUsage)
+    tokens_today: OpenCodeTokenUsage = field(default_factory=OpenCodeTokenUsage)
+
+    by_session: dict = field(default_factory=dict)
+    by_agent: dict = field(default_factory=dict)
+    by_model: dict = field(default_factory=dict)
+    by_provider: dict = field(default_factory=dict)
+    by_project: dict = field(default_factory=dict)
+    by_date: dict = field(default_factory=dict)
+
+    stats_last_updated: Optional[datetime] = None

agentop-0.2.0/agentop/monitors/__init__.py

@@ -0,0 +1,13 @@
+"""Process and agent monitoring modules."""
+
+from .process import ProcessMonitor
+from .claude_code import ClaudeCodeMonitor
+from .codex import CodexMonitor
+from .antigravity import AntigravityMonitor
+
+__all__ = [
+    "ProcessMonitor",
+    "ClaudeCodeMonitor",
+    "CodexMonitor",
+    "AntigravityMonitor",
+]