VividKit Desktop

GUI companion that makes Claude Code CLI + CCS accessible to everyone — developers who dislike the terminal and non-developers alike.

Tagline: Full Claude Code power without the terminal.

What It Does

VividKit wraps Claude Code and CCS (Claude Code Switcher) in a polished desktop UI. Users get full Claude Code power without typing a single CLI command.

• Pick your AI provider — CCS profiles (Claude, Gemini, GLM, Kimi, Codex, etc.) via dropdown
• Manage projects — visual project cards, no path wrangling
• AI Brainstorm — ideation sessions with AI, results saved locally
• Task board — Kanban for solo devs, synced with project context
• Cook + StreamView — JSONL session streaming with structured rendering (thinking blocks, tool calls, responses), git worktree support

Everything runs locally. No cloud sync. No telemetry. API keys stay on your machine.

Architecture

User clicks UI
  -> Zustand action -> invoke() [Tauri IPC]
  -> Rust backend spawns CCS process: ccs [profile] [args]
  -> JSONL session log watched + streamed to frontend via events
  -> StreamView renders structured output (thinking, tool calls, responses)

Stack

Layer	Tech
Frontend	React 18, TypeScript, Tailwind v4, shadcn/ui, Zustand
Desktop	Tauri v2, Rust
Stream	JSONL session parser, StreamView components
Storage	SQLite via rusqlite
I18n	react-i18next (vi default, en secondary)
CLI	CCS v7+ (ccs [profile]), Claude Code

Prerequisites

• Git
• Node.js 20+
• Rust (stable)
• Tauri v2 prerequisites
• CCS CLI — npm install -g @kaitranntt/ccs
• Claude Code CLI — for underlying AI sessions

Development

npm install
npm run tauri dev
npm run tauri build

Project Structure

src/
  components/{module}/   # UI components per module
  stores/                # Zustand stores (one per domain)
  hooks/                 # Custom hooks (one per concern)
  lib/tauri.ts           # invoke() wrappers with typed args/returns
  locales/{vi,en}/       # i18n JSON (vi default, en secondary)
  types/                 # Shared TypeScript interfaces

src-tauri/src/
  commands/{module}.rs   # Tauri command handlers
  models/{entity}.rs     # Serde structs for IPC and DB
  lib.rs                 # Plugin registration, invoke_handler

MVP Modules

Module	Directory	Purpose
Onboarding	src/components/onboarding/	4-step wizard: Welcome, Git, AI Tools, Project
Dashboard	src/pages/	Stats + quick actions
Project Deck	src/components/decks/	Project cards, deck management
Brainstorm	src/components/brainstorm/	AI ideation via StreamView, insights, report generation
Plans	src/components/plans/	Plan generation, AI validation, red-team scan
Tasks	src/components/tasks/	Kanban board (Backlog/Todo/In Progress/Done)
Cook	src/components/cook/	StreamView session runner per task
Worktrees	src/components/worktree/	Git worktree lifecycle (create, merge, cleanup)
Settings	src/components/settings/	CCS profiles, app configuration

Docs

• Product Overview (PDR)
• System Architecture
• Code Standards
• Design System
• Development Roadmap
• Codebase Summary

License

MIT