# Session Watcher

> A local monitor that estimates when carrying an existing agent context becomes more expensive than rebuilding it, for Claude Code and DeepSeek Harness (DSH).

Session Watcher provides restart-cost metrics and handoff tooling for long-running coding sessions, and shows the readings in a dashboard and a statusline under Claude Code and in a tab and a composer dock under DSH. It installs as a Claude Code plugin or as a DSH plugin.

Demo: `npx -y @nomadop/session-watcher demo`

## Documentation

- [Concepts](https://nomadop.github.io/session-watcher/docs/concepts.md): User-visible metrics: position, rate, cost, operations, and structure quantities.
- [Cookbook](https://nomadop.github.io/session-watcher/docs/cookbook.md): Operational guidance for interpreting lamps, restarting, and handoffs.
- [How It Works](https://nomadop.github.io/session-watcher/docs/how-it-works.md): Logical pipeline, lifecycle, and why the design produces correct results.
- [Guarantees](https://nomadop.github.io/session-watcher/docs/guarantees.md): Stable externally-observable behavior: folding, segmentation, baseline, and gate rules.
- [DSH Plugin](https://nomadop.github.io/session-watcher/docs/dsh.md): Session Watcher inside DeepSeek Harness: install, what is watched, the tab and the composer dock, the supported surface, tools and skills, Turn Notes, handoff across hosts, and replaying a session log.

## Project

- [Repository](https://github.com/nomadop/session-watcher): Source code, issues, releases.
- [npm Package](https://www.npmjs.com/package/@nomadop/session-watcher): Published package.
- [Paper](https://doi.org/10.5281/zenodo.21236704): Cost-model derivation and empirical motivation.

## Optional

- [Complete Documentation](https://nomadop.github.io/session-watcher/llms-full.txt): All public documentation concatenated into one context file.