whatisgithub

What is gazzo?

s-age/gazzo — explained in plain English

Analysis updated 2026-05-18

0SwiftAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A macOS GUI for driving Claude Code AI agent sessions, with an experimental local image-generation tool the agent can call on its own.

Mindmap

mindmap
  root((Gazzo))
    What it does
      GUI for Claude Code
      Session browsing and resume
      Live conversation view
      Local image tool for agent
    Tech stack
      Swift
      SwiftUI
      Metal
    Use cases
      Manage agent sessions
      Watch subagents live
      Generate images via agent
    Audience
      Claude Code power users
    Setup
      Requires macOS 15 plus
      Requires Claude CLI
      Optional image engine build

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run and watch Claude Code agent sessions in a native macOS GUI instead of the terminal.

USE CASE 2

Browse and resume past Claude Code sessions with a live conversation view.

USE CASE 3

Give a Claude agent a local, GPU-backed image generation tool it can call during a session.

USE CASE 4

Split the window into multiple panes to run several agent sessions side by side.

What is it built with?

SwiftSwiftUIMetalstable-diffusion.cpp

How does it compare?

s-age/gazzoaiduckman/claudeusage_latest_may2026arnabau/thermalpulse
Stars000
LanguageSwiftSwiftSwift
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires macOS 15+, Swift 6, the Claude CLI, and a separate build step to enable the local image generation engine.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Gazzo is a macOS desktop app that gives Claude Code, an AI coding agent tool, a graphical interface instead of only running it in a terminal. It lets a user browse past Claude Code sessions stored on their machine, start new agent sessions, resume old ones, and watch the conversation unfold live, including the agent's tool use and any subagents it spawns. Users can split the window into multiple panes, each running its own session, pick which AI model and working directory to use, and mention files directly in the composer with search. If a headless Claude session needs to ask the user something, gazzo can show that as a native prompt instead of the session failing silently. The project doubles as an experiment in giving an AI agent the ability to generate images on its own. It runs a local image generation engine on the Mac's GPU and exposes it to Claude sessions as a callable tool, alongside tools that let the agent ask the user for permission or ask them to choose between options. The image engine runs inside a separate helper process so it keeps working even when the main window is closed, and generated images are saved to disk and shown in an artifact viewer with a live preview. The author notes that once given this tool, Claude uses it on its own, for example illustrating an explanation or asking which of several generated options the user prefers. Under the hood, gazzo is built on a custom Swift framework called swift-kernelee, using an architecture where every action across the app is represented as data flowing through a central kernel, and the interface only reads from a shared state buffer rather than writing to it directly. The app never modifies a user's original Claude Code history files, keeping its own separate data store instead. Building it requires macOS 15 or newer, Swift 6, and the Claude CLI installed, and image generation requires an extra build step to compile the local image engine. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through building and running gazzo on macOS with the Claude CLI installed.
Prompt 2
Explain how gazzo exposes a local image generation tool to a headless Claude session.
Prompt 3
Show me how to set up the stable-diffusion.cpp engine so image generation works in gazzo.
Prompt 4
Help me understand gazzo's kernel-based architecture built on swift-kernelee.

Frequently asked questions

What is gazzo?

A macOS GUI for driving Claude Code AI agent sessions, with an experimental local image-generation tool the agent can call on its own.

What language is gazzo written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Metal.

What license does gazzo use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is gazzo to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is gazzo for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.