---
title: Codex App Plugin
description: Install and use the Infinite Canvas plugin in Codex App
---

# Codex App Plugin

The plugin connects Codex to a local Canvas Agent, allowing Codex to open Infinite Canvas, read and create nodes, connect nodes, and start generation workflows. Its source is in `plugins/infinite-canvas/`.

## Ask Codex to install it

Send this request to Codex:

```text
Install the Infinite Canvas Codex plugin from https://github.com/basketikun/infinite-canvas.git.
Clone it to ~/plugins/infinite-canvas, verify plugins/infinite-canvas/.codex-plugin/plugin.json,
add the repository to my personal marketplace with `codex plugin marketplace add ~`,
then install `infinite-canvas@personal`. Validate the installation and tell me whether a new
conversation is required to load the Skill and MCP tools.
```

## Manual installation

```bash
mkdir -p ~/plugins
git clone https://github.com/basketikun/infinite-canvas.git ~/plugins/infinite-canvas
codex plugin marketplace add ~
codex plugin add infinite-canvas@personal
```

The personal marketplace entry must point to `./plugins/infinite-canvas/plugins/infinite-canvas`. Start a new Codex conversation after installation so the Skill and MCP tools load completely.

For development from this repository:

```bash
cd /path/to/infinite-canvas
codex plugin marketplace add "$(pwd)"
codex plugin add infinite-canvas@infinite-canvas-local
```

## Usage

In a new Codex conversation, ask it to open Infinite Canvas, create a canvas, and connect Codex. The plugin starts Canvas Agent, reads its connection URL and token, opens `https://canvas.best/`, and creates and connects a canvas. It starts a local frontend only when explicitly requested.

You can then ask Codex to summarize the current canvas, create prompts from selected nodes, or organize nodes into a generation workflow.

Reinstall or refresh the plugin after changing its manifest, MCP configuration, Skills, exposed MCP tools, app, or entry scripts. The agent's default MCP command is:

```bash
npx -y @basketikun/canvas-agent mcp
```
