Documentation Index
Fetch the complete documentation index at: https://docs.slideless.ai/llms.txt
Use this file to discover all available pages before exploring further.
TL;DR
remix downloads the listing’s files into a fresh folder. No account needed. The folder has no slideless.json — it’s a clean starting point. Run slideless push from it to create your own presentation.
What this does
slideless searchqueries the public marketplace catalog — no API key required.slideless remix <slug>downloads the files of the listing’s pinned version into a new local folder, and increments the listing’s public remix count.- The remixed folder is not linked to any presentation — there is no
slideless.jsonin it. It is yours to push as a new deck. remixalso drops a small.slideless-remix.jsonmarker so that, if you later publish, your listing can credit the original. See The remix-lineage marker below.
Prerequisites
- For searching and remixing: nothing — no account, no API key.
- For the follow-up
push: an authenticated CLI session (slideless auth login-request+login-complete, orslideless login) and a key withpresentations:write.
Step by step
1. Find a listing
search flags:
| Flag | Purpose |
|---|---|
--kind <presentation|app|plan> | Filter to one kind — presentations, apps, or plans. |
--interactive | Filter to interactive listings only. |
--tag <tag> | Filter by a search tag. |
--category <name> | Filter by category bucket. |
--sort recent|popular|stars | Order: newest, most-remixed, or most-starred. Default recent. |
--json | Stable JSON output. |
listing get needs no key:
Remixing works for all three kinds. A
presentation is a deck whose value is the author’s content — remix it to make the message yours. An app is a self-contained tool meant to be run as-is — open it directly, and only remix it if you want to change the app itself. A plan is a build blueprint — remix it as the starting point for an agent-driven build.2. Remix it
./my-pitch. If you omit the path, the CLI creates a folder named after the slug. The destination must be empty (or new).
The folder you get is a plain copy of the deck — index.html and any sibling assets — with no slideless.json. That is deliberate: the folder is not linked to the original listing or to any presentation. You are starting fresh.
Alongside the files, remix writes one extra file: .slideless-remix.json, the remix-lineage marker (covered below).
3. Make it yours
Edit the files however you like, thenpush to create your own presentation:
slideless.json. From here it behaves like any deck — share it, invite collaborators, and even publish your own listing.
The remix-lineage marker
slideless remix writes a small marker file, .slideless-remix.json, into the fresh folder. It is not a slideless.json — the folder stays unlinked. The marker only records where the files came from:
slideless.json, it never becomes part of your presentation’s files.
How lineage flows: remix → push → publish
slideless remixwrites.slideless-remix.jsoninto the new folder.- The first
slideless pushfrom that folder reads the marker and sends the lineage to the backend. It is stored on the new presentation once, at creation time, and is immutable — every subsequent push keeps the same lineage. slideless publishfrom that presentation copies the lineage onto the listing. The published listing exposesremixedFromSlug/remixedFromTitle, and its marketplace page shows a “Remixed from <original>” link back to the source listing.
If you delete the marker
When you delete .slideless-remix.json | Effect |
|---|---|
Before the first push | Lineage is lost. The push has nothing to read, so the presentation is created with no origin and any listing you publish from it will not show “Remixed from …”. |
After the first push | Harmless. The server already has the lineage permanently. Later pushes stay linked, and publishing still records “Remixed from …”. |
From the plugin (Claude Code / Cursor)
Two skills cover this flow:browse-marketplace— wrapsslideless search --json; ask for presentations, apps, or plans by topic, kind, or tag.remix-template— wrapsslideless remix --json; give it a slug and an optional destination path, and it reports the new folder.
From Claude Desktop (MCP)
Ask Claude: “Search the Slideless marketplace for a pricing-calculator app and remix it.” Claude usesslideless_search_marketplace, slideless_get_marketplace_listing, and slideless_remix_listing. See Claude Desktop (MCP).
Troubleshooting
error.code | When | What to do |
|---|---|---|
not-found | No listing with that slug | Re-check the slug with slideless search. |
invalid-argument | Destination folder is not empty | Pick a new or empty path. |
unauthenticated | Hit on the follow-up push, not on remix | remix needs no key; push does — run slideless login. |
Related
- Marketplace concept — listings,
kind, stars, remixes, views, lineage. - Publishing to the marketplace — the other side.
GET /listMarketplaceListings— the endpointsearchcalls.POST /recordMarketplaceRemix— whatremixrecords.GET /listMarketplaceRemixes— descendants of a listing (“Remixes of this”).