v0.1.0 · LOCAL CHROME · MIT · ZERO TELEMETRY

Your agent writes the page.
It cannot see it.

Kanso opens headless Chrome at 393×852 and 1440×900, scores overflow, gaps over 85px, and contrast, and leaves a git patch the next model can apply.

$ npm install -g kanso
macOS & Linux • Chrome on this machine • Permissive MIT
Headless CDP
< 800ms
Local Chrome audit
Zero Account
0 KB
100% on disk & offline
Git Patch
100%
.kanso/handoff.patch
Dual Viewports
393 & 1440
Phone & desktop bounds
KANSO RADAR HUD CDP ENGINE :3000
Visual Health Telemetry DEFECT CAUGHT
81 / 100 VibeScore™ (100 → 81)

Headless Chrome CDP caught an unconstrained element leaking past the 393px mobile screen boundary.

viewport_overflow @ 393px
Selector: .btn-pro (+18px past edge)
Patch formulated in .kanso/vibe-reports/vibe-report.md
Mobile Responsiveness (393px) 70 / 100
Visual Contrast & Legibility 100 / 100 (4.5:1 AA)
Layout Spacing & Void Radar 100 / 100 (0 voids > 85px)
Tap Targets & Accessibility 100 / 100 (≥ 44px)
CI/CD Gate Triggered Command kanso vibe --ci --threshold 90 exited with code 1. Blocked bad PR before merge.
Hero Component
.btn-pro
+18px
⚠️ Overflow @ 393px
Core Pillars

Three checks a chat window does not run.

A local Chrome pass, a git patch, and a JSON notebook on disk.

Local Headless Chrome

VibeTest™ Visual Radar

Headless Chrome, two viewports, overflow past the screen, empty gaps over 85px, contrast under 4.5:1. kanso vibe --ci --threshold 90 fails the CI job.

393×852 (phone) and 1440×900 (desktop)
WCAG 2.1 AA 4.5:1 contrast & 85px void detection
Deterministic CI exit code on regression
kanso vibe http://localhost:3000
Working Tree Diff

Multi-Model Handoff

kanso handoff writes .kanso/handoff.patch from the working tree. kanso handoff apply restores it. The next model gets the diff, not a recap you retype.

Freezes working tree diff to .kanso/handoff.patch
One-command restore: kanso handoff apply
Works across Claude, Codex, Grok & Gemini
kanso handoff apply
Local JSON Store

On-Disk Memory

kanso recall searches ~/.kanso/memory.json by words in the topic, tags, and note. Stored locally in JSON, fast and private. It is not an embedding index.

Word overlap ranking across topic, tags, and notes
Project-scoped and global knowledge pools
100% offline JSON with zero cloud network calls
kanso recall "contrast trap"
The Dev Loop

How Kanso Runs in Your Development Cycle

Deterministic visual feedback and state protection running completely in your local environment.

STAGE 01
Agent Edits Files

Claude, Cursor, Codex, or Gemini modifies components in your workspace.

STAGE 02
kanso watch Sees Save

Local file watcher triggers headless Chrome audit against localhost.

STAGE 03
Chrome at 393 & 1440

Audits 393px mobile overflow, 85px gaps, and 4.5:1 contrast.

STAGE 04
kanso fix Repair Plan

Prints precision CSS repair plan. Leaves files untouched for your review.

Offline Packs

Packs that ship inside the CLI.

kanso pull memory/tailwind-gotchas copies curated layout gotchas directly into ~/.kanso/memory.json. Built into the binary, completely offline with zero network calls.

memory/tailwind-gotchas v0.1.0 · 12 rules
Fixes mobile navbar voids & unconstrained flex leaks
kanso pull
memory/ios-safari v0.1.0 · 8 rules
100dvh viewport shifts & 44px tap target traps
kanso pull
memory/nextjs-gotchas v0.1.0 · 15 rules
App Router server action caching & hydration rules
kanso pull
memory/wcag-contrast v0.1.0 · 10 rules
WCAG 2.1 AA 4.5:1 ratio color pair patterns
kanso pull
KANSO LIVE WATCH RADAR
$ kanso watch localhost:3000
info Watching workspace for code changes (.tsx, .jsx, .html, .css)...
info Press Ctrl+C to stop watching.
[11:02:14] ⚡️ Change detected in src/components/Hero.tsx
[11:02:14] 🔍 Running CDP Headless Chrome Visual Radar...
[11:02:15] ✅ VibeScore: 100 / 100 (Layout Pristine)
[11:02:40] ⚡️ Change detected in src/components/Pricing.tsx
[11:02:40] 🔍 Running CDP Headless Chrome Visual Radar...
[11:02:41] ⚠️ REGRESSION: VibeScore dropped to 81/100 Element .btn-pro extends 18px past mobile screen (393px). Formulated repair patch via `kanso fix`.
Architecture Comparison

Local Chrome, or a Hosted Snapshot Service.

Chromatic, Percy, and Lost Pixel keep the pictures on their cloud. Kanso keeps the run on your machine.

Monthly Subscription $0 Forever
Hosted $150–$300/mo
Kanso $0 Free
Where It Runs This Machine
Hosted Cloud VM farm
Kanso Local Chrome
Account & Auth None
Hosted Required setup
Kanso Flat files
Viewports 393 & 1440
Hosted Metered fees
Kanso Dual default
CI/CD Gate Built-in
Hosted Quota caps
Kanso Free CLI Gate
Agent Handoff Git Patch
Hosted Dashboard link
Kanso .patch file
License MIT Open Source
Hosted Closed SaaS
Kanso MIT Sovereign
CLI Output

Sample output. Not a live run.

These are the exact lines the CLI prints during real terminal runs on your machine.

terminal — zsh — localhost
local terminal
Environment

Runs wherever Node and Chrome run.

kanso doctor checks for local Chrome, Node 18+, Git, and reports Apple Silicon or NVIDIA GPU if present. Localhost execution, zero cloud servers.

Node.js & Git

Node 18+ runtime with standard Git binary. No native compilation required.

macOS & Linux
Headless Chrome

Uses local Google Chrome via Chrome DevTools Protocol (CDP) with --disable-gpu.

CDP Engine
GPU Detection

kanso doctor probes nvidia-smi or Apple Silicon chip info for diagnostic telemetry.

Optional Hardware
Flat Files on Disk

Stores patches in .kanso/handoff.patch and memories in ~/.kanso/memory.json.

100% Local Disk
Transparency

Frequently Asked Questions

Everything you need to know about Kanso's sovereign architecture, privacy model, and licensing.

01

Is Kanso really 100% free and open-source?

Yes. Kanso is released under the permissive MIT License. There are no trial periods, no hidden credits, no cloud subscription tiers, and no locked features. We believe foundational developer sovereignty belongs to everyone.

02

Does Kanso send my code or diffs to any external server?

03

How does VibeTest differ from Playwright or Cypress?

04

Which AI models and coding agents are supported?

05

Can I use Kanso in GitHub Actions or CI/CD?

簡

Ready for Sovereign Engineering?

Join the open-source sovereign movement. No credit cards, no logins, no subscriptions. Install in seconds on macOS, Linux, or Windows.

Install Kanso CLI Free Star on GitHub