tmux-agent-monitor 0.0.1 → 0.0.3

package/LICENSE

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

package/README.md

@@ -1,45 +1,114 @@
 # tmux-agent-monitor
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Monitor tmux sessions from a mobile-friendly web UI with a single CLI. Designed for Codex CLI and Claude Code sessions running inside tmux.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Features
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+- Live session list and activity state
+- Screen capture (text + optional image capture on macOS terminals)
+- Token-based access with optional static auth
+- Read-only mode and rate limits
+- QR code login on startup (when terminal height permits)
+- Claude hooks helper CLI for event logging
 
-## Purpose
+## Requirements
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `tmux-agent-monitor`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+- Node.js 24+
+- tmux 2.0+ (a running tmux server is required)
+- macOS is required for image capture (uses `osascript`/`screencapture`). Other OSes are text-only.
+- On macOS, Screen Recording and Accessibility permissions may be required.
 
-## What is OIDC Trusted Publishing?
+## Install
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+```bash
+npm install -g tmux-agent-monitor
+```
 
-## Setup Instructions
+## Quick start
 
-To properly configure OIDC trusted publishing for this package:
+```bash
+tmux-agent-monitor
+```
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+The command prints a URL like (and a QR code when possible):
 
-## DO NOT USE THIS PACKAGE
+```
+tmux-agent-monitor: http://localhost:11080/?token=...
+```
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+Open that URL in a browser to access the UI.
 
-## More Information
+Recommended access methods:
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+- SSH port-forward
+- Tailscale
+- Private LAN only (avoid exposing to the public internet)
 
----
+## CLI options
 
-**Maintained for OIDC setup purposes only**
+```
+--public        Bind to 0.0.0.0 instead of 127.0.0.1
+--tailscale     Use the Tailscale IP when printing the URL
+--no-attach     Do not auto-attach tmux panes
+--port <port>   Override the server port
+--web-port <p>  Override the displayed web port in the printed URL
+--socket-name   tmux socket name
+--socket-path   tmux socket path
+```
+
+Rotate the auth token:
+
+```bash
+tmux-agent-monitor token rotate
+```
+
+## Configuration
+
+Config is stored at `~/.tmux-agent-monitor/config.json`. It is created automatically on first run.
+
+Example (use Alacritty for image capture):
+
+```json
+{
+  "screen": {
+    "image": {
+      "backend": "alacritty"
+    }
+  }
+}
+```
+
+Supported image backends:
+`alacritty`, `terminal`, `iterm`, `wezterm`, `ghostty`
+
+Security defaults:
+
+- Token auth is required for API/WebSocket access
+- Default bind is `127.0.0.1` (`--public` is opt-in)
+
+## Claude hooks helper
+
+The repo includes a small hook logger CLI:
+
+```bash
+tmux-agent-monitor-hook <HookEventName>
+```
+
+To print a Claude hooks snippet:
+
+```bash
+tmux-agent-monitor claude hooks print
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Build the distributable package:
+
+```bash
+pnpm build
+```

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,29 @@
+# Third-Party Notices
+
+This project includes or references components under the following license(s).
+
+---
+
+## claude-code-monitor
+
+MIT License
+
+Copyright (c) 2026 onikan27
+
+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.