Skip to content
This repository was archived by the owner on Mar 31, 2026. It is now read-only.

Jason-Vaughan/CLiTS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

132 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLiTS Logo

CLiTS (Chrome Log Inspector & Troubleshooting System)

npm version License: BSD

DEPRECATED — This project is no longer maintained. The browser automation landscape has evolved significantly since CLiTS was last actively developed, and several mature alternatives now exist that cover CLiTS's functionality and more.

Recommended Alternatives

Tool Best For Link
Playwright MCP AI agent browser control via accessibility snapshots github.com/microsoft/playwright-mcp
Chrome DevTools MCP Browser debugging and performance insights for AI developer.chrome.com/blog/chrome-devtools-mcp
Stagehand (Browserbase) AI-driven element interaction with CDP github.com/browserbase/stagehand
agent-browser (Vercel) Token-efficient CLI browser automation for AI agents github.com/vercel-labs/agent-browser
browser-use Full autonomous AI browsing agent github.com/browser-use/browser-use
AgentQL AI-powered natural language element selection agentql.com

What CLiTS Was

CLiTS was a Node.js CLI and library for AI-controlled Chrome browser automation, debugging, and inspection. It connected directly to Chrome via the DevTools Protocol (CDP) and provided:

  • Console log and network request extraction
  • React hook, Redux state, and GraphQL monitoring
  • Element discovery and interaction (CSS, XPath, text, color, region)
  • Screenshot capture with annotations and visual diffing
  • JSON automation scripts for repeatable workflows
  • AI-friendly structured output with recovery suggestions

Why It's Being Archived

The browser automation ecosystem moved fast between 2025-2026:

  • MCP became the standard for connecting AI agents to browsers. CLiTS predates MCP and never adopted it.
  • AI-driven selectors (Stagehand, AgentQL) replaced CSS/XPath discovery with more resilient approaches.
  • Accessibility snapshots (Playwright MCP) proved more reliable than DOM-based element finding.
  • Token efficiency became a first-class concern that CLiTS never optimized for.
  • Major players (Microsoft, Google, Vercel, Browserbase) invested heavily in this space with dedicated teams.

CLiTS solved a real problem when it was built. The ecosystem caught up and surpassed it.

Historical Documentation

The documentation below is preserved for reference but is no longer maintained.

Original README (click to expand)

Features

  • Chrome Integration: Connect to Chrome DevTools protocol for real-time debugging
  • Log Extraction: Capture console logs, network requests, and errors
  • Visual Debugging: Screenshot capture with element highlighting
  • Element Detection: Advanced CSS selector and visual element finding
  • Automation Framework: JSON-based automation scripts
  • Network Monitoring: Request/response tracking and analysis
  • Advanced Logging: Structured logging with metadata, log rotation and size management
  • Component Monitoring: React hooks, lifecycle tracking, prop changes
  • Network Analysis: Request/response correlation, WebSocket tracking, JWT token monitoring, GraphQL support
  • State Management: Redux state visualization, state change tracking, middleware debugging
  • Performance Monitoring: React render metrics, memory usage tracking, event loop monitoring
  • UI Interaction: User interaction recording, DOM mutation tracking, CSS change monitoring
  • Interactive login handling
  • AI-friendly output format

Prerequisites

  • Node.js >= 20
  • Google Chrome (latest recommended)

Installation

npm install -g clits

Commands

  • clits extract — Extract logs and debugging data from Chrome or local files
  • clits navigate — Navigate to URLs, switch tabs, wait for elements
  • clits interact — Click, type, toggle elements with screenshot capture
  • clits discover — Find CSS selectors, clickable elements, XPath expressions
  • clits inspect — Inspect page elements and browser tabs
  • clits automate — Run JSON automation scripts
  • clits vision — Advanced screenshot and visual diff tools
  • clits-inspect — Interactive website inspector

AI Integration Docs

License

MIT

About

Chrome Log Inspector & Troubleshooting System (CLiTS) - A CLI tool for extracting Chrome DevTools logs, network requests, and browser diagnostics. Features an interactive wizard and structured output format. Perfect for automated debugging and AI-assisted troubleshooting.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors