The most powerful artifact / document layer for coding agents. Understand with greater depth at a faster rate.

SmallDocs is a command-line tool. You run sdoc file.md and it opens that Markdown file, styled, in your browser. Anything with access to your machine can invoke it - you at the terminal, or a coding agent working in your project.

Because the file opens in the browser, we can use the flexible capabilities of HTML and CSS to create highly complex documents. This means Markdown rendered on smalldocs.org can do much more than plain text.

To create charts, diagrams, slides, spreadsheets, runnable browser components, or rendered code, run the relevant command, such as sdoc charts, sdoc diagrams, sdoc slides, or sdoc apps. Each command prints the Markdown syntax, options, and checks for that feature.

Run npx skills@latest add https://smalldocs.org/agent-skills/standard --global to install the standard SmallDocs skill for supported coding agents. Its short description sits in the agent’s context and the full reference loads on demand only when relevant.

After that you can ask your agent to build a "sdoc" or "SmallDoc" and it knows what to do. If npx skills is unavailable, sdoc setup installs the standard edition through a built-in fallback and removes agent configuration written by older SmallDocs releases.

When you open a file, the CLI compresses and encodes its content into the URL’s hash fragment (everything after the #) and opens a URL of this shape:

  https://smalldocs.org/#md={your encoded document}
                            └──────────┬──────────┘
                                       │
                           never leaves your browser

Browsers never send the hash fragment to the server, so your document stays on your machine. The server sees a request for the page; it does not see your document.

“The fragment is not sent to the server when the URI is requested; it is processed by the client” - MDN Web Docs

Creating a short link (click generate short link, or run sdoc share file.md) uploads ciphertext: your browser generates a random key, encrypts the document locally with AES-GCM, and uploads only the encrypted result. The decryption key lives in the URL fragment - like the document content described above.

SmallDocs Cloud is a separate, optional store. A document is added to Cloud only when you explicitly create or push it there. Cloud keeps encrypted document content on the server so it can provide cross-device access, search, permissions, and revision history.

  https://smalldocs.org/s/{short id}#k={encryption key}
                          └───┬───┘    └───────┬──────┘
                              │                │
                           sent to        never leaves
                           server         your browser

The longer version, with verifiable steps, is at smalldocs.org/privacy.