Integrate with your Agent

You don’t have to read the integration guide yourself. Clone the repo, paste one prompt into any AI coding agent (Claude Code, Cursor, Copilot, etc.) working in your codebase, and it has everything it needs to wire up EPIS Chat correctly on the first try.

Step 1 — Clone the repo

git clone https://github.com/PastpaperLM/EpisBox.git

Clone it anywhere convenient — alongside your project, or in a scratch directory. The agent only needs to read files from it; nothing here gets deployed or copied into your app wholesale.

Step 2 — Give your agent this prompt

Point the agent at wherever you cloned the repo — adjust the path in the prompt if it’s not a sibling directory of your project.

I want to add EpisBox (PastpaperLM's embeddable AI tutor) to this app.

Read ./EpisBox/INTEGRATION.md and follow it exactly — pick the
integration path that matches how this codebase is built (vanilla JS,
React/Next.js, or a show/hide single-page-app pattern like the
"Integration for Single-Page Apps" section). Add the script tag, a
container with a defined height, and the EPIS.init() + mountChat()
call. Leave clientId as a clearly marked placeholder — I'll fill in
the real one from PastpaperLM myself.

Match the theme config to this app's existing colors, font, and
border-radius. If you're not confident deriving the full theme token
set by hand, use the AI theming skill at
./EpisBox/skills/customize/theme-agent.md instead — follow its reading
order (constraints.md first) and treat it as strictly scoped to the
theme object, nothing else.

If this project has no existing dev server (plain static HTML, no
build system) and you have shell access, start one (e.g. `python3 -m
http.server`) so I can test over http://, not by opening the file
directly — file:// will not load the embed. If you don't have shell
access, tell me the exact command to run.

Don't touch anything outside adding this one integration.

What the agent will actually do

Read INTEGRATION.md’s requirements, then pick the one integration path (vanilla JS / React / SPA) that matches your codebase — it won’t blindly paste the first snippet it sees
Add the <script> tag, a correctly-sized container <div>, and the EPIS.init() / mountChat() call
Leave clientId: 'your-client-id' as an obvious placeholder rather than inventing one
Derive a theme config matching your app’s brand — either by reading your existing CSS/design tokens directly, or by running the AI theming skill if you ask it to
Start a local static server for you if your project is plain static HTML with no dev server already — see Local Development for why file:// won’t work
Stop there — constraints.md in the theming skill explicitly forbids touching anything outside the theme object, and the prompt above scopes the rest of the work to just this one integration

Step 3 — Swap in a clientId

EPIS.init() requires a non-empty clientId string — the agent leaves 'your-client-id' as a placeholder, which will throw at runtime. Replace it with any string that identifies your app (e.g. 'my-app').

clientId isn’t validated against a registered domain today — see Security. Pick any string and you’re done; there’s no signup step blocking you from testing the integration right now.

That’s it — no backend, no secrets, no security review.

Get Started

Frameworks

SDK Reference

Theming

More

Integrate with your Agent

Step 1 — Clone the repo

Step 2 — Give your agent this prompt

What the agent will actually do

Step 3 — Swap in a clientId

​Step 1 — Clone the repo

​Step 2 — Give your agent this prompt

​What the agent will actually do

​Step 3 — Swap in a clientId

Step 1 — Clone the repo

Step 2 — Give your agent this prompt

What the agent will actually do

Step 3 — Swap in a clientId