# Install tweakcc with Homebrew

Customize your Claude Code themes, thinking verbs, and more. Version 4.3.2 via Homebrew; verified 2026-07-21.

## Install

```sh
sudo av install brew:tweakcc
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tweakcc
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:tweakcc
- **Package manager:** Homebrew
- **Version:** 4.3.2
- **Source summary:** Customize your Claude Code themes, thinking verbs, and more
- **Homepage:** <https://github.com/Piebald-AI/tweakcc>
- **Last updated:** 2026-07-21T19:00:38Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- tweakcc (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 4.3.2
## Project history and usage

tweakcc is a Piebald-AI CLI for customizing and patching Claude Code installations.

### Project history

The official GitHub repository was created in July 2025. The README describes a tool that patches Claude Code's packaged JavaScript to customize system prompts, themes, toolsets, spinners, input styling, and other behavior.

The 4.x documentation adds an API, sandboxed custom patch scripts, remote config application, AGENTS.md support, and native-binary unpacking and repacking across macOS, Windows, and Linux.

### Adoption history

The README emphasizes package-manager-first use through `npx tweakcc` and `pnpm dlx tweakcc`, and supports Claude Code installations made with npm, yarn, pnpm, bun, Homebrew, Nix, and multiple runtime managers. source_facts.package-manager also records a Homebrew formula.

### How it is used

Typical use is `npx tweakcc` for the interactive interface or `npx tweakcc --apply` to reapply stored customizations. Advanced users can use `unpack`, `repack`, and `adhoc-patch` to inspect or modify packaged Claude Code JavaScript.

### Why package nerds care

tweakcc applies package tooling to customization of another packaged developer tool: npx is the entry point, a home-directory JSON file stores state, and patch scripts can be distributed and automated.

### Timeline

- 2025-07-20: Official GitHub repository created.
- 2020s: Official 4.x documentation adds an API, custom patches, remote config, and native-installation support.
- Current: Official README documents npm, pnpm, Homebrew, Nix, and native Claude Code installation compatibility.

### Related projects

- Claude Code is the primary upstream application modified by tweakcc.
- node-lief is the Piebald-AI binding used to extract and repack JavaScript in native Claude Code binaries.
- npm, pnpm, Homebrew, and Nix are part of the documented installation surface.

### Sources

- <https://api.github.com/repos/Piebald-AI/tweakcc>
- <https://github.com/Piebald-AI/tweakcc#readme>
- <https://github.com/Piebald-AI/tweakcc/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for tweakcc. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: $TWEAKCC_CONFIG_DIR/config.json, ~/.tweakcc/config.json, ~/.claude/tweakcc/config.json, $XDG_CONFIG_HOME/tweakcc/config.json

## Combined YAML source

View the package source record on GitHub. [combined/tweakcc.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tweakcc.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph