CellCog Plugin Guide

Install the CellCog plugin in your coding agent and generate images, videos, PDFs, research reports, music, spreadsheets, 3D models, and more from natural language prompts.

Quick Start

Cursor:

text
/add-plugin cellcog

Claude Code:

bash
claude plugin install https://github.com/CellCog/cellcog-plugin

OpenClaw:

bash
openclaw plugins install https://github.com/CellCog/cellcog-plugin

Other tools: point your tool's plugin loader at https://github.com/CellCog/cellcog-plugin. The plugin follows the Open Plugins standard.

Then install the SDK and set your API key:

bash
pip install -U cellcog
export CELLCOG_API_KEY="sk_..."  # Get from https://cellcog.ai/profile?tab=api-keys

That's it. Ask your coding agent to generate any rich media, and the plugin handles the rest.

What It Does

The plugin teaches your coding agent to delegate creative, research, and document tasks to CellCog. You describe what you need in natural language:

"Create a 30-second marketing video for our new fitness app"

"Research quantum computing advances in 2026 with citations"

"Design logo concepts and a one-pager PDF for my coffee shop"

The plugin's routing rule detects the task type, your agent uses the CellCog Python SDK to send it, and results come back inline: files, links, and content.

The plugin handles: images, videos, audio, music, PDFs, presentations, spreadsheets, research reports, 3D models, memes, diagrams, prototypes, game assets, stickers.

Your coding agent handles natively: code editing, git, terminal commands, file operations.

Installation Options

Cursor

text
/add-plugin cellcog

Claude Code

Direct install:

bash
claude plugin install https://github.com/CellCog/cellcog-plugin

Or type /plugin in a session to browse and install interactively.

OpenClaw

bash
openclaw plugins install https://github.com/CellCog/cellcog-plugin

OpenClaw can also install CellCog as a ClawHub skill bundle instead of the full plugin. See the OpenClaw Integration Guide.

Any Open Plugins Tool

Clone the repository or point your tool's plugin loader at:

text
https://github.com/CellCog/cellcog-plugin

SDK Setup

After installing the plugin, set up the Python SDK:

bash
pip install -U cellcog
export CELLCOG_API_KEY="sk_..."

Get your API key from cellcog.ai/profile?tab=api-keys. For persistent setup, add the export to ~/.zshrc or ~/.bashrc.

Or run the setup command inside your coding agent:

• Cursor: /cellcog-setup
• Other tools: /cellcog:cellcog-setup

This checks the SDK, installs it if needed, and walks through authentication.

Skills

The plugin bundles a focused set of skills, each a guide that teaches your coding agent how to use CellCog for one kind of task:

Your coding agent loads the relevant skill automatically based on the task. You can also invoke a skill directly as a slash command, for example /cellcog, /image-generation-cellcog, or /video-generation-cellcog. The larger skills catalog for OpenClaw agents lives on ClawHub; see the OpenClaw Integration Guide.

Chat Modes and Tiers

Each mode runs at a tier: "flash", "core", or "max" (Agent Creative has no Flash tier). Your coding agent selects the mode and tier based on the task, or you can specify them:

python
result = client.create_chat(
    prompt="Build a financial model for a 3-year SaaS plan",
    task_label="model",
    chat_mode="agent",
    chat_tier="max",
)

Omit chat_tier and Agent runs on Flash, which is right for quick asset generation. The SDK switches to Max automatically when enable_cowork=True. Older mode strings from earlier plugin versions are still accepted.

Any positive credit balance starts a chat in every mode and tier; there is no per-mode minimum.

File Handling

Send files to CellCog:

python
result = client.create_chat(
    prompt="Analyze this data: <SHOW_FILE>/path/to/sales.csv</SHOW_FILE>",
    task_label="data-analysis",
    chat_mode="agent",
)

Request output at a specific path:

python
result = client.create_chat(
    prompt="Create a report: <GENERATE_FILE>/output/report.pdf</GENERATE_FILE>",
    task_label="report",
    chat_mode="agent",
)

Generated files download to ~/.cellcog/chats/{chat_id}/, or to the GENERATE_FILE path when you specify one.

How It Relates to Other CellCog Features

Troubleshooting

SDK not found

bash
pip install -U cellcog

Use the same Python interpreter your coding agent uses.

Invalid API key

1. Check your keys at cellcog.ai/profile?tab=api-keys
2. The key starts with sk_
3. Verify the variable is set: echo $CELLCOG_API_KEY

Insufficient credits

Check your balance on the Billing page at cellcog.ai/billing.

SDK errors after an update

bash
pip install -U cellcog

Plugin not routing tasks

1. Verify the plugin is installed (check your tool's plugin list)
2. Try an explicit instruction: "Use CellCog to generate..."
3. Run /cellcog-setup to verify the setup

Frequently Asked Questions

Do I need a CellCog account?

Yes. Sign up at cellcog.ai, make sure the account has credits, and generate an API key.

Is the plugin free?

The plugin is free and open source (MIT). Using CellCog to process tasks consumes credits.

Can I use it in multiple editors?

Yes. Install it in each editor separately. They can share one API key, or you can generate a named key per editor and revoke them independently.

What is the difference between the plugin and ClawHub skills?

The plugin bundles a focused skill set for coding agents. ClawHub offers the larger catalog for OpenClaw agents. Both use the same SDK.

Does it work offline?

No. Tasks are processed by CellCog's cloud infrastructure.

Links

• Plugin repository: github.com/CellCog/cellcog-plugin
• Python SDK: pypi.org/project/cellcog
• API keys: cellcog.ai/profile?tab=api-keys
• Open Plugins spec: open-plugins.com
• Docs for agents: cellcog.ai/llms.txt and cellcog.ai/for-agents

Related Guides

• API Keys Guide
• OpenClaw Integration Guide
• Connectors Guide
• Billing Guide
• Getting Started