Cozempic

https://pypi.org/project/cozempic/
Admin
Context cleaning and session management tool for Claude Code that removes bloat, protects agent...
Tokens:6,876
Snippets:98
Trust Score:10
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install Cozempic using pipx

Source: https://pypi.org/project/cozempic/1.8.7

Install Cozempic using pipx for an isolated user installation that is always available on the PATH.

```bash
pipx install cozempic
```

--------------------------------

### Install Cozempic using Homebrew

Source: https://pypi.org/project/cozempic/1.8.7

Install Cozempic on macOS or Linux using the Homebrew package manager.

```bash
brew install Ruya-AI/cozempic/cozempic
```

--------------------------------

### Run Cozempic using uvx

Source: https://pypi.org/project/cozempic/1.8.7

Execute Cozempic on demand using uvx without a formal installation.

```bash
uvx cozempic --help
```

--------------------------------

### Install Cozempic using pip

Source: https://pypi.org/project/cozempic/1.8.7

Install the Cozempic package using pip for Python versions 3.10 and above.

```bash
pip install cozempic
```

--------------------------------

### Install Cozempic using Nix flake

Source: https://pypi.org/project/cozempic/1.8.7

Install Cozempic using a Nix flake for NixOS or other Nix-based systems.

```bash
nix profile install github:Ruya-AI/cozempic?dir=packaging/nix
```

--------------------------------

### Start Cozempic Guard Daemon

Source: https://pypi.org/project/cozempic/1.8.7

Start the Cozempic guard process, which can be run as a daemon. It can also be auto-started via hooks.

```bash
cozempic guard [--daemon]                   Start guard (auto-starts via hook)
```

--------------------------------

### Install Cozempic as a Claude Code Plugin

Source: https://pypi.org/project/cozempic/1.8.7

Install Cozempic as a plugin within the Claude Code environment to access MCP tools and skills.

```bash
/plugin marketplace add Ruya-AI/cozempic
/plugin install cozempic
```

--------------------------------

### Example Cozempic Prescription Output

Source: https://pypi.org/project/cozempic/1.8.7

This output demonstrates the results of running a Cozempic prescription, showing token and message savings, and breakdown by strategy.

```text
  Prescription: aggressive
  Before: 158.2K tokens (29.56MB, 6602 messages)
  After:  121.5K tokens (23.09MB, 5073 messages)
  Freed:  36.7K tokens (23.2%) — 6.47MB, 1529 removed, 4038 modified
  Context: [============--------] 61%

  Strategy Results:
    compact-summary-collapse       8.17MB saved (85.2%)  (4201 removed)
    progress-collapse              1.63MB saved  (5.5%)  (1525 removed)
    metadata-strip                693.9KB saved  (2.3%)  (2735 modified)
    tool-use-result-strip          1.44MB saved  (4.9%)  (891 modified)
    thinking-blocks                1.11MB saved  (3.8%)  (1127 modified)
    tool-output-trim               1.72MB saved  (5.8%)  (167 modified)
    ...

```

--------------------------------

### Run Cozempic Guard Daemon

Source: https://pypi.org/project/cozempic/1.8.7

Starts the cozempic guard daemon for continuous session monitoring and pruning. Can also be run manually.

```bash
# Auto-starts via SessionStart hook after cozempic init
# Or run manually:
cozempic guard --daemon

```

--------------------------------

### Update Cozempic to Latest Version

Source: https://pypi.org/project/cozempic/1.8.7

Upgrade your Cozempic installation to the latest version available on PyPI using the `self-update` command.

```bash
cozempic self-update                        Upgrade to latest version from PyPI
```

--------------------------------

### Initialize Cozempic Project

Source: https://pypi.org/project/cozempic/1.8.7

Wire hooks and slash commands into your project using the `init` command.

```bash
cozempic init                               Wire hooks + slash command into project
```

--------------------------------

### Show All Strategies and Prescriptions

Source: https://pypi.org/project/cozempic/1.8.7

Display all available pruning strategies and their corresponding prescriptions for Cozempic.

```bash
cozempic formulary
```

--------------------------------

### Apply Standard Prescription with Backup

Source: https://pypi.org/project/cozempic/1.8.7

Apply the standard prescription to the current session, including creating a backup before execution.

```bash
cozempic treat current --execute
```

--------------------------------

### Execute Cozempic Prescription with Backup

Source: https://pypi.org/project/cozempic/1.8.7

Apply changes from a Cozempic prescription to a session with the `--execute` flag. A backup is created before modifications.

```bash
cozempic treat <session> --execute          Apply changes with backup
```

--------------------------------

### Display Cozempic Strategies and Prescriptions

Source: https://pypi.org/project/cozempic/1.8.7

Show all available strategies and prescriptions within Cozempic using the `formulary` command.

```bash
cozempic formulary                          Show all strategies & prescriptions
```

--------------------------------

### Apply Cozempic Prescriptions

Source: https://pypi.org/project/cozempic/1.8.7

Run a prescription to optimize a Cozempic session. Use the `-rx PRESET` flag to specify a prescription preset. The default is a dry-run.

```bash
cozempic treat <session> [-rx PRESET]       Run prescription (dry-run default)
```

--------------------------------

### Apply Cozempic Prescriptions

Source: https://pypi.org/project/cozempic

Run a 'prescription' to optimize a session. By default, it performs a dry-run. Use '--execute' to apply changes.

```bash
cozempic treat <session> [-rx PRESET]       Run prescription (dry-run default)
```

```bash
cozempic treat <session> --execute          Apply changes with backup
```

--------------------------------

### List Cozempic Sessions

Source: https://pypi.org/project/cozempic/1.8.7

List all active sessions along with their sizes and token estimates using the `list` command.

```bash
cozempic list                               List sessions with sizes and token estimates
```

--------------------------------

### Run Single Cozempic Strategy

Source: https://pypi.org/project/cozempic/1.8.7

Execute a specific strategy on a Cozempic session using the `strategy` command.

```bash
cozempic strategy <name> <session>          Run single strategy
```

--------------------------------

### Cozempic Configuration Environment Variables

Source: https://pypi.org/project/cozempic

Manage Cozempic's behavior using environment variables. Options include disabling auto-updates, disabling telemetry, and setting the context window size.

```bash
COZEMPIC_NO_AUTO_UPDATE, COZEMPIC_NO_TELEMETRY, COZEMPIC_CONTEXT_WINDOW env vars
```

--------------------------------

### Dry-run Standard Prescription for Current Session

Source: https://pypi.org/project/cozempic/1.8.7

Perform a dry run of the standard prescription for the current session to preview changes without applying them.

```bash
cozempic treat current
```

--------------------------------

### Show or Diagnose Current Cozempic Session

Source: https://pypi.org/project/cozempic/1.8.7

Display information about the current session or diagnose it using the `current` command. Use the `-d` flag for detailed diagnosis.

```bash
cozempic current [-d]                       Show/diagnose current session
```

--------------------------------

### View Behavioral Digest Rules

Source: https://pypi.org/project/cozempic/1.8.7

Display the current behavioral digest rules, which are used to persist corrections and survive compaction.

```bash
cozempic digest show
```

--------------------------------

### Manage Cozempic Behavioral Digest

Source: https://pypi.org/project/cozempic/1.8.7

Commands to view, update, and inject behavioral rules for Cozempic. These rules help Cozempic learn from user corrections.

```bash
# View extracted rules
cozempic digest show

# Manually extract from current session
cozempic digest update

# Sync rules to Claude Code's memory system
cozempic digest inject

```

--------------------------------

### Configure Cozempic Telemetry and Updates

Source: https://pypi.org/project/cozempic/1.8.7

Control Cozempic's telemetry and auto-update behavior using environment variables. Set `COZEMPIC_NO_TELEMETRY=1` to disable usage counters and `COZEMPIC_NO_AUTO_UPDATE=1` to prevent automatic updates.

```bash
COZEMPIC_NO_TELEMETRY=1 disables anonymous usage counters
COZEMPIC_NO_AUTO_UPDATE, COZEMPIC_NO_TELEMETRY, COZEMPIC_CONTEXT_WINDOW env vars
```

--------------------------------

### Diagnose and Fix Cozempic Issues

Source: https://pypi.org/project/cozempic/1.8.7

Use the `doctor` command to diagnose potential issues within your Cozempic project. Add the `--fix` flag to attempt automatic resolution of detected problems.

```bash
cozempic doctor        # Diagnose issues
cozempic doctor --fix  # Auto-fix where possible
```

--------------------------------

### Analyze Cozempic Session Bloat

Source: https://pypi.org/project/cozempic/1.8.7

Analyze the sources of bloat within a specific Cozempic session using the `diagnose` command.

```bash
cozempic diagnose <session>                 Analyze bloat sources
```

--------------------------------

### Apply Aggressive Prescription to Specific Session

Source: https://pypi.org/project/cozempic/1.8.7

Apply an aggressive prescription to a specific session identified by its session ID, with execution enabled.

```bash
cozempic treat <session_id> -rx aggressive --execute
```

--------------------------------

### Checkpoint Cozempic Team State

Source: https://pypi.org/project/cozempic/1.8.7

Save the current state of a Cozempic team to disk using the `checkpoint` command. Use `--show` to display the checkpoint status.

```bash
cozempic checkpoint [--show]                Save team state to disk
```

--------------------------------

### Reload Cozempic Session

Source: https://pypi.org/project/cozempic/1.8.7

Reload a Cozempic session, applying treatments and auto-resuming in a new terminal. Use `-rx PRESET` to specify a treatment preset.

```bash
cozempic reload [-rx PRESET]                Treat + auto-resume in new terminal
```

--------------------------------

### Manage Cozempic Digests

Source: https://pypi.org/project/cozempic/1.8.7

Perform various operations on Cozempic digests, including showing, updating, clearing, flushing, recovering, and injecting.

```bash
cozempic digest [show|update|clear|flush|recover|inject]
```

--------------------------------

### Cozempic Reload with Explicit Session

Source: https://pypi.org/project/cozempic

An escape hatch for Cozempic's reload command when auto-detection fails in multi-agent sessions. This allows recovery from ambiguous session detection by specifying an explicit session ID or path.

```bash
cozempic reload --session <id|path>
```

--------------------------------

### Cozempic Telemetry Opt-out

Source: https://pypi.org/project/cozempic

Disable anonymous usage counters by setting the COZEMPIC_NO_TELEMETRY environment variable to 1.

```bash
COZEMPIC_NO_TELEMETRY=1 disables anonymous usage counters
```

--------------------------------

### Cozempic Reload Command with Session ID

Source: https://pypi.org/project/cozempic/1.8.7

Use `cozempic reload --session <id|path>` as an escape hatch when auto-detect fails in multi-agent sessions. This command allows recovery from ambiguous session detection.

```bash
**`cozempic reload --session <id|path>`**escape hatch when auto-detect fails in multi-agent sessions. Previously reload had no way to recover from ambiguous session detection, leaving users stuck. Matches`guard --session`.
```

--------------------------------

### Check for Session Corruption

Source: https://pypi.org/project/cozempic/1.8.7

Run the doctor command to check for and potentially diagnose session corruption within Claude Code.

```bash
cozempic doctor
```

--------------------------------

### Diagnose Current Claude Code Session

Source: https://pypi.org/project/cozempic/1.8.7

Automatically detect and diagnose the current Claude Code session to identify potential issues.

```bash
cozempic current --diagnose
```
Tokens:
Raw