# 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:**
```
/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](https://open-plugins.com) 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

```
/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](./CellCog_OpenClaw_Guide.md).

### Any Open Plugins Tool

Clone the repository or point your tool's plugin loader at:
```
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](https://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:

| Skill | What it does |
|-------|--------------|
| `cellcog` | Core SDK reference: `create_chat`, files, modes and tiers, timeouts, credits |
| `video-generation-cellcog` | Video production: marketing, explainers, lip sync, cinematic |
| `image-generation-cellcog` | Image generation: photos, illustrations, logos, vectors |
| `audio-generation-cellcog` | Speech, voiceover, sound effects, dialogue, podcasts |
| `music-generation-cellcog` | Original music: any genre, any duration, royalty-free |
| `deep-research-cellcog` | Deep research with citations |
| `pdf-document-generation-cellcog` | PDF and document generation |
| `presentation-slides-cellcog` | Presentations and slide decks |
| `excel-spreadsheet-cellcog` | Spreadsheets with formulas and charts |
| `ui-prototype-wireframe-cellcog` | UI prototypes and mockups |
| `3d-model-generation-cellcog` | 3D model generation |
| `meme-generator-cellcog` | Meme generation |
| `diagram-flowchart-cellcog` | Flowcharts, architecture, mind maps |
| `data-analysis-cellcog` | Data analysis and visualization |
| `game-asset-generation-cellcog` | Game assets, game design documents, playable prototypes |
| `sticker-generator-cellcog` | Sticker packs and custom emoji |

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](./CellCog_OpenClaw_Guide.md).

---

## Chat Modes and Tiers

| Mode | API value | Best for |
|------|-----------|----------|
| **Agent** | `"agent"` | Most tasks: research, images, audio, documents, coding, co-work |
| **Agent Creative** | `"creative"` | Our most imaginative agent: web and UI design, 3D, brand and creative work |
| **Agent Team** | `"team"` | Deep research, multi-angled reasoning |

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

| Feature | What it is |
|---------|------------|
| **CellCog Plugin** (this) | Brings CellCog into your coding agent |
| **Python SDK** (`pip install cellcog`) | The communication layer between your agent and CellCog |
| **API Keys** | Authentication for the SDK; generated in your CellCog profile |
| **CellCog Web App** | The same agents, accessed in the browser |
| **OpenClaw Integration** | The same SDK, plus the larger ClawHub skills catalog for deeper orchestration |
| **Delegations page** | **Connectors**, then **Delegations**, then **Cursor** or **Claude Code** shows the setup steps and how many tasks each host has delegated |

---

## 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](https://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](https://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](https://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](https://github.com/CellCog/cellcog-plugin)
- **Python SDK:** [pypi.org/project/cellcog](https://pypi.org/project/cellcog)
- **API keys:** [cellcog.ai/profile?tab=api-keys](https://cellcog.ai/profile?tab=api-keys)
- **Open Plugins spec:** [open-plugins.com](https://open-plugins.com)
- **Docs for agents:** [cellcog.ai/llms.txt](https://cellcog.ai/llms.txt) and [cellcog.ai/for-agents](https://cellcog.ai/for-agents)

---

## Related Guides

- [API Keys Guide](./CellCog_API_Keys_Guide.md)
- [OpenClaw Integration Guide](./CellCog_OpenClaw_Guide.md)
- [Connectors Guide](./CellCog_Connectors_Guide.md)
- [Billing Guide](./CellCog_Billing_Guide.md)
- [Getting Started](./CellCog_Getting_Started.md)

---

Markdown alternate of https://cellcog.ai/support/plugin-guide (CellCog support guide, category: Integrations). All guides for agents: https://cellcog.ai/support/llms.txt. Site index: https://cellcog.ai/llms.txt. Try CellCog free, no credit card needed: https://cellcog.ai/signup