ccb-compact

Compacts conversation context of mounted CCB agents using provider-native commands.

3.5k|342|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/bfly123/claude_code_bridge --skill ccb-compact
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ccb-compact
Source: https://github.com/bfly123/claude_code_bridge/tree/main/inherit_skills/kimi_skills/ccb-compact
Command: npx skills add https://github.com/bfly123/claude_code_bridge --skill ccb-compact

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running multi-agent sessions in CCB accumulate large conversation contexts that degrade agent performance. This Skill lets you compact one or more mounted agent contexts without restarting agents, deleting project state, or losing sessions.

Core Features & Use Cases

  • Targeted Compaction: Run ccb compact on all mounted agents or name specific agents to compact only their contexts.
  • Provider-Native Commands: Sends each provider's native compaction command and reports unsupported when no verified command exists for a provider.
  • Safe Execution: Blocks busy or queued agents before sending input, and never deletes .ccb state, workspaces, auth, sessions, logs, or memory files.
  • Use Case: During a long coding session where Codex and Claude panes have grown sluggish, invoke the skill to compact both agents' contexts in one pass while keeping all project state intact.

Quick Start

Ask the assistant to compact the context of all mounted CCB agents, or name specific agents such as codex and claude, using the ccb compact command.

Frequently Asked Questions about ccb-compact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compact CCB agent context without restarting agents?

Run `ccb compact` to compact all configured mounted agents, or pass agent names like `ccb compact codex claude` to target specific agents. The command sends each provider's native compaction command while preserving all project state.

How do I compact only specific agents in CCB?

Pass the agent names as arguments, for example `ccb compact agent1 agent2`. A bare `ccb compact` targets all configured mounted agents, while named arguments restrict compaction to only those agents.

Does ccb compact delete sessions, logs, or workspace state?

No. The command does not delete `.ccb` state, workspaces, auth, sessions, logs, or memory files. It only requests provider-native context compaction for the mounted agents.

What happens if an agent is busy when running ccb compact?

Busy or queued agents are blocked before any pane input is sent, so compaction input is never injected into an agent that is still processing. Wait for the agent to finish and run the command again.

Why does ccb compact report unsupported for some providers?

The command sends each provider's native compaction command, and reports `unsupported` when no verified compaction command exists for that provider. In that case no input is sent to that agent's pane.