Skip to content

docs: update README with npm badge, installation, and project status #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
evansantos merged 2 commits into from
Feb 19, 2026
Merged

docs: update README with npm badge, installation, and project status #21

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d5e8415
docs: update README with npm badge, installation, and project status
evansantos Feb 19, 2026
774422c
fix: remove hardcoded test count from README
evansantos Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 33 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,31 @@
# SlimClaw 🦞

Token optimization plugin for OpenClaw. Tracks cache hits, measures savings, and provides real-time metrics.
[![npm version](https://img.shields.io/npm/v/slimclaw)](https://www.npmjs.com/package/slimclaw)
[![CI](https://github.com/evansantos/slimclaw/actions/workflows/ci.yml/badge.svg)](https://github.com/evansantos/slimclaw/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Token optimization plugin for OpenClaw. Tracks cache hits, measures savings, provides real-time metrics, and integrates intelligent model routing via [ClawRouter](https://github.com/BlockRunAI/clawrouter).

**0 vulnerabilities** · **Node 22+**

## Features

- **Metrics Tracking** — Input/output tokens, cache reads/writes, estimated savings
- **Cache Breakpoint Injection** — Optimizes Anthropic's prompt caching
- **Intelligent Model Routing** — Hybrid ClawRouter + heuristic classification for cost optimization
- **Dashboard** — Dark theme web UI at `http://localhost:3333`
- **Shadow Mode** — Measures without modifying requests (safe to run)

## Installation

### From npm

```bash
npm install slimclaw
```

### From source

```bash
git clone https://github.com/evansantos/slimclaw ~/.openclaw/plugins/slimclaw
cd ~/.openclaw/plugins/slimclaw
Expand Down Expand Up @@ -164,9 +179,24 @@ Override default model pricing in `slimclaw.config.json` to keep costs accurate

> **Note:** `@blockrun/clawrouter` pulls `viem` as a transitive dependency (~50 packages). This doesn't affect functionality but adds to `node_modules` size. See [BlockRunAI/clawrouter#1](https://github.com/BlockRunAI/clawrouter/issues/1) for tracking.

## Coming Soon
## Status

- **Active Mode** — Actually apply optimizations (pending OpenClaw hook mutation support)
- **v0.1.0** published on [npm](https://www.npmjs.com/package/slimclaw)
- **Observation mode** — routing classifies and logs recommendations without mutating model selection
- **Active mode blocked** — waiting for OpenClaw `historyMessages` mutation support ([#20416](https://github.com/openclaw/openclaw/issues/20416))
- **9 open issues** — see [issues](https://github.com/evansantos/slimclaw/issues)
- **8 PRs merged** — including ClawRouter integration, routing classification, GitSniff fixes

## Contributing

PRs welcome! The project uses branch protection — all changes go through PR with CI + [GitSniff](https://gitsniff.ai) review.
Copy link
Copy Markdown

@gitsniff gitsniff bot Feb 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ Info

The mention of 'GitSniff review' is ambiguous. While it accurately describes the current review process, it might not be clear to external contributors what GitSniff is or how it functions within the PR workflow. This could lead to confusion about the review expectations.

Fix: Consider briefly explaining GitSniff's role (e.g., 'automated AI code review') or linking to its documentation if available. This provides clarity for new contributors and maintains transparency in the review process.

Suggested change
PRs welcome! The project uses branch protection — all changes go through PR with CI + [GitSniff](https://gitsniff.ai) review.
PRs welcome! The project uses branch protection — all changes go through PR with CI + automated AI code review by [GitSniff](https://gitsniff.ai).


```bash
git clone https://github.com/evansantos/slimclaw
cd slimclaw
npm install
npm test
```

## License

Expand Down