Open Source · MIT License

The AI-powered
development observer

Monitor codebases in real-time. Analyze changes with AI.
Auto-generate documentation. All from your terminal.

npm install -g @kreonyx/watcher-cli
npx @kreonyx/watcher-cli
git clone https://github.com/Rajaaditya-2207/Watcher_CLI.git
▦ Watcher ─ □ × 
██╗    ██╗ █████╗ ████████╗ ██████╗██╗  ██╗███████╗██████╗
██║    ██║██╔══██╗╚══██╔══╝██╔════╝██║  ██║██╔════╝██╔══██╗
██║ █╗ ██║███████║   ██║   ██║     ███████║█████╗  ██████╔╝
██║███╗██║██╔══██║   ██║   ██║     ██╔══██║██╔══╝  ██╔══██╗
╚███╔███╔╝██║  ██║   ██║   ╚██████╗██║  ██║███████╗██║  ██║
 ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝    ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
Silent Observer. Intelligent Documentation.
v0.1.0 | Team KREONYX
Project: MyProject
E:\Projects\MyProject
Provider: bedrock Model: claude-sonnet-4.6
Type a message or press / for commands
/quit Exit Watcher
/config edit Change provider, model, or API key
/clear Clear chat history
/session new Start a new chat session
/session list List all saved sessions
/search Search project source files
/report Generate project status report
/insights Development analytics
/status Show git repository status
█
Status Dashboard
Project MyProject
main
Session 3/9/2026, 12:51 am
Changes: 0
Analyses: 0
Tokens: 0
Est Cost: ~$0.0000
AI Provider bedrock
claude-4.6-sonnet
Features Auto Docs: On
Recent Activity:
Activity 12:51 am ✓ Monitor active
Watcher  claude-sonnet-4.6  bedrock    / cmds  ctrl+n new  ctrl+a sessions  ctrl+l clear  ctrl+c quit

What is Watcher?

Your silent technical writer

Watcher monitors your codebase in real-time, analyzes every change using AI, and auto-generates documentation. It runs entirely in your terminal — no browser, no cloud dashboard. Just a powerful CLI that understands your code.

Features

Everything you need, nothing you don't

Real-time Monitoring

Watches your entire project tree for changes with configurable ignore patterns.

AI-Powered Analysis

Semantic code analysis via AWS Bedrock, OpenRouter, or Groq. Understands what your changes mean.

Auto Documentation

Generates PROGRESS.md and CHANGELOG.md automatically from your code changes.

Interactive Chat

Ask questions about your codebase. The AI agent uses tools to inspect files, git, and shell.

Multi-Provider

AWS Bedrock, OpenRouter (Claude, GPT-4, Gemini), and Groq. Bring your own API key.

Analytics Dashboard

Velocity metrics, file hotspots, technical debt tracking, and development timelines.

Terminal-Native TUI

Beautiful Ink + React terminal UI with mouse scroll, slash commands, and keyboard navigation.

Encrypted Credentials

API keys stored with AES-256-CBC encryption using machine-specific keys.

Slash Commands

Your toolkit, built in

/config editInteractive config editor
/search <pattern>Search project files
/reportGenerate status report
/insightsDevelopment analytics
/watchToggle file monitoring
/session newStart new chat session
/daemon startBackground monitoring
/diffView git changes

Security

Built for privacy first

Watcher runs entirely on your machine. Your code never leaves your computer. API keys are encrypted with AES-256-CBC using machine-specific keys derived from your hostname and username. No telemetry. No cloud. No tracking.

  • ✓ BYOK — Bring Your Own Key
  • ✓ AES-256-CBC encrypted credential storage
  • ✓ No data transmitted to third parties
  • ✓ Machine-specific encryption keys
  • ✓ Open source — audit the code yourself
🔒
3
AI Providers
75+
Models Supported
20+
Slash Commands
~165kb
Bundle Size

FAQ

Frequently asked questions

What is Watcher?

Watcher is a CLI-based development observer that monitors your codebase in real-time, analyzes changes using AI, and auto-generates documentation like PROGRESS.md and CHANGELOG.md.

How do I install it?

Run npm install -g @kreonyx/watcher-cli and then type watcher in any project directory. The first-run wizard will guide you through setup.

Do I need an AI subscription?

Yes, you need an API key from one of the supported providers: AWS Bedrock, OpenRouter, or Groq. Watcher uses a BYOK (Bring Your Own Key) model — no built-in API costs.

Which AI models are supported?

Through OpenRouter: Claude, GPT-4, Gemini, Llama, and 70+ more. Through Groq: fast Llama inference. Through AWS Bedrock: any model enabled in your Bedrock console.

Is my code sent to the cloud?

Only the code diffs are sent to your chosen AI provider for analysis. Watcher itself stores nothing in the cloud. All data stays on your machine.

Does it work on Windows?

Yes. Watcher works on Windows, macOS, and Linux. The TUI uses ASCII-only strings for full Windows CMD/PowerShell compatibility.

Is it open source?

Yes, Watcher is fully open source under the MIT License. You can audit, fork, and contribute to the code on GitHub.

How much does it cost?

Watcher is free. You only pay for AI API usage from your chosen provider (OpenRouter, Groq, or AWS Bedrock).

Ready to start?

Install Watcher and let AI document your code.

npm install -g @kreonyx/watcher-cli
View on GitHub View on npm