cc-hub

A hub directory convention and CLI for coding agents launched by cc-connect.

cc-connect bridges Claude Code, Codex and other agents to chat platforms and starts the agent in a work_dir. cc-hub turns that directory into a hub: the agent's home base on your machine, with a persona, memory, and a registry of your projects and remote hosts. Permissions and background work stay with cc-connect and the agent runtime; the hub adds conventions and routing, not another layer of either.

The hub is agent-agnostic. It ships no Claude- or Codex-specific files; on first run the agent creates the pointers its own ecosystem needs (hub-adapt).

Quick start

uv tool install cc-hub
cc-hub init                     # creates ~/.cc-hub
cc-hub doctor

Install from a regular terminal; on Windows not from a shell inside the Claude desktop app (see docs/install.md).

Point cc-connect at the hub (work_dir = "/home/you/.cc-hub", see docs/cc-connect.md) and send the first message. The agent follows BOOTSTRAP.md: names itself, learns who you are, registers projects, adapts to its runtime, and deletes the bootstrap file.

Commands

Hub layout

~/.cc-hub/
├── AGENTS.md  AGENTS.local.md  BOOTSTRAP.md      instructions
├── SOUL.md  IDENTITY.md  USER.md                 persona and user
├── MEMORY.md  memory/YYYY-MM-DD.md               memory
├── projects.toml  hosts.toml  hub.toml           registries and config
├── skills/  cron/  scripts/  secrets/            skills, scheduled prompts, your scripts, credentials
└── ENV.md  env.json                              generated state (gitignored)

Framework-owned files (AGENTS.md, BOOTSTRAP.md, skills/hub-*, cron/README.md) are replaced by cc-hub update. Everything else is yours.

Documentation

• Install and upgrade
• cc-connect configuration
• Windows notes
• Codex sandbox notes
• Manual acceptance checklist
• Design spec

中文说明见 README.zh-CN.md。

License

MIT