Ccbox

ccbox

Create professional documents with AI (PDFs, presentations, spreadsheets, and Word documents) by describing what you need in plain language.

What is ccbox?

ccbox is a **ready-to-use AI workstation for documents**, packaged as a Docker container.

Inside the container runs [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Anthropic's AI coding assistant, together with everything it needs to produce polished office documents: LibreOffice, Pandoc, Tesseract OCR, plus Python and Node libraries for PDFs, Word, Excel, and PowerPoint. You describe what you want in plain English, and Claude writes and runs the code to build the file.

You don't install any of those tools on your own machine. You just install one small shell command (`ccbox`) that starts the container for you.

Quick start

1. Install

curl -fsSL https://raw.githubusercontent.com/mk0e/ccbox/main/install.sh | bash

You'll need Docker (or Podman) installed and running first.

The installer is a small, local setup script. It does **not** install any heavy software on your machine. It:

• Checks that Docker or Podman is installed and running.
• Adds a ccbox function to your shell config (.zshrc, .bashrc, or fish functions). This is how typing ccbox works. It's a short shell wrapper that runs the container for you.
• Asks how you want to sign in, either with an Anthropic API key (stored locally in ~/.config/ccbox/auth.env, chmod 600) or with your Claude account (Pro, Team, Enterprise, or free tier; you log in the first time you launch).
• Creates ~/.ccbox/ on your machine. This folder keeps your Claude sessions, settings, and shared templates across container restarts.

That's it. No system packages installed, no background services, no daemon. The container image itself is only downloaded the first time you actually run `ccbox`.

Run `./install.sh` again any time to update the command, change auth, or uninstall.

2. The workspace fol