Metadata-Version: 2.4
Name: cccfg
Version: 0.1.0
Summary: The complete Claude Code config explorer: TUI plus reference of every env var, settings.json key, CLI flag, slash command, and hook event
Author-email: Marco Kotrotsos <maildmz@gmail.com>
License: MIT
Project-URL: Homepage, https://claude-code-book-site-production.up.railway.app/tool/
Project-URL: Documentation, https://claude-code-book-site-production.up.railway.app/tool/
Project-URL: Source, https://github.com/Kotrotsos/cccfg
Project-URL: Issues, https://github.com/Kotrotsos/cccfg/issues
Keywords: claude,claude-code,anthropic,tui,config,cli,developer-tools
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=6.0
Requires-Dist: rich>=13.0
Dynamic: license-file

# cccfg

The complete Claude Code config explorer. A keyboard-driven TUI plus CLI reference for every config surface in Claude Code 2.1.x.

Most Claude Code users know the dozen settings exposed in `/config`. Under the hood there are 434 environment variables compiled into the binary, 30+ settings.json keys, 14 CLI flags, slash commands, and hook events. `cccfg` puts all of them in one keyboard-navigable place, with descriptions, use cases, examples, current-value lookup, and a cookbook of the patterns worth memorising.

## Install

```bash
pip install cccfg
```

## Run

```bash
cccfg                       # launch the TUI
cccfg --list                # full catalog grouped by category
cccfg --search hooks        # search across all entries
cccfg --category Models     # filter by category
cccfg --kind settings       # only settings.json keys
cccfg --json | jq           # pipe-friendly JSON
cccfg --cookbook            # print the cookbook
```

## TUI keys

| Key | Action |
|-----|--------|
| `j` / `k` | navigate entries down / up |
| `/` | focus search |
| `c` | focus category list |
| `Enter` or `m` | **open the manual page for this entry** |
| `?` | open the cookbook |
| `Esc` | close modal / back to entry list |
| `q` | quit |

## What's in it

| Surface | Entries |
|---------|---------|
| Environment variables (`CLAUDE_CODE_*`, `CLAUDE_*`, `ANTHROPIC_*`, `DISABLE_*`, `BASH_*`, `MCP_*`) | 434 |
| `settings.json` keys (documented + discovered) | 30 |
| CLI flags (the high-leverage ones) | 14 |
| Slash commands | 11 |
| Hook events | 10 |
| **Total** | **499** |

Organised across 23 categories: Auth & API, Models, Thinking & Effort, Permissions & Sandbox, Hooks, Hook Events, Skills & Plugins, MCP, Background Agents, Cache & Compaction, Bash Tool, UI & TUI, Telemetry & Privacy, Updates & Install, Cloud Providers, Debug & Logging, Experimental & Beta, Network & Proxy, Compliance & Enterprise, Disable Flags, Limits & Timeouts, CLI Flags, Slash Commands.

## How the catalog was built

The environment variable list was extracted from the Claude Code binary directly (Mach-O native arm64) via `strings`, then filtered to canonical name patterns. The settings.json keys, CLI flags, slash commands and hook events come from the binary plus Anthropic's published docs plus Marco Kotrotsos's deployment notes from running Claude Code in client engagements through 2025-2026.

The high-leverage entries have hand-written descriptions, use cases, examples, and defaults. The remaining auto-discovered entries get a category and a short name-derived summary, with the "Discovered" tag so you know it isn't officially documented.

## Manual page per entry

Press `Enter` on any entry in the TUI. A full-screen manual page opens with:

- Type and category
- Summary, description, use case
- Example value
- Documented default
- Current value on this machine (live lookup from env vars or `~/.claude/settings.json`)
- Exact shell or settings.json snippet to set it

Press `Esc` to return to the entry list.

## Cookbook

Open with `?` in the TUI or `cccfg --cookbook` on the command line. Recipes include:

- Lock down a team's install (managed settings)
- Use a secret vault for the API key
- Maximum privacy mode (no telemetry, no surveys, no growthbook)
- CI-clean run with no harness baggage (`--bare`)
- Bigger Bash output and longer timeouts
- Pin model versions for reproducibility
- Register a custom internal model in the picker
- Debug a hook
- Disable auto-compaction (manage manually with `/compact`)
- Force Claude not to read the keychain (sandbox / VM)

## Related

This tool ships as a companion to ["Claude Code, Definitive Guide for 2026: From Starter to 10x Pro"](https://claude-code-book-site-production.up.railway.app). The book teaches the patterns; cccfg lets you find the exact config knob when you need it.

## License

MIT.
