Install

Zzza ships as a CLI and a VS Code extension. They share the same manifest (slice.jsonc) so the CLI and UI always stay in sync.

Install the CLI

Recommended Install globally so zzza is available anywhere.

npm i -g zzza

Quick start

zzza init
zzza add core src/index.ts
zzza group core green
zzza build

This creates slice.jsonc and generates slice_context.md.

Verify

zzza --version
zzza --help
zzza list slices

If you just installed, restart your terminal if zzza isn’t found.

Install the VS Code extension

Use the extension to manage slices and groups without leaving your editor.

• Open VS Code
• Extensions → search: “zzza”
• Install

Once installed, look for the Zzza view in the Activity Bar.

Rules (V1)

• One group per slice
• Explicit group assignment
• CLI and UI stay in sync (same slice.jsonc)