---
name: IdeaSpaces integrations
summary: Install IdeaSpaces for Claude Code, Cowork, or Pi and keep durable knowledge in ordinary Markdown under git.
---

Integrations

# Works with the agent you already use.

An ideaspace is an ordinary folder of Markdown under git, plus a few files that tell any AI agent how to work in it. Install takes about two minutes.

Requirements: Node.js and git. No server or daemon stays running.

[Claude Code + Cowork](#claude-code--cowork) · [Pi](#pi) · [How it works](how-it-works.md)

## Watch

### Create your first agent.

See how to install the IdeaSpaces plugin, give Claude a point of view, and create an agent from start to finish.

[Create your first agent video](https://www.youtube.com/watch?v=AN9NPrY8y9k)

## Install

### Claude Code + Cowork

Session awareness, capture skills, and safe commit and sync tools. The recommended path for Claude.

```text title="Install"
/plugin marketplace add IdeaSpaces-xyz/claude-code-plugin
/plugin install ideaspaces@ideaspaces-xyz
```

In Cowork: Customize → Plugins → Add marketplace, then enter IdeaSpaces-xyz/claude-code-plugin.

[View source and full instructions ↗](https://github.com/IdeaSpaces-xyz/claude-code-plugin)

### Pi

A native Pi extension with local awareness, capture, working-set navigation, and optional publish and sync flows.

```text title="Install"
pi install git:github.com/IdeaSpaces-xyz/pi-is-space
```

Try it for one run with pi -e git:github.com/IdeaSpaces-xyz/pi-is-space.

[View source and full instructions ↗](https://github.com/IdeaSpaces-xyz/pi-is-space)

## Once installed

### Work normally. Keep what matters.

#### 01 Arrive oriented.

The agent reads the active agreement and current direction instead of asking you to reconstruct the project every time.

#### 02 Capture by agreement.

When something becomes worth keeping, the agent drafts it and you decide. Nothing becomes durable behind your back.

#### 03 Start further ahead.

The agreed result is readable Markdown with git history, ready for the next person, agent, or conversation.

## Go deeper

### Understand the shape, or build on the standard.

[See how it works →](how-it-works.md) [Explore the protocol →](developers.md)
