___           ___           ___           ___                       ___
     /\  \         /\__\         /\  \         /\__\          ___        /\  \
    /::\  \       /:/  /        /::\  \       /:/  /         /\  \      /::\  \
   /:/\:\  \     /:/  /        /:/\:\  \     /:/  /          \:\  \    /:/\ \  \
  /:/  \:\  \   /:/  /        /::\~\:\  \   /:/__/  ___      /::\__\  _\:\~\ \  \
 /:/__/ \:\__\ /:/__/        /:/\:\ \:\__\  |:|  | /\__\  __/:/\/__/ /\ \:\ \ \__\
 \:\  \  \/__/ \:\  \        \/__\:\/:/  /  |:|  |/:/  / /\/:/  /    \:\ \:\ \/__/
  \:\  \        \:\  \            \::/  /   |:|__/:/  /  \::/__/      \:\ \:\__\
   \:\  \        \:\  \           /:/  /     \::::/__/    \:\__\       \:\/:/  /
    \:\__\        \:\__\         /:/  /       ~~~~         \/__/        \::/  /
     \/__/         \/__/         \/__/                                   \/__/

clavis

Powerful enhancements for Claude Code — unlock the full potential of your AI coding assistant.

Installation

One-time use (no install needed)

npx @sriram-rach/clavis

Global install

npm install -g @sriram-rach/clavis

Then run clavis in any repo.

Local install (per-project)

npm install --save-dev @sriram-rach/clavis

Then run via npx or add it to your npm scripts:

{
  "scripts": {
    "setup-claude": "clavis"
  }
}

Features

Context Usage Statusline

A real-time statusline that shows you the active model, current task, working directory, session time, and context usage at a glance — with a color-coded progress bar that shifts from green to red as context fills up.

Auto-Update

Clavis automatically checks for updates at the start of each Claude Code session and silently updates the statusline hook in the background — no manual intervention needed.

How It Works

Running npx @sriram-rach/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:

rm .claude/hooks/statusline.js

Then remove the "statusLine" key from .claude/settings.json.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT — see the LICENSE file for details.