@sriram-rach/clavis 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sriram Rachamadugu
+
+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,109 @@
+```
+      ___           ___           ___           ___                       ___
+     /\  \         /\__\         /\  \         /\__\          ___        /\  \
+    /::\  \       /:/  /        /::\  \       /:/  /         /\  \      /::\  \
+   /:/\:\  \     /:/  /        /:/\:\  \     /:/  /          \:\  \    /:/\ \  \
+  /:/  \:\  \   /:/  /        /::\~\:\  \   /:/__/  ___      /::\__\  _\:\~\ \  \
+ /:/__/ \:\__\ /:/__/        /:/\:\ \:\__\  |:|  | /\__\  __/:/\/__/ /\ \:\ \ \__\
+ \:\  \  \/__/ \:\  \        \/__\:\/:/  /  |:|  |/:/  / /\/:/  /    \:\ \:\ \/__/
+  \:\  \        \:\  \            \::/  /   |:|__/:/  /  \::/__/      \:\ \:\__\
+   \:\  \        \:\  \           /:/  /     \::::/__/    \:\__\       \:\/:/  /
+    \:\__\        \:\__\         /:/  /       ~~~~         \/__/        \::/  /
+     \/__/         \/__/         \/__/                                   \/__/
+```
+
+# clavis
+
+> Powerful enhancements for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — unlock the full potential of your AI coding assistant.
+
+[![npm version](https://img.shields.io/npm/v/clavis.svg)](https://www.npmjs.com/package/clavis)
+[![license](https://img.shields.io/npm/l/clavis.svg)](https://github.com/sriram-rachamadugu/clavis/blob/main/LICENSE)
+
+## Installation
+
+### One-time use (no install needed)
+
+```bash
+npx clavis
+```
+
+### Global install
+
+```bash
+npm install -g clavis
+```
+
+Then run `clavis` in any repo.
+
+### Local install (per-project)
+
+```bash
+npm install --save-dev clavis
+```
+
+Then run via npx or add it to your npm scripts:
+
+```json
+{
+  "scripts": {
+    "setup-claude": "clavis"
+  }
+}
+```
+
+## Features
+
+### Context Usage Statusline
+
+A real-time statusline that keeps you informed while Claude works:
+
+- **Model** — which Claude model is active
+- **Current task** — the in-progress task from your todo list
+- **Directory** — current working directory
+- **Context usage** — a 10-segment progress bar with color coding
+
+#### Context bar colors
+
+| Usage   | Color            |
+|---------|------------------|
+| < 50%   | Green            |
+| 50–65%  | Yellow           |
+| 65–80%  | Orange           |
+| > 80%   | Red (blinking)   |
+
+*More features coming soon.*
+
+## How It Works
+
+Running `npx clavis` in your repo root will:
+
+1. Create `.claude/hooks/statusline.js` — the statusline hook
+2. Add a `statusLine` entry to `.claude/settings.json` — tells Claude Code to use it
+
+It's idempotent — running it again skips the settings update if already configured.
+
+## Uninstall
+
+Delete the hook and remove the settings entry:
+
+```bash
+rm .claude/hooks/statusline.js
+```
+
+Then remove the `"statusLine"` key from `.claude/settings.json`.
+
+## Versioning
+
+This project follows [Semantic Versioning](https://semver.org/):
+
+- **MAJOR** — breaking changes to CLI behavior or hook API
+- **MINOR** — new features (backwards-compatible)
+- **PATCH** — bug fixes and minor improvements
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+[MIT](LICENSE) — see the [LICENSE](LICENSE) file for details.

package/bin/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Clavis installer — sets up Claude Code context statusline in the current repo
+
+const fs = require('fs');
+const path = require('path');
+
+const cwd = process.cwd();
+const claudeDir = path.join(cwd, '.claude');
+const hooksDir = path.join(claudeDir, 'hooks');
+const hookDest = path.join(hooksDir, 'statusline.js');
+const settingsPath = path.join(claudeDir, 'settings.json');
+
+const hookSrc = path.join(__dirname, '..', 'hook', 'statusline.js');
+
+const statusLineConfig = {
+  type: 'command',
+  command: 'node .claude/hooks/statusline.js'
+};
+
+// 1. Ensure .claude/hooks/ exists
+fs.mkdirSync(hooksDir, { recursive: true });
+
+// 2. Copy statusline hook
+fs.copyFileSync(hookSrc, hookDest);
+console.log('  Copied statusline hook to .claude/hooks/statusline.js');
+
+// 3. Merge statusLine into settings.json
+let settings = {};
+if (fs.existsSync(settingsPath)) {
+  try {
+    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  } catch (e) {
+    console.log('  Warning: could not parse existing settings.json, creating fresh');
+    settings = {};
+  }
+}
+
+if (settings.statusLine) {
+  console.log('  statusLine already configured in settings.json — skipped');
+} else {
+  settings.statusLine = statusLineConfig;
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+  console.log('  Added statusLine config to .claude/settings.json');
+}
+
+// 4. Success message
+console.log();
+console.log('  \x1b[32m✓\x1b[0m Clavis installed!');
+console.log();
+console.log('  Preview:');
+console.log(`  \x1b[2mClaude Opus 4.6\x1b[0m │ \x1b[2myour-repo\x1b[0m \x1b[32m██░░░░░░░░ 20%\x1b[0m`);
+console.log();
+console.log('  The statusline will appear at the bottom of Claude Code.');

package/hook/statusline.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+// Clavis — Claude Code context usage statusline
+// Shows: model | current task | directory | context usage bar
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+
+    // Context window bar (shows USED percentage)
+    let ctx = '';
+    if (remaining != null) {
+      const used = Math.max(0, Math.min(100, 100 - Math.round(remaining)));
+      const filled = Math.floor(used / 10);
+      const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(10 - filled);
+
+      if (used < 50) {
+        ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
+      } else if (used < 65) {
+        ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
+      } else if (used < 80) {
+        ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
+      } else {
+        ctx = ` \x1b[5;31m\uD83D\uDC80 ${bar} ${used}%\x1b[0m`;
+      }
+    }
+
+    // Current task from todos
+    let task = '';
+    const homeDir = os.homedir();
+    const todosDir = path.join(homeDir, '.claude', 'todos');
+    if (session && fs.existsSync(todosDir)) {
+      const files = fs.readdirSync(todosDir)
+        .filter(f => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+        .map(f => ({ name: f, mtime: fs.statSync(path.join(todosDir, f)).mtime }))
+        .sort((a, b) => b.mtime - a.mtime);
+
+      if (files.length > 0) {
+        try {
+          const todos = JSON.parse(fs.readFileSync(path.join(todosDir, files[0].name), 'utf8'));
+          const inProgress = todos.find(t => t.status === 'in_progress');
+          if (inProgress) task = inProgress.activeForm || '';
+        } catch (e) {}
+      }
+    }
+
+    // Output
+    const dirname = path.basename(dir);
+    if (task) {
+      process.stdout.write(`\x1b[2m${model}\x1b[0m \u2502 \x1b[1m${task}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`);
+    } else {
+      process.stdout.write(`\x1b[2m${model}\x1b[0m \u2502 \x1b[2m${dirname}\x1b[0m${ctx}`);
+    }
+  } catch (e) {
+    // Silent fail — don't break statusline on parse errors
+  }
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@sriram-rach/clavis",
+  "version": "1.0.0",
+  "description": "Powerful enhancements for Claude Code — unlock the full potential of your AI coding assistant",
+  "bin": {
+    "clavis": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "hook/",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "statusline",
+    "context-window",
+    "cli",
+    "developer-tools",
+    "ai",
+    "productivity"
+  ],
+  "license": "MIT",
+  "author": "Sriram Rachamadugu",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sriram-rachamadugu/clavis"
+  },
+  "bugs": {
+    "url": "https://github.com/sriram-rachamadugu/clavis/issues"
+  },
+  "homepage": "https://github.com/sriram-rachamadugu/clavis#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}