ccburn 0.1.4

package/LICENSE

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

@@ -0,0 +1,51 @@
+# ccburn
+
+Terminal-based Claude Code usage limit visualizer with real-time burn-up charts.
+
+## Installation
+
+```bash
+# Run directly with npx
+npx ccburn
+
+# Or install globally
+npm install -g ccburn
+```
+
+## Usage
+
+```bash
+ccburn              # Session limit TUI
+ccburn weekly       # Weekly limit
+ccburn --compact    # Single line for status bars
+ccburn --json       # JSON output for automation
+```
+
+## Features
+
+- **Real-time burn-up charts** with budget pace line
+- **Pace indicators**: 🧊 behind pace, 🔥 on pace, 🚨 burning too hot
+- **Session, Weekly, and Weekly-Sonnet limits**
+- **Compact mode** for tmux/status bars
+- **JSON output** for scripting
+
+## Requirements
+
+- Claude Code installed with valid credentials
+
+## Alternative Installation
+
+If npm installation fails, you can install via pip:
+
+```bash
+pip install ccburn
+```
+
+## Links
+
+- [GitHub](https://github.com/JuanjoFuchs/ccburn)
+- [PyPI](https://pypi.org/project/ccburn/)
+
+## License
+
+MIT

package/bin/ccburn.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const binDir = path.join(__dirname);
+const platform = process.platform;
+const ext = platform === 'win32' ? '.exe' : '';
+
+// Find the binary
+const binaryName = fs.readdirSync(binDir).find(f =>
+  f.startsWith('ccburn-') && f.endsWith(ext) && !f.endsWith('.js')
+);
+
+if (!binaryName) {
+  console.error('Error: ccburn binary not found. Try reinstalling: npm install -g ccburn');
+  process.exit(1);
+}
+
+const binaryPath = path.join(binDir, binaryName);
+
+// Spawn the binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  windowsHide: true
+});
+
+child.on('error', (err) => {
+  console.error(`Error executing ccburn: ${err.message}`);
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "ccburn",
+  "version": "0.1.4",
+  "description": "Terminal-based Claude Code usage limit visualizer with real-time burn-up charts",
+  "author": "JuanjoFuchs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JuanjoFuchs/ccburn.git"
+  },
+  "homepage": "https://github.com/JuanjoFuchs/ccburn#readme",
+  "bugs": {
+    "url": "https://github.com/JuanjoFuchs/ccburn/issues"
+  },
+  "keywords": [
+    "claude",
+    "anthropic",
+    "usage",
+    "monitoring",
+    "tui",
+    "cli",
+    "terminal",
+    "burn-up",
+    "chart"
+  ],
+  "bin": {
+    "ccburn": "./bin/ccburn.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,106 @@
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const REPO = 'JuanjoFuchs/ccburn';
+const PACKAGE_VERSION = require('../package.json').version;
+
+const PLATFORM_MAP = {
+  'win32-x64': 'windows-x64.exe',
+  'linux-x64': 'linux-x64',
+  'darwin-x64': 'darwin-x64',
+  'darwin-arm64': 'darwin-arm64'
+};
+
+async function main() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const key = `${platform}-${arch}`;
+
+  const suffix = PLATFORM_MAP[key];
+  if (!suffix) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported platforms: win32-x64, linux-x64, darwin-x64, darwin-arm64');
+    console.error('');
+    console.error('You can still use ccburn via pip: pip install ccburn');
+    process.exit(1);
+  }
+
+  const binaryName = `ccburn-${PACKAGE_VERSION}-${suffix}`;
+  const url = `https://github.com/${REPO}/releases/download/v${PACKAGE_VERSION}/${binaryName}`;
+  const binDir = path.join(__dirname, '..', 'bin');
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Skip if binary already exists
+  if (fs.existsSync(binaryPath)) {
+    console.log(`ccburn binary already exists at ${binaryPath}`);
+    return;
+  }
+
+  console.log(`Downloading ccburn ${PACKAGE_VERSION} for ${platform}-${arch}...`);
+  console.log(`URL: ${url}`);
+
+  try {
+    await downloadFile(url, binaryPath);
+
+    // Make executable on Unix
+    if (platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`Successfully installed ccburn to ${binaryPath}`);
+  } catch (err) {
+    console.error(`Failed to download ccburn: ${err.message}`);
+    console.error('');
+    console.error('You can still use ccburn via pip: pip install ccburn');
+    process.exit(1);
+  }
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    const request = (url) => {
+      https.get(url, (response) => {
+        // Handle redirects (GitHub releases use redirects)
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          request(response.headers.location);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          fs.unlinkSync(dest);
+          reject(new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`));
+          return;
+        }
+
+        const totalBytes = parseInt(response.headers['content-length'], 10);
+        let downloadedBytes = 0;
+
+        response.on('data', (chunk) => {
+          downloadedBytes += chunk.length;
+          if (totalBytes) {
+            const percent = Math.round((downloadedBytes / totalBytes) * 100);
+            process.stdout.write(`\rDownloading: ${percent}%`);
+          }
+        });
+
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close();
+          console.log(''); // New line after progress
+          resolve();
+        });
+      }).on('error', (err) => {
+        fs.unlinkSync(dest);
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+main().catch(console.error);