Turn Google Colab into a Claude Code-powered dev box.

claude-colab is a Claude Code plugin marketplace that ships a self-bootstrapping Colab notebook. It installs Claude Code and configures the claude-colab plugin with skills, agents, hooks, and commands.

1. Download the notebook from the latest release
2. Open in Google Colab
3. Get a long-lived OAuth token: claude setup-token (on your local machine)
4. Add the token to Colab Secrets as CLAUDE_CODE_OAUTH_TOKEN
5. Run all cells
6. Open terminal: source ~/.bashrc && cd /content/claude-workspaces/my-project && claude

The claude-colab plugin provides:

The plugin includes a safety hook that blocks dangerous commands:

• rm -rf / or rm -rf ~ - Prevents deleting root/home
• rm -rf /content/drive - Protects Google Drive mount
• Fork bombs and system killers
• Direct disk writes

• Ephemeral (default): Workspace at /content/claude-workspaces/ - resets each session
• Persistent: Enable Google Drive to save workspace between sessions

• Edit uploaded repos: Upload a zip, unzip it, cd into it, run claude
• Edit notebooks: Use the ipynb skill to create/edit .ipynb files
• Check status: Run /claude-colab:colab-status for environment info
• Save work: Run /claude-colab:checkpoint to save to Drive

This repository serves dual purposes:

1. Plugin Marketplace - Claude Code can fetch the plugin directly from this GitHub repo
2. Bootstrap Notebook - Downloads configure the marketplace and enable the plugin

.claude-plugin/
  marketplace.json     # Marketplace manifest
src/plugin/
  .claude-plugin/
    plugin.json        # Plugin manifest
  skills/              # 5 skills
  agents/              # 2 agents
  commands/            # 3 commands
  hooks/               # SessionStart, PreToolUse, PostToolUse
  scripts/             # Hook implementations

curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

uv run python build.py
# Generates dist/claude-colab.ipynb

uv run python -m pytest tests/ -v

This project uses beads for issue tracking. Issues are stored in the beads-sync branch.

bd list          # List issues
bd ready         # Find unblocked work
bd create "..."  # Create issue