---
title: Overview
description: Greeting cards an agent makes from a description, opened by link as a 3D paper card.
---

Cardstock makes greeting cards. You describe the card you want to an agent,
such as "a Christmas card for Mum with snow and a photo of the dog", and it
writes the words, picks or makes the pictures, and saves the card. You get a
link, and whoever opens it sees an envelope that opens into a paper card,
with the effect and music you chose.

You can change any card afterwards in the web app on your phone or computer,
and save it as a still, an MP4 or a GIF to send in a chat.

Cardstock is being built in the open on
[timmo001/cardstock#1](https://github.com/timmo001/cardstock/issues/1). Each
page here says what works today and what is still to come.

## What it does

- **Cards from a description:** an agent turns what you ask for into a card,
  using your own pictures, ones it finds on Openverse or Unsplash, or ones it
  draws. See [Making a card](/making-a-card).
- **Private links:** a card opens only for whoever holds its link. The card is
  encrypted before it leaves your device, and the server never sees the key.
  See [Links and privacy](/links-and-privacy).
- **A 3D paper card:** the envelope, the fold and the paper are drawn with
  three.js on WebGPU, falling back to WebGL. With reduced motion on, the card
  shows still and open.
- **The web app:** your cards, their links and your devices, installed on a
  phone or computer. See [The web app](/web-app).
- **For agents:** the `cardstock` CLI with Code Mode and MCP, and a skill that
  tells an agent how to use them. See [CLI](/cli) and [Agents](/agents).

## Parts

| Part              | What it is                                                         |
| ----------------- | ------------------------------------------------------------------ |
| `packages/card`   | The card format, encryption, renderer, designs, effects and export |
| `packages/app`    | The web app, with the viewer and editor                            |
| `packages/server` | The Cloudflare Worker that stores encrypted cards                  |
| `packages/cli`    | The `cardstock` CLI, with Code Mode and MCP for agents             |
| `docs`            | This site                                                          |

## Machine-readable docs

| URL                                       | Use                                      |
| ----------------------------------------- | ---------------------------------------- |
| https://cardstock.timmo.dev/llms.txt      | Compact page index                       |
| https://cardstock.timmo.dev/llms-full.txt | Full docs bundle                         |
| https://cardstock.timmo.dev/mcp           | Hosted MCP (search, page and navigation) |
| `/{route}.md`                             | One page as Markdown                     |
