claude-code-monitor 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.4] - 2026-01-18
+
+### Fixed
+
+- Use alternate screen buffer to prevent TUI stacking on re-render ([#5](https://github.com/onikan27/claude-code-monitor/pull/5)) by [@msdjzmst](https://github.com/msdjzmst)
+
+## [1.0.3] - 2026-01-17
+
+### Changed
+
+- Update README: Add macOS-only badge and note, rename demo gif
+
 ## [1.0.2] - 2026-01-17
 
 ### Fixed

package/README.md

@@ -2,11 +2,12 @@
 
 [![npm version](https://img.shields.io/npm/v/claude-code-monitor.svg)](https://www.npmjs.com/package/claude-code-monitor)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![macOS](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
 
-A CLI tool to monitor multiple Claude Code sessions in real-time from your terminal.
+**A CLI tool to monitor multiple Claude Code sessions in real-time from your terminal.**
 
 <p align="center">
-  <img src="docs/demo.gif" alt="Claude Code Monitor Demo" width="1000">
+  <img src="https://raw.githubusercontent.com/onikan27/claude-code-monitor/main/docs/ccm-demo.gif" alt="Claude Code Monitor Demo" width="1000">
 </p>
 
 ---
@@ -43,6 +44,8 @@ A CLI tool to monitor multiple Claude Code sessions in real-time from your termi
 
 ## 📋 Requirements
 
+> **Note**: This tool is **macOS only** due to its use of AppleScript for terminal focus features.
+
 - **macOS** (focus feature is macOS only)
 - **Node.js** >= 18.0.0
 - **Claude Code** installed

package/dist/bin/ccm.js

@@ -11,7 +11,9 @@ import { clearSessions, getSessions } from '../store/file-store.js';
 import { getStatusDisplay } from '../utils/status.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
-const CLEAR_SCREEN = '\x1B[2J\x1B[0f';
+// Alternate screen buffer escape sequences
+const ENTER_ALT_SCREEN = '\x1b[?1049h\x1b[H';
+const EXIT_ALT_SCREEN = '\x1b[?1049l';
 /**
  * Get TTY from ancestor processes
  */
@@ -42,6 +44,19 @@ function getTtyFromAncestors() {
     }
     return undefined;
 }
+/**
+ * Run TUI with alternate screen buffer
+ */
+async function runWithAltScreen(renderFn) {
+    process.stdout.write(ENTER_ALT_SCREEN);
+    const { waitUntilExit } = renderFn();
+    try {
+        await waitUntilExit();
+    }
+    finally {
+        process.stdout.write(EXIT_ALT_SCREEN);
+    }
+}
 const program = new Command();
 program
     .name('ccm')
@@ -51,10 +66,8 @@ program
     .command('watch')
     .alias('w')
     .description('Start the monitoring TUI')
-    .action(() => {
-    process.stdout.write(CLEAR_SCREEN);
-    const { waitUntilExit } = render(_jsx(Dashboard, {}));
-    waitUntilExit().catch(console.error);
+    .action(async () => {
+    await runWithAltScreen(() => render(_jsx(Dashboard, {})));
 });
 program
     .command('hook <event>')
@@ -115,9 +128,7 @@ async function defaultAction() {
         console.log('');
     }
     // Launch monitor
-    process.stdout.write(CLEAR_SCREEN);
-    const { waitUntilExit } = render(_jsx(Dashboard, {}));
-    await waitUntilExit();
+    await runWithAltScreen(() => render(_jsx(Dashboard, {})));
 }
 // Default action when executed without commands
 if (process.argv.length === 2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-monitor",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "CLI for monitoring multiple Claude Code sessions in real-time",
   "type": "module",
   "main": "dist/index.js",