# 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 - **Package manager page:** - **Version:** 4.3.2 - **Source summary:** Customize your Claude Code themes, thinking verbs, and more - **Homepage:** - **Repository:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-21T19:00:38Z - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - tweakcc (cli) - tweakcc (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-08-04 - Package-manager version: 4.3.2 - Package-manager updated: 2026-07-21 - Local data: ok - Upstream repository: https://github.com/Piebald-AI/tweakcc - info: No cached GitHub release or tag data was available. ## 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 - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for tweakcc. 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 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tweakcc - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://pkg.so/mcp-tools/) - Mentions MCP or Model Context Protocol. - [AI and agent packages](https://pkg.so/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata. - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [node](https://pkg.so/brew/node/) - Runtime dependency declared by Homebrew. - [ccusage](https://pkg.so/brew/ccusage/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [claude-code-router](https://pkg.so/brew/claude-code-router/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [claude-cmd](https://pkg.so/brew/claude-cmd/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [claudekit](https://pkg.so/brew/claudekit/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [claude-code-templates](https://pkg.so/brew/claude-code-templates/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [omnara](https://pkg.so/brew/omnara/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [claude-hooks](https://pkg.so/brew/claude-hooks/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents. - [gemini-cli](https://pkg.so/brew/gemini-cli/) - Shares pkgdb curated category or tags: ai, cli, coding-agents. ## 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 - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - cross-ecosystem install command graph